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.
  #PB_String_PlaceHolder: Der 'Inhalt$' Parameter wird als Platzhalter verwendet (ein informativer
                          Text, der angezeigt wird, wenn das Gadget leer ist).

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, 235, "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)
  StringGadget(7, 8, 210, 306, 20, "Informationstext", #PB_String_PlaceHolder)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

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

Unterstützte OS

Alle

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