ToolBarStandardButton()

Syntax

ToolBarStandardButton(#ButtonID, #ButtonIcon [, Modus])

Fügt der zu konstruierenden Werkzeugleiste einen Standard-Schalter hinzu. Vor diesem Befehl muss CreateToolBar() aufgerufen worden sein.

Ein Standard-Schalter ist ein Icon, welches direkt im OS verfügbar ist. Der '#ButtonIcon' Parameter muss eine der folgenden Konstanten sein:

  Konstante                     Dargestelltes Symbol
  ---------------------------------------------------
  #PB_ToolBarIcon_New           Neu
  #PB_ToolBarIcon_Open          Öffnen
  #PB_ToolBarIcon_Save          Speichern
  #PB_ToolBarIcon_Print         Drucken
  #PB_ToolBarIcon_PrintPreview  Druckvorschau
  #PB_ToolBarIcon_Find          Suchen
  #PB_ToolBarIcon_Replace       Ersetzen

  #PB_ToolBarIcon_Cut           Ausschneiden
  #PB_ToolBarIcon_Copy          Kopieren
  #PB_ToolBarIcon_Paste         Einfügen
  #PB_ToolBarIcon_Undo          Rückgängig
  #PB_ToolBarIcon_Redo          Wiederholen

  #PB_ToolBarIcon_Delete        Löschen
  #PB_ToolBarIcon_Properties    Eigenschaften
  #PB_ToolBarIcon_Help          Hilfe

Mit dem optionalen Parameter 'Modus' kann eingestellt werden, ob der Schalter gedrückt ("toggled") oder nicht gedrückt dargestellt wird. Dafür kann eine der folgenden Konstanten verwendet werden:

  #PB_ToolBar_Normal : der Schalter verhält sich als Standard-Schalter (Standard-Einstellung)
  #PB_ToolBar_Toggle : der Schalter verhält sich als Toggle-Schalter, d.h. bleibt nach dem Anklicken gedrückt/nicht gedrückt

Später können die GetToolBarButtonState() und SetToolBarButtonState() Befehle darauf verwendet werden.

Die spätere Abfrage eines Ereignisses, d.h. ob ein Eintrag der ToolBar angeklickt wurde, erfolgt analog der Abfrage eines Menü-Eintrages mit dem Befehl EventMenu().

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

Unterstützte OS

Windows, Linux