ImageGadget()

Syntaxe

Resultat = ImageGadget(#Gadget, X, Y, Largeur, Hauteur, ImageID [, Options])
Description
Crée un gadget Image dans la GadgetList en cours.

Un gadget Image permet de positionner une image dans une fenêtre.

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.

Le gadget ajuste sa largeur et sa hauteur pour s'adapter à l'image affichée.

La largeur et la hauteur spécifiées ne sont utilisés que si aucune image ne s'affiche.
ImageID L'image à afficher. Utiliser la fonction ImageID() pour obtenir l'ID d'une image.

Si ce paramètre est 0, aucune image ne sera affichée.
Options (optionnel)
  #PB_Image_Border : Affiche un cadre autour de l'image.
  #PB_Image_Raised : Affiche une bordure surélevée autour de l'image.

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. 

  - SetGadgetState(): Permet de changer dynamiquement l'image contenue dans le gadget. 
    Un ImageID valide peut être obtenu via ImageID(). Si 'ImageID' est 0, alors l'image est retirée du gadget.

  Les évènements suivants sont supportés par EventType():
    #PB_EventType_Change          : L'élément courant a changé
    #PB_EventType_LeftClick       : L'utilisateur a cliqué sur un élément avec le bouton gauche de la souris.
    #PB_EventType_RightClick      : L'utilisateur a cliqué sur un élément avec le bouton droit de la souris.
    #PB_EventType_LeftDoubleClick : L'utilisateur a double-cliqué sur un élément avec le bouton gauche de la souris.
    #PB_EventType_RightDoubleClick: L'utilisateur a double-cliqué sur un élément avec le bouton droit de la souris.
    #PB_EventType_DragStart       : L'utilisateur a essayé de lancer une opération 'Glisser & Déposer'.

  Après un évènement #PB_EventType_DragStart , la bibliothèque Drag & Drop peut être 
  utilisée pour commencer une opération 'Glisser & Déposer'.

  Si vous avez besoin de plus de types d'évènements ou de l'affichage avec double-tampon pour une mise à jour 
  régulière de l'image alors jetez un oeil au canvas gadget CanvasGadget().

Exemple

  If OpenWindow(0, 0, 0, 245, 105, "ImageGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If LoadImage(0, "map.bmp")    ; changez le 2ème paramètre en indiquant le chemin/fichier contenant votre image
      ImageGadget(0,  10, 10, 100, 83, ImageID(0))                      ; imagegadget standard
      ImageGadget(1, 130, 10, 100, 83, ImageID(0), #PB_Image_Border)     ; imagegadget avec cadre
    EndIf
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Voir aussi

GetGadgetState(), SetGadgetState(), ButtonImageGadget(), ImageID(), CanvasGadget()

OS Supportés

Tous

<- IPAddressGadget() - Gadget Index - IsGadget() ->