SplitterGadget()

Syntax

Ergebnis = SplitterGadget(#Gadget, x, y, Breite, Höhe, #Gadget1, #Gadget2 [, Flags])

Erstellt ein Splitter-Gadget innerhalb der aktuellen Gadgetliste. Es beinhaltet zwei Gadgets, welche durch einen horizontalen oder vertikalen Balken voneinander getrennt sind und automatisch "resized" (in der Größe verändert) werden können.

Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird der Identifier des neuen Gadgets als 'Ergebnis' zurückgegeben. '#Gadget' ist der numerische Bezeichner (Identifier), der (später) vom EventGadgetID() Befehl zurückgegeben wird.

'Flags' sind optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:

  #PB_Splitter_Vertical    : Das Gadget wird vertikal gesplittet (anstelle von horizontal, was der Standard ist).
  #PB_Splitter_Separator   : Ein Abgrenzungsbalken im 3D-Look wird in den Splitter gezeichnet.
  #PB_Splitter_FirstFixed  : Wenn das SplitterGadget in der Größe verändert wird, behält das erste Gadget seine Größe.
  #PB_Splitter_SecondFixed : Wenn das SplitterGadget in der Größe verändert wird, behält das zweite Gadget seine Größe.

Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Die folgenden Befehle können verwendet werden, um auf das SplitterGadget zuzugreifen:

GetGadgetState(): Ermittelt die aktuelle Splitter-Position, in Pixel.
SetGadgetState(): Ändert die aktuelle Splitter-Position, in Pixel.
SetGadgetAttribute(): mit einem der folgenden Attribute:

    #PB_Splitter_FirstMinimumSize : Legt die minimale Größe (in Pixel) fest, welche das erste Gadget haben kann. 
    #PB_Splitter_SecondMinimumSize: Legt die minimale Größe (in Pixel) fest, welche das zweite Gadget haben kann.

Beispiel:

  If OpenWindow(0, 0, 0, 230, 195, #PB_Window_SystemMenu|#PB_Window_ScreenCentered, "SplitterGadget")
    If CreateGadgetList(WindowID(0))
      
      #Button1  = 0 
      #Button2  = 1
      #Splitter = 2
      
      ButtonGadget(#Button1,0, 0, 0, 0, "Button 1") ; es besteht keine Notwendigkeit, die Größe oder Position
      ButtonGadget(#Button2,0, 0, 0, 0, "Button 2") ; festzulegen, da sie automatisch in der Größe angepasst werden
      SplitterGadget(#Splitter, 5, 5, 220, 120, #Button1, #Button2, #PB_Splitter_Separator)
      
      TextGadget(3, 10, 135, 210, 55, "Obiger GUI-Abschnitt zeigt zwei sich - innerhalb des 220x120 SplitterGadget Bereichs - automatisch in der Größe anpassende Schalter.",#PB_Text_Center )
      
      Repeat 
      Until WaitWindowEvent() = #PB_Event_CloseWindow
    EndIf
  EndIf

Unterstützte OS

Windows, Linux, MacOS X