SplitterGadget()

Syntaxe

Resultat = SplitterGadget(#Gadget, X, Y, Largeur, Hauteur, #Gadget1, #Gadget2 [, Options])
Description
Crée une zone séparée en deux parties (horizontalement ou verticalement), chacune contenant un gadget fils.
La barre de séparation peut être déplacée librement par l'utilisateur et les deux gadgets associés seront redimensionnés automatiquement.

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.
#Gadget1, #Gadget2 Les gadgets fils.
Options (optionnel) Peut être une combinaison de:
  #PB_Splitter_Vertical   : La zone sera séparée verticalement.
  #PB_Splitter_Separator  : Un motif 3D est affiché dans la barre de séparation.
  #PB_Splitter_FirstFixed : Quand le SplitterGadget sera redimensionné, le premier gadget associé gardera sa taille.
  #PB_Splitter_SecondFixed: Quand le SplitterGadget sera redimensionné, le deuxième gadget associé  gardera sa taille.

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 utilisées pour agir sur le gadget:
  GetGadgetState(): Renvoie la position de la barre de séparation, en pixels.
  SetGadgetState(): Change la position de la barre de séparation, en pixels.
  GetGadgetAttribute() avec un des attributs suivants:
    #PB_Splitter_FirstMinimumSize : Renvoie la taille minimale (en pixels) que le premier gadget associé peut avoir. 
    #PB_Splitter_SecondMinimumSize: Renvoie la taille minimale (en pixels) que le deuxième gadget associé peut avoir.
    #PB_Splitter_FirstGadget      : Renvoie le numéro du premier gadget.
    #PB_Splitter_SecondGadget     : Renvoie le numéro du deuxième gadget.

  SetGadgetAttribute() avec un des attributs suivants:
    #PB_Splitter_FirstMinimumSize : Fixe la taille minimale (en pixels) que le premier gadget associé peut avoir. 
    #PB_Splitter_SecondMinimumSize: Fixe la taille minimale (en pixels) que le deuxième gadget associé peut avoir.
    #PB_Splitter_FirstGadget      : Remplace le premier gadget avec un nouveau.
    #PB_Splitter_SecondGadget     : Remplace le deuxième gadget avec un nouveau.

  Note: Quand un gadget est remplacé à l'aide de SetGadgetAttribute(), l'ancien gadget n'est pas automatiquement supprimé. 
  Il sera remis sur la fenêtre qui contient le splitter, pour permettre de permuter les gadgets entre différents splitters 
  sans avoir à les recréer. Si l'ancien gadget doit être supprimé, son numéro peut être recupéré avec GetGadgetAttribute() 
  puis supprimé par FreeGadget() après son remplacement. Un gadget ne peut pas être dans deux splitters à la fois.

Exemple

  If OpenWindow(0, 0, 0, 240, 230, "SplitterGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    #Bouton1    = 0 
    #Bouton2    = 1
    #Separateur = 2
      
    ButtonGadget(#Bouton1, 0, 0, 0, 0, "Bouton 1") ; Inutile de préciser la taille ou les coordonnées
    ButtonGadget(#Bouton2, 0, 0, 0, 0, "Bouton 2") ; car elles seront déterminées automatiquement
    SplitterGadget(#Separateur, 5, 5, 230, 130, #Bouton1, #Bouton2, #PB_Splitter_Separator)
      
    TextGadget(3, 10, 135, 210, 90, "Le composant d'interface graphique ci-dessus affiche deux boutons automatiquement redimensionnés à l'intérieur de la zone séparée de taille 230x130.",#PB_Text_Center)
      
    Repeat 
    Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Voir aussi

GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), SetGadgetAttribute()

OS Supportés

Tous

<- SpinGadget() - Gadget Index - StringGadget() ->