CBasePane, classe

Article
06/10/2015

Classe de base pour tous les volets dans MFC.

class CBasePane : public CWnd

Membres

Constructeurs publics

Nom	Description
CBasePane::CBasePane	Constructeur par défaut.
CBasePane::~CBasePane	Destructor.

Méthodes publiques

Nom	Description
CBasePane::accHitTest	Appelé par l'infrastructure pour récupérer l'élément enfant ou l'objet enfant à un point donné sur l'écran. (Substitutions CWnd::accHitTest.)
CBasePane::accLocation	Appelé par l'infrastructure pour récupérer l'emplacement actuel d'écran pour l'objet spécifié. (Substitutions CWnd::accLocation.)
CBasePane::AccNotifyObjectFocusEvent	CBasePane n'utilise pas cette méthode.
CBasePane::accSelect	Appelé par l'infrastructure pour modifier la sélection ou pour déplacer le focus clavier de l'objet spécifié. (Substitutions CWnd::accSelect.)
CBasePane::AddPane	Ajoute un volet au gestionnaire d'ancrage.
CBasePane::AdjustDockingLayout	Effectue un appel au gestionnaire d'ancrage pour ajuster la disposition d'ancrage.
CBasePane::AdjustLayout	Appelé par l'infrastructure lorsque le volet doit régler sa disposition interne.
CBasePane::CalcFixedLayout	Calcule la taille horizontale d'une barre de contrôles.
CBasePane::CanAcceptPane	Détermine si un autre volet peut être ancré au volet.
CBasePane::CanAutoHide	Détermine si le prend en charge du volet masquer automatiquement le mode.
CBasePane::CanBeAttached	Détermine si le volet peut être ancré à un autre volet.
CBasePane::CanBeClosed	Détermine si le volet peut être fermé.
CBasePane::CanBeDocked	Détermine si le volet peut être ancré à un autre volet.
CBasePane::CanBeResized	Détermine si le volet peut être redimensionné.
CBasePane::CanBeTabbedDocument	Spécifie si le volet peut être converti en un document avec onglets MDI.
CBasePane::CanFloat	Détermine si le volet flottant peut.
CBasePane::CanFocus	Spécifie si le volet peut recevoir le focus.
CBasePane::CopyState	Copie l'état d'un volet donné.
CBasePane::CreateDefaultMiniframe	Si le volet flottant peut, crée une fenêtre mini-frame.
CBasePane::CreateEx	Crée le contrôle de volet.
CBasePane::DockPane	Ancre un volet à un autre volet ou à une fenêtre frame.
CBasePane::DockPaneUsingRTTI	Ancre le volet à l'aide de les informations de type au moment de l'exécution.
CBasePane::DockToFrameWindow	Ancre un volet ancrable à un frame.
CBasePane::DoesAllowDynInsertBefore	Détermine si un autre volet peut être dynamiquement inséré entre ce volet et le frame parent.
CBasePane::EnableDocking	Active l'ancrage du volet au frame principal.
CBasePane::EnableGripper	Active ou désactive la pince. Si la pince est activée, l'utilisateur peut le faire glisser de repositionner le volet.
CBasePane::FillWindowRect	Utilisé en interne.
CBasePane::FloatPane	Flotte le volet.
CBasePane::get_accChild	Appelé par l'infrastructure pour récupérer l'adresse d'une interface d' IDispatch pour l'enfant spécifié. (Substitutions CWnd::get_accChild.)
CBasePane::get_accChildCount	Appelé par l'infrastructure pour récupérer le nombre d'enfants qui appartiennent à cet objet. (Substitutions CWnd::get_accChildCount.)
CBasePane::get_accDefaultAction	Appelé par l'infrastructure pour récupérer une chaîne qui décrit l'action par défaut pour l'objet. (Substitutions CWnd::get_accDefaultAction.)
CBasePane::get_accDescription	Appelé par l'infrastructure pour récupérer une chaîne qui décrit l'apparence visuelle de l'objet spécifié. (Substitutions CWnd::get_accDescription.)
CBasePane::get_accFocus	Appelé par l'infrastructure pour récupérer l'objet qui a le focus clavier. (Substitutions CWnd::get_accFocus.)
CBasePane::get_accHelp	Appelé par l'infrastructure pour récupérer une chaîne help de propriété pour l'objet. (Substitutions CWnd::get_accHelp.)
CBasePane::get_accHelpTopic	Appelé par l'infrastructure pour récupérer le chemin d'accès complet duWinHelpfile associé à l'objet spécifié et l'identificateur de la rubrique appropriée dans ce fichier. (Substitutions CWnd::get_accHelpTopic.)
CBasePane::get_accKeyboardShortcut	Appelé par l'infrastructure pour récupérer la touche de raccourci spécifiée pour l'objet. (Substitutions CWnd::get_accKeyboardShortcut.)
CBasePane::get_accName	Appelé par l'infrastructure pour extraire le nom de l'objet spécifié. (Substitutions CWnd::get_accName.)
CBasePane::get_accParent	Appelé par l'infrastructure pour récupérer l'interface d' IDispatch pour le parent de l'objet. (Substitutions CWnd::get_accParent.)
CBasePane::get_accRole	Appelé par l'infrastructure pour récupérer des informations qui décrivent le rôle de l'objet spécifié. (Substitutions CWnd::get_accRole.)
CBasePane::get_accSelection	Appelé par l'infrastructure pour récupérer les enfants sélectionnés de faire objet. (Substitutions CWnd::get_accSelection.)
CBasePane::get_accState	Appelé par l'infrastructure pour récupérer l'état actuel de l'objet spécifié. (Substitutions CWnd::get_accState.)
CBasePane::get_accValue	Appelé par l'infrastructure pour récupérer la valeur de l'objet spécifié. (Substitutions CWnd::get_accValue.)
CBasePane::GetCaptionHeight	Retourne la hauteur de légende.
CBasePane::GetControlBarStyle	Retourne le style de barres de contrôles.
CBasePane::GetCurrentAlignment	Retourne l'alignement actuel de volet.
CBasePane::GetDockingMode	Retourne l'état actuel d'ancrage de le volet.
CBasePane::GetDockSiteFrameWnd	Retourne un pointeur vers la fenêtre qui est le site d'ancrage du volet.
CBasePane::GetEnabledAlignment	Retourne les styles de CBRS_ALIGN_ appliqués au volet.
CBasePane::GetMFCStyle	Retourne les styles de volet propres à MFC.
CBasePane::GetPaneIcon	Retourne un handle vers l'icône de volet.
CBasePane::GetPaneRect	Utilisé en interne.
CBasePane::GetPaneRow	Retourne un pointeur vers l'objet de CDockingPanesRowoù le volet est ancré.
CBasePane::GetPaneStyle	Retourne le style de volet.
CBasePane::GetParentDockSite	Retourne un pointeur vers le site parent d'ancrage.
CBasePane::GetParentMiniFrame	Retourne un pointeur vers la fenêtre mini-frame parente.
CBasePane::GetParentTabbedPane	Retourne un pointeur vers le volet à onglets parent.
CBasePane::GetParentTabWnd	Retourne un pointeur vers la fenêtre parente qui est à l'intérieur d'une table.
CBasePane::GetRecentVisibleState	L'infrastructure appelle cette méthode lorsqu'un volet est restauré d'une archive.
CBasePane::HideInPrintPreviewMode	Spécifie si le volet est masqué dans l'aperçu avant impression.
CBasePane::InsertPane	Stocke le volet spécifié par le gestionnaire d'ancrage.
CBasePane::IsAccessibilityCompatible	Spécifie si le volet prend en charge Active accessibilité.
CBasePane::IsAutoHideMode	Détermine si un volet est masquer automatiquement dans la vue.
CBasePane::IsDialogControl	Spécifie si le volet est un contrôle de boîte de dialogue.
CBasePane::IsDocked	Détermine si le volet est ancré.
CBasePane::IsFloating	Détermine si le volet flottant est.
CBasePane::IsHorizontal	Détermine si le volet est ancré horizontalement.
CBasePane::IsInFloatingMultiPaneFrameWnd	Spécifie si le volet est dans une fenêtre frame de plusieurs volet.
CBasePane::IsMDITabbed	Détermine si le volet a été ajouté à une fenêtre MDI enfant comme document avec onglets.
CBasePane::IsPaneVisible	Spécifie si la balise d' WS_VISIBLE est définie pour le volet.
CBasePane::IsPointNearDockSite	Détermine si un point spécifié est vers le site d'ancrage.
CBasePane::IsResizable	Détermine si le volet peut être redimensionné.
CBasePane::IsRestoredFromRegistry	Détermine si le volet est restauré du Registre.
CBasePane::IsTabbed	Détermine si le volet a été inséré dans le contrôle onglet d'une fenêtre avec onglets.
CBasePane::IsTooltipTopmost	Utilisé en interne.
CBasePane::IsVisible	Détermine si le volet est visible.
CBasePane::LoadState	Charge l'état du volet du Registre.
CBasePane::MoveWindow	Déplace le volet.
CBasePane::OnAfterChangeParent	Appelé par l'infrastructure lorsque le parent du volet a été modifié.
CBasePane::OnBeforeChangeParent	Appelé par l'infrastructure juste avant le volet modifie sa fenêtre parente.
CBasePane::OnDrawCaption	L'infrastructure appelle cette méthode lorsque la légende est dessinée.
CBasePane::OnMovePaneDivider	Cette méthode n'est pas actuellement utilisée.
CBasePane::OnPaneContextMenu	Appelé par l'infrastructure lorsqu'il génère un menu qui contient une liste des volets.
CBasePane::OnRemoveFromMiniFrame	Appelé par l'infrastructure lorsqu'un volet est supprimé de sa mini fenêtre frame parente.
CBasePane::OnSetAccData	CBasePane n'utilise pas cette méthode.
CBasePane::OnUpdateCmdUI	Utilisé en interne.
CBasePane::PaneFromPoint	Retourne le volet qui contient le point donné.
CBasePane::PreTranslateMessage	Utilisé par la classe CWinApp pour convertir des messages de fenêtre pour qu'ils soient distribués aux fonctions Windows de TranslateMessage et de DispatchMessage . (Substitutions CWnd::PreTranslateMessage.)
CBasePane::RecalcLayout	CBasePane n'utilise pas cette méthode.
CBasePane::RemovePaneFromDockManager	Annule l'inscription d'un volet et le supprimer de la liste dans le gestionnaire d'ancrage.
CBasePane::SaveState	Enregistre l'état du volet au Registre.
CBasePane::SelectDefaultFont	Sélectionne la police par défaut pour un contexte donné de périphérique.
CBasePane::Serialize	Lit ou écrit cet objet ou y retourne une archive. (Substitutions CObject::Serialize.)
CBasePane::SetControlBarStyle	Définit le style de barres de contrôles.
CBasePane::SetDockingMode	Définit le mode d'ancrage de le volet.
CBasePane::SetMDITabbed	Utilisé en interne.
CBasePane::SetPaneAlignment	Définit l'alignement du volet.
CBasePane::SetPaneRect	Utilisé en interne.
CBasePane::SetPaneStyle	Définit le style du volet.
CBasePane::SetRestoredFromRegistry	Utilisé en interne.
CBasePane::SetWindowPos	Modifie la taille, la position, et l'ordre de plan d'un volet.
CBasePane::ShowPane	Affiche ou masque le volet.
CBasePane::StretchPane	Étire un volet verticalement ou horizontalement.
CBasePane::UndockPane	Supprime le volet du site d'ancrage, du curseur par défaut, ou de la fenêtre mini-frame où il est actuellement ancré.

Méthodes protégées

Nom	Description
CBasePane::DoPaint	Remplit l'arrière-plan du volet.

Notes

Si vous souhaitez créer une classe de volet qui prend en charge les fonctionnalités étendues d'ancrage disponibles dans MFC, vous devez le dériver d' CBasePane ou de CPane, classe.

Conseils de personnalisation

Les conseils de personnalisation suivantes concernent CBasePane, classe et les classes qui héritent de celui-ci :

Lorsque vous créez un volet, vous pouvez appliquer plusieurs nouveaux styles :
- AFX_CBRS_FLOAT fait le volet flottant.
- AFX_CBRS_AUTOHIDE active masquer automatiquement le mode.
- AFX_CBRS_CLOSE permet au volet d'être fermé (masqué).
Ce sont des balises que vous pouvez associer avec une opération de bits OR.

CBasePane implémente les méthodes virtuelles booléennes suivantes pour refléter ces balises : CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat. Vous pouvez les substituer dans les classes dérivées de personnaliser leur comportement.
Vous pouvez personnaliser le comportement d'ancrage en substituant CBasePane::CanAcceptPane. Ayez le retour FALSE de volet de cette méthode pour empêcher un autre volet d'ancrage lui.
Si vous souhaitez créer un volet statique qui ne peut pas flottant et qui empêché tout autre volet d'ancrage avant lui (similaire à la barre Outlook dans l'exemple OutlookDemo), créez- le comme non flottant et remplacez CBasePane::DoesAllowDynInsertBefore pour retourner FALSE. L'implémentation par défaut retourne FALSE si le volet est créé sans style d' AFX_CBRS_FLOAT .
Créez tous les volets avec des identificateurs autres que -1.
Pour déterminer la visibilité de volet, utilisez CBasePane::IsVisible. Il gère correctement l'état de visibilité dans l'onglet et masque automatiquement les modes.
Si vous souhaitez créer un volet redimensionnable non flottant, créez- le sans style d' AFX_CBRS_FLOAT et appelez CFrameWnd::DockControlBar.
Pour exclure un volet d'une disposition d'ancrage ou supprimer une barre d'outils de sa barre d'ancrage, appelez CBasePane::UndockPane. N'appelez pas cette méthode pour les volets masquer automatiquement dans l'état ou pour les volets qui résident dans les onglets windows à onglet.
Si vous souhaitez flottant ou détacher un volet qui est dans masquer automatiquement le mode, vous devez appeler CDockablePane::SetAutoHideMode avec FALSE que le premier argument avant d'appeler CBasePane::FloatPane ou CBasePane::UndockPane.

Exemple

L'exemple suivant montre comment utiliser différentes méthodes dans la classe d' CBasePane . L'exemple montre comment récupérer un volet de la classe d' CFrameWndEx et comment définir le mode d'ancrage, l'alignement de volet, et le style de volet. Le code est d' Exemple de protection de Word.

         // This CMainFrame class extends the CFrameWndEx class. 
            // GetPane is a method in the CFrameWndEx class which  
            // Returns a pointer to the pane that has the specified ID.
            CBasePane* pBar = GetPane(ID_VIEW_FORMATBAR);
            if (pBar != NULL)
            {
                // Set the docking mode, the pane alignment, and the pane style.
                pBar->SetDockingMode(DT_STANDARD);
                pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
                pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
                pBar->ShowPane(TRUE, FALSE, FALSE);
            }