ButtonGadget()

Syntaxe

Resultat = ButtonGadget(#Gadget, X, Y, Largeur, Hauteur, Texte$ [, Options])
Description
Crée un bouton 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 Les coordonnées et la position du bouton dans la fenêtre.
Note: Sur OS X, utiliser une hauteur de 25 activera un bouton avec une hauteur fixe, ce qui est couramment utilisé dans les applications OS X. Il activera également l'option #PB_Button_Default.
Texte$ Le texte qui sera affiché dans le bouton.
Options (optionnel) Peut être une combinaison des constantes suivantes:
  #PB_Button_Right    : Aligne le texte du bouton à droite (non supporté sous OS X).
  #PB_Button_Left     : Aligne le texte du bouton à gauche (non supporté sous OS X).
  #PB_Button_Default  : Définit le bouton comme bouton par défaut (sur OS X, la hauteur du bouton doit être 25).
  #PB_Button_MultiLine: Affiche le texte sur plusieurs lignes s'il est trop long (non supporté sous OS X).
  #PB_Button_Toggle   : Crée un bouton de type 'Toggle' (bascule). Ce bouton alterne l'état 'appuyé' et 'normal'.

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 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.
  
  Utile avec les boutons de type bascule (#PB_Button_Toggle)
  - SetGadgetState():  Changer d'état (1 = pressé, 0 = normal).
  - GetGadgetState():  Renvoie l'état (1 = pressé, 0 = normal).
Pour Windows 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 et suivant, le support des thèmes d'affichage peut empêcher le caractère souligné de s'afficher.)

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

Voir aussi

SetGadgetText(), GetGadgetText(), SetGadgetState(), GetGadgetState(), ButtonImageGadget()

OS Supportés

Tous

<- BindGadgetEvent() - Gadget Index - ButtonImageGadget() ->