CAutoHideDockSite, classe

L’extension CAutoHideDockSite de la classe CDockSite pour implémenter des volets d’ancrage de masquage automatique.

Syntaxe

class CAutoHideDockSite : public CDockSite

Membres

Constructeurs publics

Nom	Description
Nom	Description
CAutoHideDockSite::CAutoHideDockSite	Construit un objet CAutoHideDockSite.
CAutoHideDockSite::~CAutoHideDockSite	Destructeur.

Méthodes publiques

Nom	Description
Nom	Description
CAutoHideDockSite::AllowShowOnPaneMenu	Indique si la valeur CAutoHideDockSite est affichée dans le menu du volet.
CAutoHideDockSite ::CanAcceptPane	Détermine si un objet de volet de base est dérivé de la classe CMFCAutoHideBar.
CAutoHideDockSite ::D ockPane	Ancre un volet sur cet CAuotHideDockSite objet.
CAutoHideDockSite ::GetAlignRect	Récupère la taille du site d’ancrage en coordonnées d’écran.
CAutoHideDockSite ::RepositionPanes	Redessine le volet avec CAutoHideDockSite les marges globales et l’espacement des boutons.
CAutoHideDockSite ::SetOffsetLeft	Définit la marge sur le côté gauche de la barre d’ancrage.
CAutoHideDockSite ::SetOffsetRight	Définit la marge sur le côté droit de la barre d’ancrage.
CAutoHideDockSite ::UnSetAutoHideMode	Appelle CMFCAutoHideBar ::UnSetAutoHideMode pour les objets sur le CAutoHideDockSite.

Données membres

Nom	Description
Nom	Description
CAutoHideDockSite ::m_nExtraSpace	Définit la taille de l’espace entre les barres d’outils et le bord de la barre d’ancrage. Cet espace est mesuré à partir du bord gauche ou du bord supérieur, en fonction de l’alignement de l’espace d’ancrage.

Notes

Lorsque vous appelez CFrameWndEx ::EnableAutoHidePanes, l’infrastructure crée automatiquement un CAutoHideDockSite objet. Dans la plupart des cas, vous ne devez pas avoir à instancier ou utiliser cette classe directement.

La barre d’ancrage est l’écart entre le côté gauche du volet d’ancrage et le côté gauche de la classe CMFCAutoHideButton.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CBasePane

CDockSite

Exemple

L’exemple suivant montre comment récupérer un CAutoHideDockSite objet à partir d’un CMFCAutoHideBar objet et comment définir les marges gauche et droite de la barre d’ancrage.

CAutoHideDockSite *pParentDockBar = DYNAMIC_DOWNCAST(CAutoHideDockSite, pParentBar->GetParentDockSite());
pParentDockBar->SetOffsetLeft(10);
pParentDockBar->SetOffsetRight(10);

Spécifications

En-tête : afxautohidedocksite.h

CAutoHideDockSite ::CanAcceptPane

Détermine si un volet de base est un objet CMFCAutoHideBar ou dérivé de CMFCAutoHideBar.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Paramètres

pBar
[in] Volet de base que l’infrastructure teste.

Valeur de retour

TRUE si pBar est dérivé de CMFCAutoHideBar; FALSE dans le cas contraire.

Notes

Si un objet de volet de base est dérivé de CMFCAutoHideBar, il peut contenir un CAutoHideDockSite.

CAutoHideDockSite ::D ockPane

Ancre un volet sur cet objet CAutoHideDockSite .

virtual void DockPane(
    CPane* pWnd,
    AFX_DOCK_METHOD dockMethod,
    LPRECT lpRect = NULL);

Paramètres

Pwnd
[in] Volet ancré dans l’infrastructure.

dockMethod
[in] Options d’ancrage pour le volet.

lpRect
[in] Rectangle qui spécifie les limites du volet ancré.

Notes

L’implémentation par défaut n’utilise pas le paramètre dockMethod, qui est fourni pour une utilisation ultérieure.

Si lpRect a la valeur NULL, l’infrastructure place le volet à l’emplacement par défaut sur le site d’ancrage. Si le site d’ancrage est horizontal, l’emplacement par défaut se trouve à l’extrême gauche du site d’ancrage. Sinon, l’emplacement par défaut se trouve en haut du site d’ancrage.

CAutoHideDockSite ::GetAlignRect

Récupère la taille du site d’ancrage en coordonnées d’écran.

void GetAlignRect(CRect& rect) const;

Paramètres

Rect
[in] Référence à un rectangle. La méthode stocke la taille du site d’ancrage dans ce rectangle.

Notes

Le rectangle est ajusté pour les marges de décalage afin qu’elles ne soient pas incluses.

CAutoHideDockSite ::m_nExtraSpace

Taille de l’espace entre les bords de la classe CAutoHideDockSite et les objets CMFCAutoHideBar Class .

static int m_nExtraSpace;

Notes

Lorsqu’une CMFCAutoHideBar station d’accueil est ancrée à un CAutoHideDockSite, elle ne doit pas occuper l’ensemble du site d’ancrage. Cette variable globale contrôle l’espace supplémentaire entre la bordure gauche ou supérieure du CMFCAutoHideBar bord et le bord correspondant CAutoHideDockSite . Si le bord supérieur ou gauche est utilisé dépend de l’alignement actuel.

CAutoHideDockSite ::SetOffsetLeft

Définit la marge sur le côté gauche de la barre d’ancrage.

void SetOffsetLeft(int nOffset);

Paramètres

nOffset
[in] Nouveau décalage.

Notes

Les objets CMFCAutoHideBar sont positionnés statiquement sur l’objet CAutoHideDockSite . Cela signifie que l’utilisateur ne peut pas modifier manuellement l’emplacement des CMFCAutoHideBar objets. La SetOffsetLeft méthode contrôle l’espacement entre le côté gauche du plus CMFCAutoHideBar à gauche et le côté gauche du CAutoHideDockSite.

CAutoHideDockSite ::SetOffsetRight

Définit la marge sur le côté droit de la barre d’ancrage.

void SetOffsetRight(int nOffset);

Paramètres

nOffset
[in] Nouveau décalage.

Notes

Les objets CMFCAutoHideBar sont positionnés statiquement sur l’objet CAutoHideDockSite . Cela signifie que l’utilisateur ne peut pas modifier manuellement l’emplacement des CMFCAutoHideBar objets. La SetOffsetRight méthode contrôle l’espacement entre le côté droit du côté CMFCAutoHideBar droit et le côté droit du CAutoHideDockSite.

CAutoHideDockSite ::RepositionPanes

Redessine les volets sur CAutoHideDockSite.

virtual void RepositionPanes(CRect& rectNewClientArea);

Paramètres

rectNewClientArea
[in] Valeur réservée.

Notes

L’implémentation par défaut n’utilise pas rectNewClientArea. Il redessine les volets avec les marges de barre d’outils globales et l’espacement des boutons.

CAutoHideDockSite ::UnSetAutoHideMode

Appelle CMFCAutoHideBar ::UnSetAutoHideMode pour les objets sur le site d’ancrage.

void UnSetAutoHideMode(CMFCAutoHideBar* pAutoHideToolbar);

Paramètres

pAutoHideToolbar
[in] Pointeur vers un volet objet CMFCAutoHideBar situé sur le CAutoHideDockSite.

Notes

Cette méthode recherche la ligne qui contient pAutoHideToolbar. Elle appelle CMFCAutoHideBar.UnSetAutoHideMode tous les CMFCAutoHideBar objets de cette ligne. Si pAutoHideToolbar est introuvable ou qu’elle a la valeur NULL, cette méthode appelle CMFCAutoHideBar.UnSetAutoHideMode tous les CMFCAutoHideBar objets sur le CAutoHideDockSite.

Voir aussi

Graphique hiérarchique
Classes
CDockSite, classe