StringGadget()

Syntax

Ergebnis = StringGadget(#Gadget, x, y, Breite, Höhe, Inhalt$ [, Flags])
Beschreibung
Erstellt ein String-Gadget innerhalb der aktuellen Gadget-Liste. Es ermöglicht dem Anwender die Eingabe einer Textzeile.

Parameter

#Gadget Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe Die Position und die Abmessungen des neuen Gadgets.
Inhalt$ Der anfängliche Inhalt dieses StringGadgets. Dieses Gadget akzeptiert nur eine Zeile an Text. Um mehrzeilige Eingaben zu erhalten, verwenden Sie das EditorGadget().
Flags (optional) Flags zum Verändern des Gadget-Verhaltens. Dies kann 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.
Die folgenden Funktionen können verwendet werden, um dieses Gadget zu beeinflussen:

- SetGadgetColor() und GetGadgetColor() mit den folgenden Werten als 'FarbTyp': 
  #PB_Gadget_FrontColor: Textfarbe
  #PB_Gadget_BackColor : Hintergrundfarbe
- GetGadgetAttribute() mit dem folgenden Attribut: 
  #PB_String_MaximumLength: Gibt maximale Anzahl an Zeichen zurück, welche eingegeben werden können.
- SetGadgetAttribute() mit dem folgenden Attribut: 
  #PB_String_MaximumLength: Legt die maximale Anzahl an Zeichen fest, welche eingegeben werden können.
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

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