Partager via


CSplitterWnd, classe

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 :

  1. Incluez une variable membre d' CSplitterWnd dans le frame parent.

  2. Substituez la fonction membre parent de CFrameWnd::OnCreateClient du frame.

  3. 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 :

  • Note technique 29

  • Article de la Base de connaissances Q262024 : HOWTO : utilisation CPropertySheet en tant qu'enfant de CSplitterWnd

Pour plus d'informations sur la création de fenêtres fractionnées dynamiques, consultez :

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CSplitterWnd

Configuration requise

Header: afxext.h

Voir aussi

Référence

CWnd, classe

Graphique de la hiérarchie

CView, classe

CWnd, classe

Concepts

Exemple VIEWEX MFC