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