Classe de CDockingManager

Article
03/26/2013

Implémente la fonctionnalité principale qui contrôle la disposition d'ancrage dans une fenêtre frame principale.

class CDockingManager : public CObject

Membres

Méthodes publiques

Nom	Description
CDockingManager::AddDockSite	Crée un volet d'ancrage et l'ajoute à la liste des barres de contrôles.
CDockingManager::AddHiddenMDITabbedBar	Ajoute un handle d'un volet de barre à la liste des volets de barre tabulés masqués par MDI.
CDockingManager::AddMiniFrame	Ajoute un frame à la liste de mini frames.
CDockingManager::AddPane	Enregistre un volet avec le gestionnaire d'ancrage.
CDockingManager::AdjustDockingLayout	Recalcule et ajuste la disposition de tous les volets dans une fenêtre frame.
CDockingManager::AdjustPaneFrames	Entraîne l'affichage du message d' WM_NCCALCSIZE d'être envoyé à tous les volets et fenêtres d' CPaneFrameWnd .
CDockingManager::AdjustRectToClientArea	Règle l'alignement d'un rectangle.
CDockingManager::AlignAutoHidePane	Redimensionne un volet d'ancrage masquer automatiquement dans la vue afin qu'il prenne la largeur ou la hauteur de la zone cliente du frame délimitée par des sites d'ancrage.
CDockingManager::AutoHidePane	Crée une barre d'outils de masquer automatiquement.
CDockingManager::BringBarsToTop	Apporte les barres ancrées qui ont l'alignement spécifié en haut.
CDockingManager::BuildPanesMenu	Ajoute des noms des volets d'ancrage et des barres d'outils à un menu.
CDockingManager::CalcExpectedDockedRect	Calcule le rectangle attendu d'une fenêtre ancrée.
CDockingManager::Create	Crée un gestionnaire d'ancrage.
CDockingManager::DeterminePaneAndStatus	Détermine le volet qui contient un point donné et son mode d'ancrage.
CDockingManager::DisableRestoreDockState	Active ou désactive le chargement de la disposition d'ancrage du Registre.
CDockingManager::DockPane	Ancre un volet à un autre volet ou à une fenêtre frame.
CDockingManager::DockPaneLeftOf	Ancre un volet gauche d'un autre volet.
CDockingManager::EnableAutoHidePanes	Active l'ancrage du volet au frame principal, crée un volet d'ancrage, et l'ajoute à la liste des barres de contrôles.
CDockingManager::EnableDocking	Crée un volet d'ancrage et permet l'ancrage du volet au frame principal.
CDockingManager::EnableDockSiteMenu	Affiche un bouton supplémentaire qui ouvre un menu contextuel sur les légendes de tous les volets d'ancrage.
CDockingManager::EnablePaneContextMenu	Indique la bibliothèque pour afficher un menu contextuel spécial qui a une liste des barres d'outils et de volets d'ancrage d'application lorsque l'utilisateur clique sur le bouton droit de la souris et la bibliothèque traite le message de WM_CONTEXTMENU.
CDockingManager::FindDockSite	Récupère le volet de barre qui est à la position spécifiée et qui a l'alignement spécifié.
CDockingManager::FindDockSiteByPane	Retourne le volet de barre qui a l'identificateur du volet cible de barre.
CDockingManager::FindPaneByID	Recherche un volet spécifiée par l'ID de contrôle
CDockingManager::FixupVirtualRects	Investit toutes les positions actuelles de barre d'outils à des rectangles virtuels.
CDockingManager::FrameFromPoint	Retourne le frame qui contient le point donné.
CDockingManager::GetClientAreaBounds	Obtient le rectangle qui contient les limites de la zone cliente.
CDockingManager::GetDockingMode	Retourne l'état actuel d'ancrage.
CDockingManager::GetDockSiteFrameWnd	Obtient un pointeur vers le frame de fenêtre parent.
CDockingManager::GetEnabledAutoHideAlignment	Retourne l'alignement activé les volets.
CDockingManager::GetMiniFrames	Obtient une liste de miniframes.
CDockingManager::GetOuterEdgeBounds	Obtient un rectangle qui contient les bords externes du frame.
CDockingManager::GetPaneList	Retourne une liste des volets qui appartiennent au gestionnaire d'ancrage.Cela inclut tous les volets flottants.
CDockingManager::GetSmartDockingManager	Extrait un pointeur intelligent au gestionnaire d'ancrage.
CDockingManager::GetSmartDockingManagerPermanent	Extrait un pointeur intelligent au gestionnaire d'ancrage.
CDockingManager::GetSmartDockingParams	Retourne les paramètres intelligents d'ancrage de le gestionnaire d'ancrage.
CDockingManager::GetSmartDockingTheme	Une méthode statique qui retourne un thème utilisé pour afficher le intelligentes d'ancrage.
CDockingManager::HideAutoHidePanes	Masque un volet qui est masquer automatiquement dans la vue.
CDockingManager::InsertDockSite	Crée un volet d'ancrage et l'insère dans la liste des barres de contrôles.
CDockingManager::InsertPane	Insère un volet de contrôle dans la liste des barres de contrôles.
CDockingManager::IsDockSiteMenu	Spécifie si un menu contextuel s'affiche sur les légendes de tous les volets.
CDockingManager::IsInAdjustLayout	Détermine si les dispositions de tous les volets sont définies.
CDockingManager::IsOLEContainerMode	Spécifie si le gestionnaire d'ancrage est en mode de conteneur OLE.
CDockingManager::IsPointNearDockSite	Détermine si un point spécifié est vers le site d'ancrage.
CDockingManager::IsPrintPreviewValid	Détermine si le mode aperçu avant impression est défini.
CDockingManager::LoadState	Charge l'état du gestionnaire d'ancrage du Registre.
CDockingManager::LockUpdate	Verrouille la fenêtre donnée.
CDockingManager::OnActivateFrame	Appelé par l'infrastructure lorsque la fenêtre frame est rendue active ou est désactivée.
CDockingManager::OnClosePopupMenu	Appelé par l'infrastructure lorsqu'un menu contextuel actif traite un message de WM_DESTROY.
CDockingManager::OnMoveMiniFrame	Appelé par l'infrastructure pour déplacer une fenêtre mini-frame.
CDockingManager::OnPaneContextMenu	Appelé par l'infrastructure lorsqu'il génère un menu qui contient une liste des volets.
CDockingManager::PaneFromPoint	Retourne le volet qui contient le point donné.
CDockingManager::ProcessPaneContextMenuCommand	Appelé par l'infrastructure pour activer ou désactiver une case à cocher de la commande spécifiée et à recalculer la disposition d'un volet indiqué.
CDockingManager::RecalcLayout	Recalcule la disposition interne des contrôles présents dans la liste de contrôles.
CDockingManager::ReleaseEmptyPaneContainers	Libère les conteneurs vides de volet.
CDockingManager::RemoveHiddenMDITabbedBar	Supprime le volet masqué spécifié de barre.
CDockingManager::RemoveMiniFrame	Supprime un frame spécifié dans la liste de mini frames.
CDockingManager::RemovePaneFromDockManager	Annule l'inscription d'un volet et le supprimer de la liste dans le gestionnaire d'ancrage.
CDockingManager::ReplacePane	Remplace un volet par un autre.
CDockingManager::ResortMiniFramesForZOrder	Recourt les frames dans la liste de mini frames.
CDockingManager::SaveState	Enregistre l'état du gestionnaire d'ancrage au Registre.
CDockingManager::SendMessageToMiniFrames	Envoie le message spécifié à tous les frames mini.
CDockingManager::Serialize	Écrit le gestionnaire d'ancrage à une archive.(Substitutions CObject::Serialize.)
CDockingManager::SetAutohideZOrder	Définit la taille, la largeur, la hauteur des barres de contrôles et du volet spécifié.
CDockingManager::SetDockingMode	Définit le mode d'ancrage.
CDockingManager::SetDockState	Définit l'état d'ancrage les barres de contrôles, des mini frames, et les barres de masquer automatiquement.
CDockingManager::SetPrintPreviewMode	Définit le mode aperçu avant impression des barres qui s'affichent dans l'aperçu avant impression.
CDockingManager::SetSmartDockingParams	Définit les paramètres qui définissent le comportement de l'ancrage intelligent.
CDockingManager::ShowDelayShowMiniFrames	Affiche ou masque les fenêtres des frames mini.
CDockingManager::ShowPanes	Affiche ou masque les volets du contrôle et masquer automatiquement des barres.
CDockingManager::StartSDocking	Démarre l'ancrage intelligent de la fenêtre spécifiée en fonction de l'alignement BITS du gestionnaire d'ancrage.
CDockingManager::StopSDocking	Arrête l'ancrage intelligent.

Membres de données

Nom	Description
CDockingManager::m_bHideDockingBarsInContainerMode	Spécifie si le gestionnaire d'ancrage masque les volets en mode de conteneur OLE.
CDockingManager::m_dockModeGlobal	Spécifie le mode global d'ancrage.
CDockingManager::m_nDockSensitivity	Spécifie le critère de distribution d'ancrage.
CDockingManager::m_nTimeOutBeforeDockingBarDock	Spécifie la durée, en millisecondes, avant qu'un volet d'ancrage est ancré en mode immédiat d'ancrage.
CDockingManager::m_nTimeOutBeforeToolBarDock	Spécifie la durée, en millisecondes, avant qu'une barre d'outils est ancrée à la fenêtre frame principale.

Notes

La fenêtre frame principale crée et initialise cette classe automatiquement.

L'objet de gestionnaire d'ancrage contient une liste de tous les volets qui sont dans la disposition d'ancrage, et également une liste de toutes les fenêtres de CPaneFrameWnd qui appartiennent à la fenêtre frame principale.

La classe d' CDockingManager implémente des services que vous pouvez utiliser pour rechercher un volet ou une fenêtre d' CPaneFrameWnd .Vous généralement n'appelez pas ces services directement car ils sont encapsulés dans l'objet de fenêtre frame principale.Pour plus d'informations, consultez Classe de CPaneFrameWnd.

Conseils de personnalisation

Les conseils suivants s'appliquent à CDockingManager des objets :

Classe de CDockingManager prend en charge ces modes d'ancrage :
- AFX_DOCK_TYPE::DT_IMMEDIATE
- AFX_DOCK_TYPE::DT_STANDARD
- AFX_DOCK_TYPE::DT_SMART
Ces modes d'ancrage sont définis par CDockingManager::m_dockModeGlobal et sont définis en appelant CDockingManager::SetDockingMode.
Si vous souhaitez créer un volet flottant et non pas redimensionnable, appelez la méthode de CDockingManager::AddPane .Cette méthode signale le volet du gestionnaire d'ancrage, qui est responsable de la disposition du volet.

Exemple

L'exemple suivant montre comment utiliser différentes méthodes dans la classe d' CDockingManager pour configurer un objet d' CDockingManager .L'exemple indique comment afficher un bouton supplémentaire qui ouvre un menu contextuel sur les légendes de tous les volets d'ancrage et comment définir le mode d'ancrage de l'objet.Cet extrait de code fait partie d' Exemple de démonstration de Visual Studio.

    CDockingManager* pDockManager = GetDockingManager();
    ASSERT_VALID(pDockManager);
    pDockManager->AdjustPaneFrames();
    pDockManager->EnableDockSiteMenu();
    pDockManager->SetDockingMode(DT_STANDARD);