CreateToolBar()

Syntax

Ergebnis = CreateToolBar(#ToolBar, WindowID [, Flags])

Erstellt eine leere Werkzeugleiste auf dem angegebenen Fenster.

Parameter

#ToolBar	Eine Nummer zum Identifizieren der neuen Werkzeugleiste. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
WindowID	Das Fenster für die neue Werkzeugleiste. Es kann mittels der WindowID() Funktion ermittelt werden.
Flags (optional)	Dies kann eine Kombination der folgenden Werte sein: - #PB_ToolBar_Small : Symbolleiste mit kleinen (16x16 Pixel) Symbolen (Standard) - #PB_ToolBar_Large : Symbolleiste mit großen (24x24 Pixel) Symbolen - #PB_ToolBar_Text : Text wird unterhalb des Schalters dargestellt - #PB_ToolBar_InlineText: Text wird rechts vom Schalter dargestelt (nur auf Windows)

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn die Werkzeugleiste erfolgreich erstellt wurde, und Null wenn nicht. Wenn #PB_Any als #ToolBar Parameter verwendet wurde, dann wird im Erfolgsfall die generierte Nummer zurückgegeben.

Anmerkungen

Diese Toolbar wird die aktuelle Toolbar für die Erstellung, zu der mittels ToolBarStandardButton(), ToolBarImageButton() und ToolBarSeparator() einige Elemente hinzugefügt werden können.

Die Ereignisse werden genauso wie Menü-Ereignisse behandelt, mittels der Funktion EventMenu(). Werkzeugleisten werden oft als Kürzel für Menü-Einträge verwendet - wenn daher die gleiche Menü-Eintrag-Nummer zu einem Werkzeugleisten-Schalter zugewiesen wird, werden beide Ereignisse durch den gleichen Code behandelt.

Beispiel

  If OpenWindow(0, 0, 0, 150, 25, "ToolBar", #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 "ToolBar ID: "+Str(EventMenu())
      EndIf
    Until Event = #PB_Event_CloseWindow 
  EndIf

Siehe auch

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

Unterstützte OS

Alle