CreateToolBar()

Syntaxe

Resultat = CreateToolBar(#BarreOutils, FenetreID [, Options])
Description
Crée une barre d'outils vide.

Arguments

#BarreOutils L'identifiant de la barre d'outils

#PB_Any peut être utilisé pour générer automatiquement ce numéro.
FenetreID L'identifiant de la fenêtre.

'FenetreID' peut être récupéré facilement grâce à la commande WindowID().
Options (optionnel) Peut être une combinaison des valeurs suivantes:
  - #PB_ToolBar_Small     : Petites icônes (16x16) (par défaut) 
  - #PB_ToolBar_Large     : Grandes icônes (24x24)
  - #PB_ToolBar_Text      : Le texte sera affiché sous le bouton
  - #PB_ToolBar_InlineText: Le texte sera affiché à droite du bouton (Windows uniquement)

Valeur de retour

Renvoie une valeur non nulle en cas de succès, zéro sinon.

Remarques

Cette barre d'outils devient celle par défaut pour les créations des éléments qu'elle doit contenir. Vous pouvez maintenant utiliser ToolBarStandardButton(), ToolBarImageButton() et ToolBarSeparator() pour ajouter des éléments.

La détection des évènements sur les barres d'outils est similaire à celle des menus, et nécessite donc la commande EventMenu(). Les barres d'outils sont souvent utilisées comme raccourci des éléments de menu, ainsi en attribuant le même numéro ID à un menu et à un bouton de la barre d'outils, les deux événements sont traités en utilisant le même code.

Exemple

  If OpenWindow(0, 0, 0, 150, 25, "Barre d'outils", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If CreateToolBar(0, WindowID(0))
      ToolBarStandardButton(0, #PB_ToolBarIcon_New)
      ToolBarStandardButton(1, #PB_ToolBarIcon_Open)
      ToolBarStandardButton(2, #PB_ToolBarIcon_Save)
    EndIf
    Repeat
      Event = WaitWindowEvent()
      If Event = #PB_Event_Menu
        Debug "Identifiant Barre d'outils: "+Str(EventMenu())
      EndIf
    Until Event = #PB_Event_CloseWindow 
  EndIf

Voir aussi

ToolBarStandardButton(), ToolBarImageButton(), ToolBarSeparator(), FreeToolBar()

OS Supportés

Tous

ToolBar Index - DisableToolBarButton() ->