StringGadget()

Syntax

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

Erstellt ein String-Gadget innerhalb der aktuellen Gadget-Liste.

Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird der Identifier des neuen Gadgets als 'Ergebnis' zurückgegeben. '#Gadget' ist die Nummer, die (später) von der EventGadgetID() Funktion zurückgegeben wird.

'Inhalt$' beinhaltet den anfänglichen Inhalt des String-Gadgets. Der Inhalt kann später mit SetGadgetText() verändert und mit GetGadgetText() ermittelt werden.

'Flags' sind immer optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:

  @ConstantColor "#PB_String_Numeric"    : Nur Zahlen werden akzeptiert.
  @ConstantColor "#PB_String_Multiline"  : Mehrere Zeilen an Text werden akzeptiert.
  @ConstantColor "#PB_String_Password"   : Passwort-Modus, es werden nur '*' anstelle normaler Zeichen angezeigt.
  @ConstantColor "#PB_String_ReadOnly"   : 'Read only' Modus. Es kann kein Text eingegeben werden.
  @ConstantColor "#PB_String_LowerCase"  : Alle Zeichen werden automatisch in Kleinbuchstaben umgewandelt.
  @ConstantColor "#PB_String_UpperCase"  : Alle Zeichen werden automatisch in Großbuchstaben umgewandelt.
  @ConstantColor "#PB_String_BorderLess" : Es werden keine Ränder rings um das Gadget gezeichnet.

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.

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,275,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"StringGadget Flags") And CreateGadgetList(WindowID(0))
    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,205,306,60,"Multiline StringGadget..."+Chr(13)+Chr(10)+"second line...",#PB_String_Multiline)
    Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
  EndIf

Unterstützte OS

All