StringGadget3D

StringGadget3D()

Syntax

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

Beschreibung

Erstellt ein String-Gadget innerhalb der aktuellen Gadget-Liste.

Dieses Gadget akzeptiert nur eine Zeile an Text. Um mehrzeilige Eingaben zu erhalten, verwenden Sie das EditorGadget3D().

Parameter

#Gadget3D Eine Nummer zum Identifizieren des neuen 3D-Gadgets. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.

x, y, Breite, Höhe Die Position und Abmessungen des neuen Gadgets.

Inhalt$ Der anfängliche Text-Inhalt.
Flags (optional)
Dies kann eine Kombination (verknüpft mit dem '|' OR-Operator) der folgenden Werte sein:
  #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.

Rückgabewert

Gibt im Erfolgsfall einen Wert ungleich Null zurück, andernfalls Null. Wenn #PB_Any als #Gadget3D Parameter verwendet wurde, dann enthält bei Erfolg der Rückgabewert die automatisch generierte Nummer.

Anmerkungen

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

<- SpinGadget3D() - Gadget3D Inhaltsverzeichnis - TextGadget3D() ->

#Gadget3D	Eine Nummer zum Identifizieren des neuen 3D-Gadgets. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.
x, y, Breite, Höhe	Die Position und Abmessungen des neuen Gadgets.
Inhalt$	Der anfängliche Text-Inhalt.
Flags (optional)	Dies kann eine Kombination (verknüpft mit dem '\|' OR-Operator) der folgenden Werte sein: #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.