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