ButtonGadget()

Syntaxe

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

Crée un bouton dans la GadgetList en cours. Si #PB_Any est utilisé pour le paramètre '#Gadget', le numéro du nouveau gadget sera renvoyé dans 'Resultat'. #Gadget sera la valeur retournée par la fonction EventGadget(). x et y sont les coordonnées de la position du bouton dans la fenêtre. 'Largeur' et 'Hauteur' sont ses dimensions, 'Texte$' contient le texte qui sera affiché dans le bouton.

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

  #PB_Button_Right    : Aligne le texte du bouton à droite (non supporté sous Mac OSX).
  #PB_Button_Left     : Aligne le texte du bouton à gauche (non supporté sous Mac OSX).
  #PB_Button_Default  : Définit le bouton comme bouton par défaut (encadré en noir).
  #PB_Button_MultiLine: Affiche le texte sur plusieurs lignes s'il est trop long (non supporté sous Mac OSX).
  #PB_Button_Toggle   : Crée un bouton de type 'Toogle'. Ce bouton alterne l'état 'appuyé' et 'normal'.

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

Les commandes suivantes peuvent être utilisées pour agir sur le gadget:

- SetGadgetText(): Change le texte affiché par le bouton.
- GetGadgetText(): Renvoie le texte affiché par le bouton.
- SetGadgetState(): Utile avec les boutons poussoirs (#PB_Button_Toggle) pour changer son état (1 = pressé, 0 = normal).
- GetGadgetState(): Utile avec les boutons poussoirs (#PB_Button_Toggle) pour récupérer son état (1 = pressé, 0 = normal).



Pour Window uniquement:
Vous pouvez utiliser le caractère '&' pour souligner une lettre particulière dans le 'Texte$'du bouton : "&Bouton" affichera : Bouton
(Note: Sous Windows XP le caractère souligné apparait seulement si cette option n'est pas désactivée.)

Vous pouvez associer un raccourci clavier au bouton avec la commande AddKeyboardShortcut().

Exemple

  ; Démonstration des options possibles pour le gadget bouton
  ;
  If OpenWindow(0, 0, 0, 222, 200, "ButtonGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) 
    ButtonGadget(0, 10,  10, 200, 20, "Bouton standard")
    ButtonGadget(1, 10,  40, 200, 20, "Texte aligné à gauche", #PB_Button_Left)
    ButtonGadget(2, 10,  70, 200, 20, "Texte aligné à droite", #PB_Button_Right)
    ButtonGadget(3, 10, 100, 200, 60, "Texte sur plusieurs lignes (les textes longs retournent automatiquement à la ligne)", #PB_Button_MultiLine)
    ButtonGadget(4, 10, 170, 200, 20, "Bouton à bascule", #PB_Button_Toggle)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

OS Supportés

Tous