CSplitterWnd, classe

Article
06/10/2015

Fournit les fonctionnalités d'une fenêtre fractionnée, qui est une fenêtre qui contient plusieurs volets.

class CSplitterWnd : public CWnd

Membres

Constructeurs publics

Nom	Description
CSplitterWnd::CSplitterWnd	Appelez pour construire un objet d' CSplitterWnd .

Méthodes publiques

Nom	Description
CSplitterWnd::ActivateNext	Exécute le prochain volet ou la commande précédente de volet.
CSplitterWnd::CanActivateNext	Vérifie si le prochain volet ou la commande précédente du volet est possible actuellement.
CSplitterWnd::Create	Appelez pour créer une fenêtre fractionnée dynamique et pour la liaison à l'objet d' CSplitterWnd .
CSplitterWnd::CreateScrollBarCtrl	Crée un contrôle de barre de défilement partagé.
CSplitterWnd::CreateStatic	Appelez pour créer une fenêtre fractionnée statique et pour la liaison à l'objet d' CSplitterWnd .
CSplitterWnd::CreateView	Appelez pour créer un volet dans une fenêtre fractionnée.
CSplitterWnd::DeleteColumn	Supprime une colonne de la fenêtre fractionnée.
CSplitterWnd::DeleteRow	Supprime une ligne de la fenêtre fractionnée.
CSplitterWnd::DeleteView	Supprime une vue de la fenêtre fractionnée.
CSplitterWnd::DoKeyboardSplit	Exécute la commande fractionnée de clavier, généralement « fractionnement de fenêtre. »
CSplitterWnd::DoScroll	Performs est synchronisé le défilement des fenêtres fractionnées.
CSplitterWnd::DoScrollBy	Défile fractionnent les fenêtres par un nombre donné de pixels.
CSplitterWnd::GetActivePane	Détermine le volet actif à partir de le focus ou de la vue active dans le frame.
CSplitterWnd::GetColumnCount	Retourne le nombre de colonnes actuellement pane.
CSplitterWnd::GetColumnInfo	Retourne des informations sur la colonne spécifiée.
CSplitterWnd::GetPane	Retourne le volet à la ligne et la colonne spécifiées.
CSplitterWnd::GetRowCount	Retourne le nombre de lignes en cours de volet.
CSplitterWnd::GetRowInfo	Retourne des informations sur la ligne spécifiée.
CSplitterWnd::GetScrollStyle	Retourne le style partagé de barre de défilement.
CSplitterWnd::IdFromRowCol	Retourne l'ID de fenêtre enfant du volet à la ligne et la colonne spécifiées.
CSplitterWnd::IsChildPane	Appel à déterminer si la fenêtre est actuellement un volet enfant de cette fenêtre fractionnée.
CSplitterWnd::IsTracking	Détermine si la barre de fractionnement actuel est déplacée.
CSplitterWnd::RecalcLayout	Appelez pour afficher à nouveau la fenêtre fractionnée après avoir défini la taille de ligne ou de colonne.
CSplitterWnd::SetActivePane	Définit un volet pour être l'actif dans le frame.
CSplitterWnd::SetColumnInfo	Appelez pour définir les informations des colonnes spécifiées.
CSplitterWnd::SetRowInfo	Appelez pour définir les informations spécifiées de ligne.
CSplitterWnd::SetScrollStyle	Spécifie le style de barre de défilement pour le stockage partagé de la barre de défilement de la fenêtre fractionnée.
CSplitterWnd::SplitColumn	Indique où une fenêtre frame fractionne verticalement.
CSplitterWnd::SplitRow	Indique où une fenêtre frame fractionne horizontalement.

Méthodes protégées

Nom	Description
CSplitterWnd::OnDraw	Appelé par l'infrastructure pour dessiner la fenêtre fractionnée.
CSplitterWnd::OnDrawSplitter	Affiche une image d'une fenêtre fractionnée.
CSplitterWnd::OnInvertTracker	Affiche l'image d'une fenêtre fractionnée pour être la même taille et la forme comme une fenêtre frame.

Notes

Un volet est généralement un objet spécifique à l'application dérivée de CView, mais elle peut être n'importe quel objet de CWnd ayant l'ID appropriée de fenêtre enfant

Un objet d' CSplitterWnd est généralement inclus dans un objet parent de CFrameWnd ou de CMDIChildWnd . Créez un objet d' CSplitterWnd à l'aide de les étapes suivantes :

Incluez une variable membre d' CSplitterWnd dans le frame parent.
Substituez la fonction membre parent de CFrameWnd::OnCreateClient du frame.
D' OnCreateClientsubstitution, appelez la fonction membre de Create ou de CreateStatic d' CSplitterWnd.

Appelez la fonction membre de Créer pour créer une fenêtre fractionnée dynamique. Une fenêtre fractionnée dynamique est généralement utilisée pour créer et faire défiler plusieurs volets différents, ou vues, du même document. l'infrastructure crée automatiquement un premier volet pour le séparateur ; l'infrastructure crée, redimensionne, et rejette les volets supplémentaires lorsque l'utilisateur fonctionne les contrôles de la fenêtre fractionnée.

Lorsque vous appelez Créer, vous spécifiez une hauteur de ligne et une largeur de colonne minimale qui déterminent si les volets sont trop petites pour être entièrement affichés. Après avoir appelé Créer, vous pouvez adapter ces minimum en appelant les fonctions membres de SetColumnInfo et de SetRowInfo .

Utilisez également les fonctions membres d' SetColumnInfo et d' SetRowInfo pour définir une largeur « idéale » pour une colonne et la hauteur « idéale » pour une ligne. Lorsque l'infrastructure affiche une fenêtre fractionnée, elle affiche d'abord le frame parent, la fenêtre fractionnée. L'infrastructure répertorie les volets dans les lignes et colonnes selon leurs dimensions idéale, l'utilisation du supérieur gauche à l'angle inférieur droit de la zone cliente de la fenêtre fractionnée.

Tous les volets dans une fenêtre fractionnée dynamique doivent être de la même classe. Les applications familières qui prennent en charge les fenêtres fractionnées dynamiques sont Microsoft Word et Microsoft Excel.

Utilisez la fonction membre d' CreateStatic pour créer une fenêtre fractionnée statique. L'utilisateur peut modifier uniquement la taille des volets dans une fenêtre fractionnée statique, non leur numéro ou commande.

Vous devez créer spécifiquement les volets statiques du séparateur lorsque vous créez le séparateur statique. Veillez à créer tous les volets avant que la fonction membre parent d' OnCreateClient du frame retourne, ou infrastructure n'affiche pas la fenêtre correctement.

La fonction membre d' CreateStatic lance automatiquement un séparateur statique avec une hauteur de ligne et une largeur de colonne minimum de 0. Après avoir appelé Créer, ajustez ces minimum en appelant les fonctions membres de SetColumnInfo et de SetRowInfo . Utilisez également SetColumnInfo et SetRowInfo après avoir appelé CreateStatic pour indiquer les dimensions idéale souhaitées de volet.

Les volets différents d'un séparateur statique appartiennent souvent à des classes. Pour obtenir des exemples de fenêtres fractionnées statiques, consultez l'éditeur graphique et le gestionnaire de fichiers windows.

Une fenêtre fractionnée en charge les barres de défilement spéciales (en dehors des barres de défilement que les volets peuvent avoir). Ces barres de défilement sont des enfants de l'objet d' CSplitterWnd et sont partagés avec les volets.

Vous créez ces barres de défilement spéciales lorsque vous créez la fenêtre fractionnée. Par exemple, CSplitterWnd qui a une ligne, deux colonnes, et le style de WS_VSCROLL affichent une barre de défilement verticale partagée par les deux volets. Lorsque l'utilisateur déplace la barre de défilement, les messages d' WM_VSCROLL sont envoyés aux deux volets. Lorsque les volets définissez la position de la barre de défilement, la barre de défilement partagée est définie.

Pour plus d'informations sur des fenêtres fractionnées, consultez :