EditorGadget()

Syntaxe

Resultat = EditorGadget(#Gadget, X, Y, Largeur, Hauteur [, Options])
Description
Crée un gadget de type 'éditeur' permettant de saisir une grande quantité de texte dans la GadgetList courante.

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.
Options (optionnel) Peut être une combinaison de:
  #PB_Editor_ReadOnly: Gadget en lecture seule.
  #PB_Editor_WordWrap: Retour à la ligne automatique.
  

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. 
 
  - Les évènements suivants sont pris en charge par EventType():
    #PB_EventType_Change   : Le texte a été modifié par l'utilisateur.
    #PB_EventType_Focus    : L'éditeur a obtenu le focus.
    #PB_EventType_LostFocus: l'éditeur a perdu le focus.
 
 
  Les commandes suivantes peuvent être utilisées pour agir sur le contenu du gadget:
  - AddGadgetItem()    : Ajoute une ligne de texte
  - CountGadgetItems() : Renvoie le nombre de lignes contenues dans le gadget.
  - GetGadgetItemText(): Renvoie la ligne de texte spécifié
  - GetGadgetText()    : Renvoie tout le texte contenu dans le gadget. 
                         Notez que le retour à la ligne se fait avec "Chr (13) + Chr (10)" 
                         sous Windows et avec "Chr (10)" sous Linux et OS X.
  - RemoveGadgetItem() : Efface la ligne spécifiée
  - ClearGadgetItems() : Efface tout le texte
  - SetGadgetItemText(): Change le contenu de la ligne spécifiée
  - SetGadgetText()    : Remplace tout le texte contenu par le gadget par un autre
  
  - SetGadgetAttribute() avec l'attribut suivant:
    #PB_Editor_ReadOnly: Change l'état 'lecture seule' du gadget (0 = éditable, 1 = non éditable).
    #PB_Editor_WordWrap: Retour à la ligne automatique.

  - GetGadgetAttribute() avec l'attribut suivant:
    #PB_Editor_ReadOnly: Renvoie l'état 'lecture seule' du gadget (0 = éditable, 1 = non éditable).
    #PB_Editor_WordWrap: Renvoie l'état du retour à la ligne automatique.

  - SetGadgetColor() et GetGadgetColor() avec les valeurs 'TypeCouleur' suivantes:
    #PB_Gadget_BackColor : Couleur de fond
    #PB_Gadget_FrontColor: Couleur du texte

Exemple

  If OpenWindow(0, 0, 0, 322, 150, "EditorGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)  
    EditorGadget(0, 8, 8, 306, 133) 
    For a = 0 To 5 
      AddGadgetItem(0, a, "Ligne "+Str(a)) 
    Next 
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow 
  EndIf 

Voir aussi

AddGadgetItem(), RemoveGadgetItem(), CountGadgetItems(), ClearGadgetItems(), GetGadgetText(), SetGadgetText(), GetGadgetItemText(), SetGadgetItemText(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetColor(), SetGadgetColor(), StringGadget()

OS Supportés

Tous

<- DisableGadget() - Gadget Index - ExplorerComboGadget() ->