Classe CMFCAutoHideBar

A CMFCAutoHideBar classe é uma classe especial de barra de ferramentas que implementa a funcionalidade de ocultação automática.

Para mais detalhes, consulte o código-fonte localizado na pasta VC\atlmfc\src\mfc da sua instalação no Visual Studio.

Sintaxe

class CMFCAutoHideBar : public CPane

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados

Observações

Quando o utilizador muda um painel de dock para modo de ocultação automática, a framework cria automaticamente um CMFCAutoHideBar objeto. Também cria os necessários objetos CAutoHideDockSite e CMFCAutoHideButton . Cada CAutoHideDockSite objeto está associado a um indivíduo CMFCAutoHideButton.

A CMFCAutoHideBar classe implementa a visualização de a CAutoHideDockSite quando o rato do utilizador paira sobre um CMFCAutoHideButton. Quando a barra de ferramentas recebe uma mensagem WM_MOUSEMOVE, CMFCAutoHideBar inicia um temporizador. Quando o temporizador termina, envia à barra de ferramentas uma notificação de WM_TIMER evento. A barra de ferramentas gere este evento verificando se o ponteiro do rato está posicionado sobre o mesmo botão de ocultação automática sobre o qual estava quando o temporizador começou. Se estiver, o anexo CAutoHideDockSite é exibido.

Pode controlar o tempo de atraso do temporizador definindo m_nShowAHWndDelay. O valor padrão é 400 ms.

Example

O exemplo seguinte demonstra como construir um CMFCAutoHideBar objeto e usar o seu GetDockSiteRow método.

CMFCAutoHideBar *pParentBar = new CMFCAutoHideBar();
CDockingPanesRow *pParentRow = pParentBar->GetDockSiteRow();

Hierarquia de herança

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCAutoHideBar

Requerimentos

Cabeçalho: afxautohidebar.h

CMFCAutoHideBar::AddAutoHideWindow

Adiciona funcionalidade a uma CDockablePane janela que permite ocultar automaticamente.

CMFCAutoHideButton* AddAutoHideWindow(
    CDockablePane* pAutoHideWnd,
    DWORD dwAlignment);

Parâmetros

pAutoHideWnd
[dentro] A janela que queres esconder.

dwAlignment
[dentro] Um valor que especifica o alinhamento do botão de ocultação automática com a janela da aplicação.

Valor de retorno

Observações

O parâmetro dwAlignment indica onde reside o botão de ocultação automática na aplicação. O parâmetro pode ser qualquer um dos seguintes valores:

• CBRS_ALIGN_LEFT

• CBRS_ALIGN_RIGHT

• CBRS_ALIGN_TOP

• CBRS_ALIGN_BOTTOM

CMFCAutoHideBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

Valor de retorno

Observações

CMFCAutoHideBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parâmetros

[dentro] bStretch

[dentro] bHorz

Valor de retorno

Observações

CMFCAutoHideBar::CMFCAutoHideBar

Constrói um objeto CMFCAutoHideBar.

CMFCAutoHideBar();

Observações

CMFCAutoHideBar::Create

virtual BOOL Create(
    LPCTSTR lpszClassName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    DWORD dwControlBarStyle = AFX_DEFAULT_PANE_STYLE,
    CCreateContext* pContext = NULL);

Parâmetros

lpszClassName

dwStyle

retângulo

pParentWnd

nID

dwControlBarStyle

pContext

Valor de retorno

Observações

CMFCAutoHideBar::GetFirstAHWindow

Devolve um ponteiro para a primeira janela de autoocultação na aplicação.

CDockablePane* GetFirstAHWindow();

Valor de retorno

A primeira janela de ocultação automática na aplicação, ou NULL se não houver.

Observações

CMFCAutoHideBar::GetVisibleCount

Obtém o número de botões visíveis de ocultação automática.

int GetVisibleCount();

Valor de retorno

Devolve o número de botões visíveis de ocultação automática.

Observações

CMFCAutoHideBar::m_nShowAHWndDelay

O atraso temporal entre o momento em que o utilizador coloca o cursor do rato sobre uma Classe CMFCAutoHideButton e o momento em que a estrutura mostra a janela associada.

int CMFCAutoHideBar::m_nShowAHWndDelay = 400;

Observações

Quando o utilizador coloca o cursor do rato sobre um CMFCAutoHideButton, há um ligeiro atraso antes de a estrutura mostrar a janela associada. Este parâmetro determina o comprimento desse atraso em milissegundos.

CMFCAutoHideBar::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

Parâmetros

[dentro] CPoint

Valor de retorno

Observações

CMFCAutoHideBar::RemoveAutoHideWindow

Remove e destrói a janela de ocultação automática.

    BOOL RemoveAutoHideWindow(CDockablePane* pAutoHideWnd);

Parâmetros

CDockablePane* pAutoHideWnd A janela de ocultação automática para remover.

Valor de retorno

VERDADEIRO se for bem-sucedido; caso contrário, FALSO.

Observações

CMFCAutoHideBar::SetActiveInGroup

Sinaliza uma barra de ocultação automática como ativa.

virtual void SetActiveInGroup(BOOL bActive);

Parâmetros

[dentro] BOOL bActive TRUE para definir ativo; caso contrário, FALSO.

Observações

Veja CPane::SetActiveInGroup.

CMFCAutoHideBar::SetRecentVisibleState

void SetRecentVisibleState(BOOL bState);

Parâmetros

bEstado
[dentro] Estado para set.

Observações

CMFCAutoHideBar::ShowAutoHideWindow

Mostra a janela de ocultação automática.

BOOL ShowAutoHideWindow(
    CDockablePane* pAutoHideWnd,
    BOOL bShow,
    BOOL bDelay);

Parâmetros

pAutoHideWnd
[dentro] Janela para mostrar.

bShow
[dentro] VERDADE para mostrar a janela.

bDelay
[dentro] Este parâmetro é ignorado.

Valor de retorno

VERDADEIRO se for bem-sucedido; caso contrário, FALSO.

Observações

CMFCAutoHideBar::StretchPane

Redimensiona a barra de ocultação automática no seu estado colapsado para se ajustar ao CMFCAutoHideButton objeto.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parâmetros

nComprimento
[dentro] O valor não é utilizado na implementação base. Em implementações derivadas, use este valor para indicar o comprimento do painel redimensionado.

bVert
[dentro] O valor não é utilizado na implementação base. Em implementações derivadas, use TRUE para lidar com o caso em que a barra de auto-ocultação está colapsada verticalmente, e FALSE para o caso em que a barra de auto-ocultação está colapsada horizontalmente.

Valor de retorno

O tamanho resultante do painel redimensionado.

Observações

As classes derivadas podem sobrepor este método para personalizar o comportamento.

CMFCAutoHideBar::UnSetAutoHideMode

Desativa o modo de ocultação automática para um grupo de barras de ocultação automática.

void UnSetAutoHideMode(CDockablePane* pFirstBarInGroup)

Parâmetros

[em] pFirstBarInGroup Apontador para a primeira barra de ocultação automática do grupo.

Observações

CMFCAutoHideBar::UpdateVisibleState

É chamado pela estrutura quando a barra de ocultação automática precisa de ser redesenhada.

void UpdateVisibleState();

Observações

Consulte também

Gráfico de Hierarquia
Classes
Classe CPane
Classe CAutoHideDockSite
Classe CMFCAutoHideButton