StringGadget()

Syntaxe

Resultat = StringGadget(#Gadget, X, Y, Largeur, Hauteur, Texte$ [, Options])
Description
Crée un gadget de saisie de texte (une seule ligne) dans la GadgetList en cours.

Arguments

#Gadget Le numéro d'identification du nouveau gadget.

#PB_Any peut être utilisé pour générer automatiquement ce numéro.
X, Y, Largeur, Hauteur La position et les dimensions du nouveau gadget.
Texte$ Le texte initial.

Ce gadget accepte une seule ligne de texte. Pour obtenir plusieurs lignes d'entrée, utiliser le gadget EditorGadget().
Options (optionnel) Peut être une combinaison de: 
  #PB_String_Numeric   : Seuls des nombres entiers positifs peuvent être saisis.
  #PB_String_Password  : Mode 'mot de passe', n'affiche que des '*'.
  #PB_String_ReadOnly  : Mode 'lecture seulement'.
  #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.

Valeur de retour

Renvoie une valeur non nulle en cas de succès, zéro sinon.

Si #PB_Any a été utilisé pour le paramètre #Gadget, alors la valeur de retour est le numéro d'identification du gadget, généré automatiquement.

Remarques

  - GadgetToolTip() permet d'ajouter une 'mini aide' à ce gadget.

  - Le texte pourra être ensuite modifié par les fonctions SetGadgetText() et GetGadgetText(). 

  - 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.

  - Les fonctions suivantes peuvent agir sur le gadget:
    SetGadgetColor() et GetGadgetColor() avec les valeurs 'TypeCouleur' suivantes:
      #PB_Gadget_BackColor    : Couleur de fond
      #PB_Gadget_FrontColor   : Couleur du texte

  - GetGadgetAttribute() avec les attributs suivants:
      #PB_String_MaximumLength: Renvoie le nombre maximal de caractères qui peuvent être entrés.

  - SetGadgetAttribute() avec les attributs suivants:
      #PB_String_MaximumLength: Limite le nombre maximum de caractères qui peuvent être entrés.

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)
    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

Voir aussi

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

OS Supportés

Tous

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