StringGadget()

Syntaxe

Resultat = StringGadget(#Gadget, x, y, Largeur, Hauteur, Texte$ [, Options])

Crée un gadget de 'saisie de texte' dans la GadgetList. Si #PB_Any est utilisé pour le paramètre '#Gadget', le numéro du nouveau gadget sera renvoyé dans 'Resultat'. #Gadget est le numéro retourné par la fonction EventGadget(). Texte$ contient le texte initial du gadget. Ce texte pourra être ensuite modifié par les fonctions SetGadgetText() et GetGadgetText()

Le paramètre facultatif 'Options' peut être une combinaison des constantes suivantes:

  #PB_String_Password  : Mode 'mot de passe', n'affiche que des '*'.
  #PB_String_ReadOnly  : Mode 'lecture seulement'.
  #PB_String_Numeric   : Mode 'numeric'. Seuls des chiffres peuvent être saisis.
  #PB_String_LowerCase : Tous les caractères saisis sont transformés en minuscules.
  #PB_String_UpperCase : Tous les caractères saisis sont transformés en majuscules.
  #PB_String_BorderLess: Aucune bordure n'est affichée autour du gadget.

Les évènements suivants sont disponibles par l'intermédiaire d'EventType():

  #PB_EventType_Change    : Le texte a été modifié par l'utilisateur.
  #PB_EventType_Focus     : Le StringGadget obtient le focus.
  #PB_EventType_LostFocus : Le StringGadget a perdu le focus.

Ce gadget supporte les commandes SetGadgetColor() et GetGadgetColor() avec les valeurs 'TypeCouleur' suivantes:

  #PB_Gadget_BackColor : Couleur de fond
  #PB_Gadget_FrontColor: Couleur du texte

Vous pouvez ajouter une 'mini aide' à ce gadget en utilisant GadgetToolTip().

Exemple:

  ; Démonstration des options possibles pour le gadget de saisie de texte...
  If OpenWindow(0, 0, 0, 322, 205, "Les options de StringGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) And CreateGadgetList(WindowID(0))
    StringGadget(0, 8,  10, 306, 20, "Gadget saisie de texte normal...")
    StringGadget(1, 8,  35, 306, 20, "1234567", #PB_String_Numeric)
    StringGadget(2, 8,  60, 306, 20, "Gadget saisie de texte en lecture seule", #PB_String_ReadOnly)
    StringGadget(3, 8,  85, 306, 20, "minuscules...", #PB_String_LowerCase)
    StringGadget(4, 8, 110, 306, 20, "majuscules...", #PB_String_UpperCase)
    StringGadget(5, 8, 140, 306, 20, "Gadget saisie de texte sans bordure", #PB_String_BorderLess)
    StringGadget(6, 8, 170, 306, 20, "Mot de passe", #PB_String_Password)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

OS Supportés

Tous