StringScreenGadget

StringScreenGadget()

Syntax

Ergebnis = StringScreenGadget(#ScreenGadget, x, y, Breite, Höhe, 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 EditorScreenGadget().

Parameter

#ScreenGadget Eine Nummer zum Identifizieren des neuen 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_String_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 #ScreenGadget Parameter verwendet wurde, dann enthält bei Erfolg der Rückgabewert die automatisch generierte Nummer.

Anmerkungen

Der Inhalt kann später mit SetScreenGadgetText() verändert und mit GetScreenGadgetText() ermittelt werden.

Die Abfrage der folgenden Ereignisse wird mittels ScreenEventType() unterstützt:
  #PB_ScreenEventType_Change    : Der Text wurde durch den Anwender geändert.
  #PB_ScreenEventType_Focus     : Das StringGadget erhielt den Fokus.
  #PB_ScreenEventType_LostFocus : Das StringGadget verlor den Fokus.
Zu diesem Gadget kann mittels ScreenGadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Unterstützte OS

Alle

<- SplitterScreenGadget() - ScreenGadget Inhaltsverzeichnis - TextScreenGadget() ->

#ScreenGadget	Eine Nummer zum Identifizieren des neuen 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_String_ReadOnly : 'Read only' Modus. Es kann kein Text eingegeben werden.