StringGadget3D()

Syntax

Ergebnis = StringGadget3D(#Gadget3D, x, y, Breite, Hoehe, Inhalt$ [, Flags])

Erstellt ein String-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) vom EventGadget3D() Befehl zurückgegeben wird.

'Inhalt$' beinhaltet den anfänglichen Inhalt des String-Gadgets. Dieses Gadget akzeptiert nur eine Zeile an Text. Um mehrzeilige Eingaben zu erhalten, verwenden Sie das EditorGadget3D().

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

  #PB_String3D_Numeric    : Nur (positive) Ganzzahlen werden akzeptiert.
  #PB_String3D_Password   : Passwort-Modus, es werden nur '*' anstelle normaler Zeichen angezeigt.
  #PB_String3D_ReadOnly   : 'Read only' Modus. Es kann kein Text eingegeben werden.

Der Inhalt kann später mit SetGadgetText3D() verändert und mit GetGadgetText3D() ermittelt werden.

Die Abfrage der folgenden Ereignisse wird mittels EventType3D():unterstützt:

  #PB_EventType3D_Change    : Der Text wurde durch den Anwender geändert.
  #PB_EventType3D_Focus     : Das StringGadget erhielt den Fokus.
  #PB_EventType3D_LostFocus : Das StringGadget verlor den Fokus.

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

Unterstützte OS

Alle