StringGadget()

Syntax

Ergebnis = StringGadget(#Gadget, x, y, Breite, Hoehe, Inhalt$ [, Flags])
Beschreibung
Erstellt ein String-Gadget innerhalb der aktuellen Gadget-Liste.

Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird die Nummer des neuen Gadgets als 'Ergebnis' zurückgegeben. '#Gadget' ist die Nummer, die (später) von der EventGadget() Funktion 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 EditorGadget().

'Flags' sind immer optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:
  #PB_String_Numeric    : Nur (positive) Ganzzahlen werden akzeptiert.
  #PB_String_Password   : Passwort-Modus, es werden nur '*' anstelle normaler Zeichen angezeigt.
  #PB_String_ReadOnly   : 'Read only' Modus. Es kann kein Text eingegeben werden.
  #PB_String_LowerCase  : Alle Zeichen werden automatisch in Kleinbuchstaben umgewandelt.
  #PB_String_UpperCase  : Alle Zeichen werden automatisch in Großbuchstaben umgewandelt.
  #PB_String_BorderLess : Es werden keine Ränder rings um das Gadget gezeichnet.
Der Inhalt kann später mit SetGadgetText() verändert und mit GetGadgetText() ermittelt werden.
Die Abfrage der folgenden Ereignisse wird mittels EventType() unterstützt:
  #PB_EventType_Change    : Der Text wurde durch den Anwender geändert.
  #PB_EventType_Focus     : Das StringGadget erhielt den Fokus.
  #PB_EventType_LostFocus : Das StringGadget verlor den Fokus.
Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den folgenden Werten als 'FarbTyp':
  #PB_Gadget_FrontColor: Textfarbe
  #PB_Gadget_BackColor : Hintergrundfarbe
Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Beispiel:

  ; Zeigt mögliche Flags des StringGadgets in Aktion...
  If OpenWindow(0, 0, 0, 322, 205, "StringGadget Flags", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    StringGadget(0, 8,  10, 306, 20, "Normal StringGadget...")
    StringGadget(1, 8,  35, 306, 20, "1234567", #PB_String_Numeric)
    StringGadget(2, 8,  60, 306, 20, "Readonly StringGadget", #PB_String_ReadOnly)
    StringGadget(3, 8,  85, 306, 20, "lowercase...", #PB_String_LowerCase)
    StringGadget(4, 8, 110, 306, 20, "uppercase...", #PB_String_UpperCase)
    StringGadget(5, 8, 140, 306, 20, "Borderless StringGadget", #PB_String_BorderLess)
    StringGadget(6, 8, 170, 306, 20, "Password", #PB_String_Password)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Unterstützte OS

Alle

<- SplitterGadget() - Gadget Inhaltsverzeichnis - TextGadget() ->