PanelGadget()

Syntaxe

Resultat = PanelGadget(#Gadget, X, Y, Largeur, Hauteur)

Crée un gadget boîte à onglets (Panel) dans la GadgetList.

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.

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 fonctions suivantes peuvent être appelées pour agir sur la liste :
  - AddGadgetItem()     : Ajoute un élément. 
  - RemoveGadgetItem()  : Supprime un élément. 
  - CountGadgetItems()  : Renvoie le nombre d'éléments.
  - ClearGadgetItems()  : Supprime tous les éléments. 
  - GetGadgetItemText() : Renvoie le texte de l'élément spécifié. 
  - SetGadgetItemText() : Change le texte de l'élément spécifié. 
  - SetGadgetItemImage(): Change l'image de l'élément spécifié (non pris en charge sur OS X).  
  - GetGadgetItemData() : Renvoie la valeur associée à l'élément spécifié.
  - SetGadgetItemData() : Associe une valeur à l'élément spécifié.
  - SetGadgetState()    : Change l'onglet affiché. 
  - GetGadgetState()    : Renvoie le numéro de l'onglet actuellement affiché.

  - GetGadgetAttribute() avec un des attributs suivants (il doit y avoir au moins un élément dans le PanelGadget()):
    #PB_Panel_ItemWidth : Renvoie la largeur de la zone utilisable d'un onglet.
    #PB_Panel_ItemHeight: Renvoie la hauteur de la zone utilisable d'un onglet.
    #PB_Panel_TabHeight : Renvoie la hauteur d'un bouton de changement d'onglet.

  Les évènements suivants sont pris en charge par EventType():
  #PB_EventType_Change: L'onglet courant a changé.
  #PB_EventType_Resize: Le gadget a été redimensionné.

Lorsqu'une boîte à onglets est créée, sa liste d'éléments est vide. Avant de pouvoir ajouter des gadgets ou des onglets, il faut qu'il existe au moins un onglet au préalable, il est nécessaire d'appeler la commande AddGadgetItem() pour cela. Les prochains gadgets créés le seront automatiquement sur le dernier onglet. Lorsque tous les gadgets de la boîte à onglets ont été placés, CloseGadgetList() doit être appelé pour revenir à la GadgetList précédente. Il est ainsi parfaitement possible de créer une boîte à onglets dans une autre boîte à onglets...

Exemple

  ; Exemple d'utilisation de plusieurs onglets...
  If OpenWindow(0, 0, 0, 322, 220, "PanelGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) 
    PanelGadget     (0, 8, 8, 306, 203)
      AddGadgetItem (0, -1, "Onglet 1")
        PanelGadget (1, 5, 5, 290, 166)
          AddGadgetItem(1, -1, "Sous-onglet 1")
          AddGadgetItem(1, -1, "Sous-onglet 2")
          AddGadgetItem(1, -1, "Sous-onglet 3")
        CloseGadgetList()
      AddGadgetItem (0, -1,"Onglet 2")
        ButtonGadget(2, 10, 15, 80, 24,"Bouton 1")
        ButtonGadget(3, 95, 15, 80, 24,"Bouton 2")
    CloseGadgetList()
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Voir aussi

AddGadgetItem(), RemoveGadgetItem(), CountGadgetItems(), ClearGadgetItems(), GetGadgetItemText(), SetGadgetItemText(), GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), CloseGadgetList(), OpenGadgetList(), SetGadgetItemImage()

OS Supportés

Tous