AddGadgetItem()

Syntax

Ergebnis = AddGadgetItem(#Gadget, Position, Text$ [, ImageID [, Flags]])

Fügt einen Eintrag zum angegebenen #Gadget hinzu. Eine optionale ImageID() kann für alle Gadgets angegeben werden, die dies unterstützen (wie ListIconGadget()). 'Ergebnis' wird nur in Verbindung mit MDIGadget() unterstützt (siehe unten).

Die folgenden Gadgettypen werden unterstützt:

- ComboBoxGadget() : unterstützt die ImageID, wenn #PB_ComboBox_Image gesetzt wurde.
- EditorGadget()
- ListIconGadget() : unterstützt die ImageID.
- ListViewGadget()
- MDIGadget() : ImageID kann ein Icon für die Titelleiste des "ChildWindow"s enthalten. 'Flags' können die neuen Window-Flags bezeichnen.
- PanelGadget() : unterstützt die ImageID.
- TreeGadget(): unterstützt die ImageID. 'Flags' wird benötigt und gibt die neue Unterebene ("Sublevel") an.

Die 'Position' definiert den Eintrag-Index, wo der neue Eintrag eingefügt werden soll. Um diesen Eintrag am Anfang einzufügen, benutzen Sie einen Index von 0. Um diesen Eintrag am Ende der aktuellen Eintrag-Liste hinzuzufügen, benutzen Sie einen Wert von -1. Denken Sie beim Einfügen eines Eintrags daran, dass alle aktuellen Einträge die auf diesen neuen Eintrag folgen, einen um 1 höheren Positions-Index erhalten.

Für das MDIGadget() gibt der Parameter 'Position' die #Window Nummer für das neue MDI-Childwindow an. #PB_Any kann verwendet werden, in diesem Fall ist der Rückgabewert die neue von PB zugewiesene Window Nummer. Der 'Flags' Parameter kann verwendet werden, um die Flags für das neue Fenster (siehe OpenWindow()) anzugeben. Die #PB_Window_Borderless, #PB_Window_Screencentered und #PB_Window_WindowCentered Flags werden bei MDI-Fenstern nicht unterstützt.

Beim TreeGadget() wird der 'Flags' Parameter immer benötigt. Er gibt die neue Unterebene für den Eintrag an. Ist der Wert für die Unterebene größer als der vorherige Eintrag, wird der neue Eintrag dessen "Kind" (Child). Ist er niedriger, wird er nach dem "Eltern"-Eintrag (Parent) des vorherigen Eintrags hinzugefügt.

Unterstützte OS

Alle