AddGadgetItem()

Syntax

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

Fügt einen neuen Eintrag zum angegebenen Gadget hinzu.

Parameters

#Gadget	Das zu verwendende Gadget.
Position	Der 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 dieser Parameter 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.
Text$	Der Text für den neuen Eintrag. Beim Hinzufügen eines Eintrags zu einem ListIconGadget() kann dieser Parameter den Text für mehrere Spalten enthalten - jeweils getrennt von einem Chr(10) Zeichen.
ImageID (optional)	Ein optionales Bild, welches für Einträge in Gadgets verwendet werden kann, die dies unterstützen (wie ListIconGadget()). Das verwendete Bild sollte in der Standard 16x16 Größe vorliegen. Verwenden Sie den ImageID() Befehl, um die ID für diesen Parameter zu erhalten.
Flags (optional)	Dieser Parameter hat eine Bedeutung nur bei den folgenden Gadget-Typen: TreeGadget() Dieser Parameter gibt die neue Unterebene für den Eintrag an. Ist der Wert für die Unterebene größer als der vom vorherigen Eintrag, wird der neue Eintrag dessen "Kind" (Child). Ist er niedriger, wird er nach dem "Eltern"-Eintrag (Parent) des vorherigen Eintrags hinzugefügt. MDIGadget() Dieser 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.

Return value

Der Rückgabewert ist nur gültig mit dem MDIGadget().

Wenn #PB_Any als Parameter 'Position' beim Hinzufügen eines Eintrags zum MDIGadget() verwendet wurde, ist der Rückgabewert die Nummer, welche das neue MDI-Fenster identifiziert.

Remarks

Die folgenden Gadgets 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.

See Also

RemoveGadgetItem(), ClearGadgetItems(), CountGadgetItems(), ComboBoxGadget(), ListIconGadget(), ListViewGadget(), MDIGadget(), PanelGadget(), TreeGadget()

Supported OS

All