PanelGadget()

Syntaxe

Resultat = PanelGadget(#Gadget, x, y, Largeur, Hauteur)

Crée un gadget Boîte à onglets (Panel) dans la GadgetList. Si #PB_Any est utilisé pour le paramètre '#Gadget', le numéro du nouveau gadget sera renvoyé dans 'Resultat'. #Gadget est le numéro du gadget renvoyé par la fonction EventGadget(). x et y représentent la position de la boîte à onglets dans la fenêtre, Largeur et Hauteur, ses dimensions. Lorsqu'une boîte à onglets est créée, sa liste d'éléments est vide.

Vous pouvez ajouter une 'mini aide' à ce gadget en utilisant GadgetToolTip().

Les fonctions suivantes peuvent être appelées pour agir sur la liste :

- AddGadgetItem(): Ajoute un élément
- RemoveGadgetItem(): Supprime un élément
- ClearGadgetItemList(): 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é.

- 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.

Avant de pouvoir ajouter des gadgets, il est nécessaire d'appeler la commande AddGadgetItem() pour ajouter au moins un onglet. 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) And CreateGadgetList(WindowID(0))
    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

OS Supportés

Tous