StringGadget3D()

Syntaxe

Resultat = StringGadget3D(#Gadget3D, 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 '#Gadget3D', le numéro du nouveau gadget sera renvoyé dans 'Resultat'. #Gadget3D est le numéro retourné par la fonction EventGadget3D(). 'Texte$' contient le texte initial du gadget. Ce texte pourra être ensuite modifié par les fonctions SetGadgetText3D() et GetGadgetText3D()

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

  #PB_String3D_Password  : Mode 'mot de passe', n'affiche que des '*'.
  #PB_String3D_ReadOnly  : Mode 'lecture seulement'.
  #PB_String3D_Numeric   : Mode 'numeric'. Seuls des chiffres peuvent être saisis.

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

  #PB_EventType3D_Change    : Le texte a été modifié par l'utilisateur.
  #PB_EventType3D_Focus     : Le StringGadget obtient le focus.
  #PB_EventType3D_LostFocus : Le StringGadget a perdu le focus.

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

OS Supportés

Tous