Partager via

Guide pratique pour définir le comportement de redimensionnement et de positionnement dans une fenêtre fractionnée

  • Article

Les panneaux du contrôle SplitContainer se prêtent bien à être redimensionnés et manipulés par les utilisateurs. Toutefois, il y aura des moments où vous souhaiterez contrôler par programmation le séparateur, où il est positionné et dans quel degré il peut être déplacé.

La propriété SplitterIncrement et les autres propriétés du contrôle SplitContainer vous permettent de contrôler précisément le comportement de votre interface utilisateur en fonction de 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 est mobile 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, à laquelle l'utilisateur peut déplacer le séparateur.

L’exemple ci-dessous modifie la propriété SplitterIncrement pour créer un effet de "fractionnement par paliers" ; lorsque l’utilisateur fait glisser le séparateur, celui-ci se déplace par paliers de 10 pixels au lieu de l'unité par défaut de 1 pixel.

Pour définir le comportement de redimensionnement de SplitContainer

  1. Dans une procédure, définissez la propriété SplitterIncrement sur la taille souhaitée pour obtenir le comportement d'ajustement automatique du séparateur.

    Dans l'exemple de code suivant, lors de l'événement Load du formulaire, le séparateur dans le contrôle SplitContainer est réglé pour se déplacer de 10 pixels lorsqu'il est traîné.

    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);

    Déplacer le séparateur légèrement vers la gauche ou la droite n’aura aucun effet discernable ; toutefois, lorsque le pointeur de la souris se déplace de 10 pixels dans l'une ou l'autre direction, le séparateur s’aligne sur la nouvelle position.

Voir aussi