SplitterGadget()

Syntaxe

Resultat = SplitterGadget(#Gadget, x, y, Largeur, Hauteur, #Gadget1, #Gadget2 [, Options])

Créé une zone séparée en deux parties (horizontalement ou verticalement), chacune pouvant contenir un gadget. Si #PB_Any est utilisé pour le paramètre '#Gadget', le numéro du nouveau gadget sera renvoyé dans 'Resultat'. La barre de séparation peut être déplacée librement par l'utilisateur et les deux gadgets associés seront redimensionnés automatiquement. #Gadget est le numéro du gadget renvoyé par la fonction EventGadget().

Le paramètre facultatif 'Options' peut être une combinaison des constantes suivantes:

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

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

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, 230, 210, "SplitterGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If CreateGadgetList(WindowID(0))
      
      #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, 220, 120, #Bouton1, #Bouton2, #PB_Splitter_Separator)
      
      TextGadget(3, 10, 135, 210, 70, "Le composant d'interface graphique ci-dessus affiche deux boutons automatiquement redimensionnés à l'intérieur de la zone séparée de taille 220x120.",#PB_Text_Center)
      
      Repeat 
      Until WaitWindowEvent() = #PB_Event_CloseWindow
    EndIf
  EndIf

OS Supportés

Tous