ContainerGadget()

Syntax

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

Erstellt ein Container Gadget in der aktuellen Gadgetliste. Es handelt sich dabei um ein einfaches Panel-Gadget (Schalttafel), welches andere Gadgets enthalten kann.

Parameter

#Gadget	Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Die Position und die Abmessungen des neuen Gadgets.
Flags (optional)	Flags zum Verändern des Gadget-Verhaltens. Dies kann eine Kombination (verknüpft mit dem bitweisen '|' OR-Operator) der folgenden Konstanten sein: #PB_Container_BorderLess : Ohne jeden Rahmen (Standard) #PB_Container_Flat : Flacher Rahmen #PB_Container_Raised : Erhabener Rahmen #PB_Container_Single : Einfach vertiefter Rahmen #PB_Container_Double : Doppelt vertiefter Rahmen

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, oder Null bei einem Fehler. Wenn #PB_Any als #Gadget Parameter verwendet wurde, dann beinhaltet der Rückgabewert bei Erfolg die automatisch generierte Gadget-Nummer.

Anmerkungen

Sobald dieses Gadget erstellt wurde, werden alle nachfolgenden Gadgets innerhalb des Containers erstellt. Wenn alle benötigten Gadgets erstellt wurden, muss CloseGadgetList() aufgerufen werden, um zur vorherigen Gadgetliste zurückzukehren. OpenGadgetList() kann später benutzt werden, um weitere Gadgets während des Programmablaufs ("on-the-fly") zum Container-Bereich hinzuzufügen.

Das folgende Ereignis wird mittels EventType() unterstützt:

  #PB_EventType_Resize: Das Gadget wurde in der Größe verändert.

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

Dieses Gadget unterstützt die Befehle SetGadgetColor() und GetGadgetColor() mit #PB_Gadget_BackColor als Typ, um den Hintergrund des Gadgets zu ändern.

Beispiel

  If OpenWindow(0, 0, 0, 322, 150, "ContainerGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    ContainerGadget(0, 8, 8, 306, 133, #PB_Container_Raised)
      ButtonGadget(1, 10, 15, 80, 24, "Button 1")
      ButtonGadget(2, 95, 15, 80, 24, "Button 2")
    CloseGadgetList()
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

OpenGadgetList(), CloseGadgetList(), SetGadgetColor(), GetGadgetColor()

Unterstützte OS

Alle