Comment : définir le redimensionnement et le positionnement du comportement dans une fenêtre fractionnée

Les panneaux du contrôle SplitContainer se prêtent bien au redimensionnement et à la manipulation par les utilisateurs. Toutefois, il peut arriver que vous souhaitiez contrôler par programme le séparateur, sa position et à quel degré il peut être déplacé.

La propriété SplitterIncrement et les autres propriétés du contrôle SplitContainer vous offrent un contrôle précis sur le comportement de votre interface utilisateur pour l'adapter à vos besoins. Ces propriétés sont répertoriées dans le tableau suivant.

Nom	Description
Propriété IsSplitterFixed	Détermine si le séparateur peut être déplacé au moyen du clavier ou de la souris.
Propriété SplitterDistance	Détermine la distance en pixels entre le bord gauche ou supérieur et la barre de fractionnement mobile.
Propriété SplitterIncrement	Détermine la distance minimale, en pixels, que l'utilisateur peut faire parcourir au séparateur.

L'exemple suivant modifie la propriété SplitterIncrement pour créer l'effet d'un « séparateur d'alignement » ; lorsque l'utilisateur fait glisser le séparateur, il incrémente par unités de 10 pixels plutôt que par la valeur par défaut 1.

Pour définir le comportement de redimensionnement du contrôle SplitContainer

• Dans une procédure, affectez à la propriété SplitterIncrement la taille voulue, afin que le comportement « d'alignement » du séparateur s'exécute.

  Dans l'exemple de code suivant, dans l'événement Load du formulaire, le séparateur du contrôle SplitContainer est configuré pour un saut de 10 pixels lorsque vous le faites glisser.

  Private Sub Form1_Load(ByVal sender As System.Object, _
      ByVal e As System.EventArgs) Handles MyBase.Load
      Dim splitSnapper as new SplitContainer()
      splitSnapper.SplitterIncrement = 10
      splitSnapper.Dock = DockStyle.Fill
      splitSnapper.Parent = me
  End Sub
  

  private void Form1_Load(System.Object sender, System.EventArgs e)
  {
      SplitContainer splitSnapper = new SplitContainer();
      splitSnapper.SplitterIncrement = 10;
      splitSnapper.Dock = DockStyle.Fill;
      splitSnapper.Parent = this;
  }
  

  (Visual C#) Placez le code suivant dans le constructeur du formulaire pour inscrire le gestionnaire d'événements.

  this.Load += new System.EventHandler(this.Form1_Load);
  

  Le fait de déplacer le séparateur légèrement vers la gauche ou la droite n'aura aucun effet visible ; toutefois, lorsque le pointeur de la souris se déplace de 10 pixels dans l'un des deux sens, le séparateur s'alignera sur la nouvelle position.

Voir aussi

Référence

SplitContainer

SplitterIncrement