CDockablePane, classe

Article
06/10/2015

Implémente un volet qui peut être ancré dans un site d'ancrage ou être inclus dans un volet à onglets.

class CDockablePane : public CPane

Membres

Constructeurs publics

Nom	Description
CDockablePane::CDockablePane	Les éléments et initialise un objet d' CDockablePane .

Méthodes publiques

Nom	Description
CDockablePane::AttachToTabWnd	Joint un volet à un autre volet. Cela crée un volet à onglets.
CDockablePane::CalcFixedLayout	Retourne la taille du rectangle de volet.
CDockablePane::CanAcceptMiniFrame	Détermine si le mini frame spécifié peut être ancré au volet.
CDockablePane::CanAcceptPane	Détermine si un autre volet peut être ancré au volet actif.
CDockablePane::CanAutoHide	Détermine si le prend en charge du volet masquer automatiquement le mode. (Substitutions CBasePane::CanAutoHide.)
CDockablePane::CanBeAttached	Détermine si le volet actuel peut être ancré à un autre volet.
CDockablePane::ConvertToTabbedDocument	Convertit un ou plusieurs volets ancrables aux documents avec onglet MDI.
CDockablePane::CopyState	Copie l'état d'un volet ancrable.
CDockablePane::Create	Crée le contrôle Windows et l'attache à l'objet d' CDockablePane .
CDockablePane::CreateDefaultPaneDivider	Crée un diviseur par défaut du volet à mesure qu'il est ancré à une fenêtre frame.
CDockablePane::CreateEx	Crée le contrôle Windows et l'attache à l'objet d' CDockablePane .
CDockablePane::CreateTabbedPane	Crée un volet à onglets du volet actif.
CDockablePane::DockPaneContainer	Ancre un conteneur au volet.
CDockablePane::DockPaneStandard	Ancre un volet à l'aide de l'ancrage (standard) d'ensemble.
CDockablePane::DockToFrameWindow	Utilisé en interne. Pour ancrer un volet, l'utilisation CPane::DockPane ou un CDockablePane::DockToWindow.
CDockablePane::DockToRecentPos	Ancre un volet à sa position récente stockée d'ancrage.
CDockablePane::DockToWindow	S'ancre un volet d'ancrage à un autre volet d'ancrage.
CDockablePane::EnableAutohideAll	Active ou désactive les masquer automatiquement le mode de ce volet avec d'autres volets dans le conteneur.
CDockablePane::EnableGripper	Affiche ou masque la légende pince ().
CDockablePane::GetAHRestoredRect	Spécifie la position du volet si visible masquer automatiquement dans la vue.
CDockablePane::GetAHSlideMode	Récupère le mode automatique de diapositive de masquage du volet.
CDockablePane::GetAutoHideButton	Utilisé en interne.
CDockablePane::GetAutoHideToolBar	Utilisé en interne.
CDockablePane::GetCaptionHeight	Retourne la hauteur de la légende active.
CDockablePane::GetDefaultPaneDivider	Retourne le diviseur par défaut du volet pour le conteneur du volet.
CDockablePane::GetDockingStatus	Détermine la capacité d'un volet d'être ancré en fonction de l'emplacement fourni de pointeur.
CDockablePane::GetDragSensitivity	Retourne le critère de distribution de glisser-déplacer d'un volet d'ancrage.
CDockablePane::GetLastPercentInPaneContainer	Récupère le pourcentage d'espace qu'un volet occupe dans son conteneur.
CDockablePane::GetTabArea	Extrait la zone d'onglet du volet.
CDockablePane::GetTabbedPaneRTC	Retourne les informations de classe d'exécution sur une fenêtre avec onglets qui est créé lorsqu'un autre volet s'ancre au volet actif.
CDockablePane::HasAutoHideMode	Spécifie si à un volet d'ancrage peut être basculé masquer automatiquement le mode.
CDockablePane::HitTest	Spécifie l'emplacement spécifique dans un volet lorsque l'utilisateur clique sur une souris.
CDockablePane::IsAccessibilityCompatible	Utilisé en interne.
CDockablePane::IsAutohideAllEnabled	Indique si le volet d'ancrage et tous les autres volets dans le conteneur peuvent être placés dans masquer automatiquement le mode.
CDockablePane::IsAutoHideMode	Détermine si un volet est masquer automatiquement dans la vue.
CDockablePane::IsChangeState	Utilisé en interne.
CDockablePane::IsDocked	Détermine si le volet actif est ancré.
CDockablePane::IsHideInAutoHideMode	Détermine le comportement d'un volet qui est masquer automatiquement dans le mode s'il est affiché ou masqué () en appelant ShowPane.
CDockablePane::IsInFloatingMultiPaneFrameWnd	Spécifie si le volet est dans une fenêtre frame de plusieurs volet.
CDockablePane::IsResizable	Spécifie si le volet est redimensionnable.
CDockablePane::IsTabLocationBottom	Spécifie si les onglets sont situés en haut ou en bas du volet.
CDockablePane::IsTracked	Spécifie si un volet est déplacé par l'utilisateur.
CDockablePane::IsVisible	Détermine si le volet actif est visible.
CDockablePane::LoadState	Utilisé en interne.
CDockablePane::OnAfterChangeParent	Appelé par l'infrastructure lorsque le parent d'un volet a changé. (Substitutions CPane::OnAfterChangeParent.)
CDockablePane::OnAfterDockFromMiniFrame	Appelé par l'infrastructure lorsqu'une barre flottante d'ancrage s'ancre à une fenêtre frame.
CDockablePane::OnBeforeChangeParent	Appelé par l'infrastructure lorsque le parent du volet est sur le point de modifier. (Substitutions CPane::OnBeforeChangeParent.)
CDockablePane::OnBeforeFloat	Appelé par l'infrastructure lorsqu'un volet est sur le point de flotter. (Substitutions CPane::OnBeforeFloat.)
CDockablePane::RemoveFromDefaultPaneDividier	L'infrastructure appelle cette méthode lorsqu'un volet est détaché.
CDockablePane::ReplacePane	Remplace le volet avec un volet spécifié.
CDockablePane::RestoreDefaultPaneDivider	L'infrastructure appelle cette méthode comme un volet est désérialisé pour restaurer le diviseur par défaut de volet.
CDockablePane::SaveState	Utilisé en interne.
CDockablePane::Serialize	Sérialise le volet. (Substitutions CBasePane::Serialize.)
CDockablePane::SetAutoHideMode	Bascule le volet d'ancrage entre visible et masque automatiquement le mode.
CDockablePane::SetAutoHideParents	Définit le bouton de masquer automatiquement et masque automatiquement la barre d'outils du volet.
CDockablePane::SetDefaultPaneDivider	Utilisé en interne.
CDockablePane::SetLastPercentInPaneContainer	Définit le pourcentage d'espace qu'un volet occupe dans son conteneur.
CDockablePane::SetResizeMode	Utilisé en interne.
CDockablePane::SetRestoredDefaultPaneDivider	Définit le diviseur par défaut restauré de volet.
CDockablePane::SetTabbedPaneRTC	Définit les informations de classe d'exécution d'une fenêtre avec onglets qui est créée lorsque deux volets les accueillent ensemble.
CDockablePane::ShowPane	Affiche ou masque le volet.
CDockablePane::Slide	Affiche ou masque le volet avec une animation de faire glisser ce qui affiche uniquement lorsque le volet est masquer automatiquement dans la vue.
CDockablePane::ToggleAutoHide	Les bascule masquer automatiquement le mode. (Substitutions CPane::ToggleAutoHide .)
CDockablePane::UndockPane	Détache un volet de la fenêtre frame principale ou d'un conteneur de fenêtre mini-frame.
CDockablePane::UnSetAutoHideMode	Utilisé en interne. Pour définir le mode de masquer automatiquement, utilisez CDockablePane::SetAutoHideMode

Méthodes protégées

Nom	Description
CDockablePane::CheckAutoHideCondition	Détermine si le volet d'ancrage est masqué (en masquer automatiquement le mode).
CDockablePane::CheckStopSlideCondition	Détermine si un volet d'ancrage de masquer automatiquement doit cesser de glisser.
CDockablePane::DrawCaption	Dessine la légende du volet d'ancrage pince ().
CDockablePane::OnPressButtons	Appelé lorsque l'utilisateur appuie sur un bouton de légende autre que les boutons d' AFX_HTCLOSE et d' AFX_HTMAXBUTTON .
CDockablePane::OnSlide	Appelé par l'infrastructure pour afficher l'effet de diapositive de masquer automatiquement lorsque le volet est affiché ou masqué.

Membres de données

Nom	Description
CDockablePane::m_bDisableAnimation	Spécifie si masquer automatiquement l'animation du volet ancrable est désactivé.
CDockablePane::m_bHideInAutoHideMode	Détermine le comportement du volet lorsque le volet est masquer automatiquement dans la vue.
CDockablePane::m_nSlideSteps	Spécifie la vitesse d'animation du volet lorsqu'il est affiché ou masqué lorsque masquer automatiquement dans la vue.

Notes

CDockablePane implémente les fonctionnalités suivantes :

Ancrer un volet à une fenêtre frame principale.
En basculant un volet à masquer automatiquement le mode.
Liaison d'un volet à une fenêtre avec onglets.
Flottant d'un volet dans une fenêtre mini-frame.
Un volet d'ancrage à un autre volet flottant qui est dans une fenêtre mini-frame.
Redimensionner un volet.
État de chargement et d'enregistrement pour un volet d'ancrage.

Notes

Les informations d'état sont enregistrés dans le Registre Windows.
Créer un volet avec ou sans légende. La légende peut avoir une étiquette de texte et elle peut être remplie avec une couleur de dégradé.
Faire glisser un volet en affichant le contenu du volet
Faire glisser un volet en affichant un rectangle de glisser-déplacer.

Pour utiliser un volet d'ancrage dans votre application, dérivez votre classe de volet de la classe d' CDockablePane . Incluez l'objet dérivé dans l'objet de fenêtre frame principale ou dans un objet window qui contrôle l'instance de votre volet. Appelez la méthode de CDockablePane::Create ou la méthode de CDockablePane::CreateEx lorsque vous utilisez le message d' WM_CREATE dans la fenêtre frame principale. Enfin, installez l'objet de volet en appelant CBasePane::EnableDocking, CBasePane::DockPane, ou CDockablePane::AttachToTabWnd.

Conseils de personnalisation

Les conseils suivants s'appliquent à CDockablePane des objets :

Si vous appelez CDockablePane::AttachToTabWnd pour les deux volets avec onglets et non ancrables, un pointeur vers une fenêtre avec onglets est retourné dans le paramètre d' ppTabbedControlBar . Vous pouvez continuer à ajouter des onglets à la fenêtre à onglets à l'aide de ce paramètre.
Le type de volet à onglets qui est créé par CDockablePane::AttachToTabWnd est déterminé par l'objet d' CDockablePane dans le paramètre d' pTabControlBarAttachTo . Vous pouvez appeler CDockablePane::SetTabbedPaneRTC pour définir le type de volet à onglets qu' CDockablePane crée. Le type par défaut est déterminé par dwTabbedStyle de CDockablePane::Create lorsque vous commencez CDockablePane. Si dwTabbedStyle est AFX_CBRS_OUTLOOK_TABS le type par défaut est CMFCOutlookBar, classe; si dwTabbedStyle est AFX_CBRS_REGULAR_TABS le type par défaut est CTabbedPane, classe.
Si vous souhaitez ancrer un volet ancrable à un autre, appelez la méthode de CDockablePane::DockToWindow . Le volet d'origine doit être ancré à un endroit avant d'appeler cette méthode.
Les contrôles de CDockablePane::m_bHideInAutoHideMode de variable membre comment les volets ancrables se comportent en mode de fonction masquer automatiquement lorsque vous appelez CDockablePane::ShowPane. Si cette variable membre est définie à TRUE, les volets ancrables et les boutons automatiques de masquer sont masqués. Sinon, ils glisseront dans et.
Vous pouvez désactiver masquer automatiquement l'animation en définissant la variable membre de CDockablePane::m_bDisableAnimation à TRUE.

Exemple

L'exemple suivant montre comment configurer un objet d' CDockablePane en utilisant différentes méthodes dans la classe d' CDockablePane . L'exemple montre comment activer le masquer automatiquement toutes les fonctionnalités du volet ancrable, activer la légende ou la pince, activer le mode de masquer automatiquement, afficher le volet, et animer un volet qui est dans masquer automatiquement le mode. Cet extrait de code fait partie d' Exemple de démonstration de Visual Studio.

 // GetOwner is an inherited method.
    CDockablePane* pParentBar = DYNAMIC_DOWNCAST(CDockablePane, GetOwner());


...


        pParentBar->EnableAutohideAll();
        pParentBar->EnableGripper(true);
        pParentBar->SetAutoHideMode(true, CBRS_ALIGN_LEFT);
        pParentBar->ShowPane(true,false,true);
        pParentBar->Slide(true);