Classe CAutoHideDockSite

Estende CAutoHideDockSite a Classe CDockSite para implementar blocos de dock com auto-ocultação.

Sintaxe

class CAutoHideDockSite : public CDockSite

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados

Observações

Quando chama CFrameWndEx::EnableAutoHidePanes, o framework cria automaticamente um CAutoHideDockSite objeto. Na maioria dos casos, não deves ter de instanciar ou usar esta classe diretamente.

A barra de acoplagem é a abertura entre o lado esquerdo do painel de doca e o lado esquerdo da classe CMFCAutoHideButton.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CBasePane

CDockSite

Example

O exemplo seguinte demonstra como recuperar um CAutoHideDockSite objeto de um CMFCAutoHideBar objeto e como definir as margens esquerda e direita da barra de acoplamento.

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

Requerimentos

Cabeçalho: afxautohidedocksite.h

CAutoHideDockSite::CanAcceptPane

Determina se um painel base é um objeto CMFCAutoHideBar ou derivado de CMFCAutoHideBar.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Parâmetros

pBar
[dentro] O painel base que o framework testa.

Valor de retorno

TRUE se pBar for derivado de CMFCAutoHideBar; FALSO, caso contrário.

Observações

Se um objeto do painel base for derivado de CMFCAutoHideBar, pode conter um CAutoHideDockSite.

CAutoHideDockSite::D ockPane

Acopla um painel a este objeto CAutoHideDockSite .

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

Parâmetros

pWnd
[dentro] O painel que a estrutura acopla.

dockMethod
[dentro] Opções de acoplamento para o painel.

lpRect
[dentro] Um retângulo que especifica os limites do painel acoplado.

Observações

A implementação padrão não utiliza o parâmetro dockMethod, que é fornecido para uso futuro.

Se o lpRect for NULL, o framework coloca o painel na localização padrão no local do dock. Se o local da doca for horizontal, a localização padrão é na extremidade esquerda do local da doca. Caso contrário, a localização padrão é no topo do local da doca.

CAutoHideDockSite::GetAlignRect

Recupera o tamanho do local do cais nas coordenadas do ecrã.

void GetAlignRect(CRect& rect) const;

Parâmetros

retângulo
[dentro] Uma referência a um retângulo. O método armazena o tamanho do local do cais neste retângulo.

Observações

O retângulo é ajustado para as margens deslocadas para que não sejam incluídas.

CAutoHideDockSite::m_nExtraSpace

O tamanho do espaço entre as arestas da Classe CAutoHideDockSite e dos objetos da Classe CMFCAutoHideBar .

static int m_nExtraSpace;

Observações

Quando a CMFCAutoHideBar está acoplado a a CAutoHideDockSite, não deve ocupar todo o local do cais. Esta variável global controla o espaço extra entre a borda esquerda ou superior do CMFCAutoHideBar e a aresta correspondente CAutoHideDockSite . Se a borda superior ou esquerda é usada depende do alinhamento da corrente.

CAutoHideDockSite::SetOffsetLeft

Define a margem do lado esquerdo da barra de acoplamento.

void SetOffsetLeft(int nOffset);

Parâmetros

nOffset
[dentro] A nova compensação.

Observações

Os objetos CMFCAutoHideBar são posicionados estaticamente no CAutoHideDockSite objeto. Isto significa que o utilizador não pode alterar manualmente a localização dos CMFCAutoHideBar objetos. O SetOffsetLeft método controla o espaçamento entre o lado esquerdo do mais CMFCAutoHideBar à esquerda e o lado esquerdo do CAutoHideDockSite.

CAutoHideDockSite::SetOffsetRight

Define a margem do lado direito da barra de acoplamento.

void SetOffsetRight(int nOffset);

Parâmetros

nOffset
[dentro] A nova compensação.

Observações

Os objetos CMFCAutoHideBar são posicionados estaticamente no CAutoHideDockSite objeto. Isto significa que o utilizador não pode alterar manualmente a localização dos CMFCAutoHideBar objetos. O SetOffsetRight método controla o espaçamento entre o lado direito do mais CMFCAutoHideBar à direita e o lado direito do CAutoHideDockSite.

CAutoHideDockSite::RepositionPanes

Redesenha os painéis no CAutoHideDockSite.

virtual void RepositionPanes(CRect& rectNewClientArea);

Parâmetros

rectNewClienteArea
[dentro] Um valor reservado.

Observações

A implementação padrão não utiliza rectNewClientArea. Redesenha os painéis com as margens globais da barra de ferramentas e o espaçamento dos botões.

CAutoHideDockSite::UnSetAutoHideHideMode

Chama CMFCAutoHideBar::UnSetAutoHideMode para objetos no local da dock.

void UnSetAutoHideMode(CMFCAutoHideBar* pAutoHideToolbar);

Parâmetros

pAutoHideToolbar
[dentro] Um apontador para um painel de objetos CMFCAutoHideBar localizado no CAutoHideDockSitearquivo .

Observações

Este método procura a linha que contém pAutoHideToolbar. Exige CMFCAutoHideBar.UnSetAutoHideMode todos os CMFCAutoHideBar objetos dessa linha. Se o pAutoHideToolbar não for encontrado ou for NULL, este método chama CMFCAutoHideBar.UnSetAutoHideMode todos os CMFCAutoHideBar objetos no CAutoHideDockSite.

Consulte também

Gráfico de Hierarquia
Classes
Classe CDockSite