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.
  #PB_Editor_TabNavigation : Lorsque vous utilisez TAB dans le gadget, il passera au gadget suivant au lieu d'insérer un caractère TAB.

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