ComboBoxGadget3D()

Syntax

Ergebnis = ComboBoxGadget3D(#Gadget3D, x, y, Breite, Hoehe [, Flags])

Erstellt ein ComboBox (Auswahl-) Gadget innerhalb der aktuellen Gadget-Liste.

Wenn #PB_Any als '#Gadget3D' Parameter verwendet wird, dann wird die Nummer des neuen Gadgets als 'Ergebnis' zurückgegeben. #Gadget3D ist die Nummer, die (später) von der EventGadget3D() Funktion zurückgegeben wird.

Sobald eine ComboBox erstellt wurde, ist ihre Liste mit Einträgen leer. Der Parameter 'Hoehe' hat keinen Einfluss auf die tatsächliche Höhe des Gadgets, welche automatisch durch den Zeichensatz bestimmt wird.

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

Die folgenden Befehle können benutzt werden, um auf den Listen-Inhalt zuzugreifen:

- AddGadgetItem3D(): fügt einen Eintrag hinzu.
- GetGadgetItemText3D(): ermittelt den Text des Gadget-Eintrags.
- CountGadgetItems3D(): ermittelt die Anzahl der Einträge in der aktuellen Combobox.
- ClearGadgetItems3D(): entfernt alle Einträge.
- RemoveGadgetItem3D(): entfernt einen Eintrag.
- SetGadgetItemText3D(): ändert den Text des Gadget-Eintrags.

- GetGadgetState3D(): ermittelt die Index-Nummer (beginnend bei 0) des aktuellen Elements.
- GetGadgetText3D(): ermittelt den (Text-) Inhalt des aktuellen Elements.
- SetGadgetState3D(): ändert das ausgewählte Element.
- SetGadgetText3D(): ändert den anzuzeigenden Text. Wenn das ComboBoxGadget nicht editierbar ist, muss sich der Text in der Aufklapp-Liste befinden.

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

  #PB_ComboBox3D_Editable  : Macht die ComboBox editierbar

Unterstützte OS

Alle