Partager via


Vue d'ensemble du contrôle SplitContainer (Windows Forms)

Le contrôle SplitContainer Windows Forms peut être considéré comme un composite ; il s'agit de deux panneaux séparés par une barre mobile. Lorsque le pointeur de la souris est sur la barre, il change de forme pour montrer que la barre est mobile.

Important

Dans la Boîte à outils, le contrôle SplitContainer remplace le contrôle Splitter qui était utilisé dans la version antérieure de Visual Studio. Le contrôle SplitContainer est préféré au contrôle Splitter. La classe Splitter est toujours incluse dans le .NET Framework pour des raisons de compatibilité avec les applications existantes, mais il est fortement recommandé d'utiliser le contrôle SplitContainer pour les nouveaux projets.

Avec le contrôle SplitContainer, vous pouvez créer des interfaces utilisateur complexes ; une sélection dans un panneau détermine souvent les objets affichés dans l'autre panneau. Cette disposition est très efficace pour l'affichage et l'exploration des informations. Le fait d'avoir deux panneaux vous permet de regrouper des informations dans des zones et la barre, ou « séparateur », permet aux utilisateurs de redimensionner aisément les panneaux.

Plusieurs contrôles SplitContainer peuvent également être imbriqués, avec le deuxième contrôle SplitContainer orienté horizontalement, pour créer des panneaux inférieur et supérieur.

N'oubliez pas que le contrôle SplitContainer est accessible par le clavier par défaut ; les utilisateurs peuvent appuyer sur les touches de direction pour déplacer le séparateur si la propriété IsSplitterFixed a la valeur false.

La propriété Orientation du contrôle SplitContainer détermine la direction du séparateur et non du contrôle lui-même. Par conséquent, lorsque cette propriété a la valeur Vertical, le séparateur s'exécute de haut en bas, en créant des panneaux gauche et droit.

En outre, n'oubliez pas que la valeur de la propriété SplitterRectangle varie selon la valeur de la propriété Orientation. Pour plus d'informations, consultez la propriété SplitterRectangle.

Vous pouvez également restreindre la taille et le déplacement du contrôle SplitContainer. La propriété FixedPanel détermine le panneau qui conservera la même taille après le redimensionnement du contrôle SplitContainer, et la propriété IsSplitterFixed détermine si le séparateur est mobile par le clavier ou la souris.

Notes

Même si la propriété IsSplitterFixed a la valeur true, le séparateur peut encore être déplacé par programme ; par exemple, en utilisant la propriété SplitterDistance.

Enfin, chaque panneau du contrôle SplitContainer a des propriétés permettant de déterminer sa taille individuelle.

Propriétés, méthodes et événements fréquemment utilisés

Nom

Description

Propriété FixedPanel

Détermine le panneau qui conservera la même taille après le redimensionnement du contrôle SplitContainer.

Propriété IsSplitterFixed

Détermine si le séparateur peut être déplacé avec le clavier ou la souris.

Propriété Orientation

Détermine si le séparateur est disposé verticalement ou horizontalement.

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.

Propriété SplitterWidth

Détermine l'épaisseur, en pixels, du séparateur.

Événement SplitterMoving

Se produit lorsque le séparateur se déplace.

Événement SplitterMoved

Se produit lorsque le séparateur s'est déplacé.

Voir aussi

Tâches

SplitContainer Control Sample

Référence

SplitContainer

Autres ressources

SplitContainer, contrôle (Windows Forms)