StringGadget()

Syntax

Ergebnis = StringGadget(#Gadget, x, y, Breite, Höhe, Inhalt$ [, Flags])

Erstellt ein String-Gadget innerhalb der aktuellen Gadget-Liste. Es ermöglicht dem Anwender die Eingabe einer Textzeile.

Parameter

#Gadget	Gibt eine Nummer an, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Geben die Position und die Abmessungen des neuen Gadgets an.
Inhalt$	Gibt den anfänglichen Inhalt dieses StringGadgets an. Dieses Gadget akzeptiert nur eine Zeile an Text. Um mehrzeilige Eingaben zu erhalten, verwenden Sie das EditorGadget().
Flags (optional)	Gibt optionale Flags an, um das Gadget-Verhalten zu verändern. Diese können eine Kombination (verknüpft mit dem bitweisen '|' OR-Operator) der folgenden Konstanten sein: #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' bzw. Lese-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.

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, oder Null bei einem Fehler. Wenn #PB_Any als #Gadget Parameter verwendet wurde, dann beinhaltet der Rückgabewert bei Erfolg die automatisch generierte Gadget-Nummer.

Anmerkungen

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

Siehe auch

GetGadgetText(), SetGadgetText(), GetGadgetColor(), SetGadgetColor(), EditorGadget()

Unterstützte OS

Alle