ButtonImageGadget()

Syntaxe

Resultat = ButtonImageGadget(#Gadget, X, Y, Largeur, Hauteur, ImageID [, Options])

Crée un bouton avec image dans la GadgetList en cours.

Arguments

#Gadget	Le numéro 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.
ImageID	Le numéro d'identification de l'image du gadget. Utiliser la fonction ImageID() pour obtenir ce numéro. Ce paramètre peut être égal à zéro pour créer un bouton sans image. La fonction SetGadgetAttribute() peut être utilisée pour modifier l'image plus tard.
Options (optionnel)	#PB_Button_Toggle crée un bouton à bascule (garde son état ON/OFF) qui 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é à la place de #Gadget alors la valeur de retour est le numéro du gadget, généré automatiquement.

Remarques

  - GadgetToolTip() permet d'ajouter une 'mini aide' à ce gadget. 
 
  Les fonctions suivantes peuvent être utilisées pour contrôler le gadget:
  - GetGadgetAttribute() avec une des valeurs suivantes:
    #PB_Button_Image       : Renvoie l'identifiant de l'image du bouton, ex. ImageID(#ImageRelachee).
    #PB_Button_PressedImage: Renvoie l'identifiant de l'image du bouton lorsqu'il est enfoncé, ex. ImageID(#ImageEnfoncee).

  - SetGadgetAttribute() avec une des valeurs suivantes:
    #PB_Button_Image       : Change l'image du bouton.
    #PB_Button_PressedImage: Change l'image du bouton lorsqu'il est enfoncé.

Bouton à bascule: Option #PB_Button_Toggle
  - SetGadgetState():  Change d'état (1 = pressé, 0 = normal).
  - GetGadgetState():  Renvoie l'état (1 = pressé, 0 = normal).

Exemple

  If OpenWindow(0, 0, 0, 200, 60, "ButtonImageGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) 
    If LoadImage(0,  #PB_Compiler_Home + "/Examples/Sources/Data/PureBasic.bmp")    ; changez le 2ème paramètre en indiquant le chemin/fichier contenant votre image
      ButtonImageGadget(0, 10, 10, 180, 40, ImageID(0))
    EndIf
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Voir aussi

GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), SetGadgetAttribute(), ButtonGadget(), ImageID(), EventGadget()

OS Supportés

Tous