Classe CMFCAutoHideButton

Um botão que exibe ou esconde uma Classe CDockablePane configurada para ocultar.

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

Sintaxe

class CMFCAutoHideButton : public CObject

Membros

Métodos Públicos

Observações

Na criação, o CMFCAutoHideButton objeto é associado a uma Classe CDockablePane. O CDockablePane objeto é oculto ou exibido à medida que o utilizador interage com ele CMFCAutoHideButton .

Por defeito, o framework cria automaticamente um CMFCAutoHideButton quando o utilizador ativa o auto-ocultar. O framework pode criar um elemento de uma classe UI personalizada em vez da classe CMFCAutoHideButton . Para especificar qual a classe UI personalizada que o framework deve usar, defina a variável CMFCAutoHideBar::m_pAutoHideButtonRTS membro estática igual à classe UI personalizada. Por defeito, esta variável está definida como CMFCAutoHideButton.

Example

O exemplo seguinte demonstra como construir um CMFCAutoHideButton objeto e usar vários métodos na CMFCAutoHideButton aula. O exemplo mostra como inicializar um CMFCAutoHideButton objeto usando o seu Create método, mostrar a classe associada CDockablePane e mostrar o botão de ocultação automática.

CMFCAutoHideButton *autoHideButton = new CMFCAutoHideButton();
CDockablePane cPane;
// CMFCAutoHideBar* pParentBar
if (!autoHideButton->Create(pParentBar, &cPane, CBRS_ALIGN_LEFT))
{
   return 0;
}
autoHideButton->ShowAttachedWindow(true);
autoHideButton->ShowButton(true);

Hierarquia de herança

CObject

CMFCAutoHideButton

Requerimentos

Cabeçalho: afxautohidebutton.h

CMFCAutoHideButton::BringToTop

void BringToTop();

Observações

CMFCAutoHideButton::Create

Cria e inicializa um botão de ocultação automática.

virtual BOOL Create(
    CMFCAutoHideBar* pParentBar,
    CDockablePane* pAutoHideWnd,
    DWORD dwAlignment);

Parâmetros

pParentBar
[dentro] Um apontador para a barra de ferramentas dos pais.

pAutoHideWnd
[dentro] Um apontador para um objeto CDockablePane . Este botão de ocultação automática esconde e mostra que CDockablePane.

dwAlignment
[dentro] Um valor que especifica o alinhamento do botão com a janela do quadro principal.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

Quando cria um CMFCAutoHideButton objeto, deve associar o botão de ocultação automática a um elemento específico CDockablePanede . O utilizador pode usar o botão de ocultação automática para ocultar e mostrar o .CDockablePane

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

CMFCAutoHideButton::GetAlignment

Recupera o alinhamento do botão de ocultação automática.

DWORD GetAlignment() const;

Valor de retorno

Um valor DWORD que contém o alinhamento atual do botão de ocultação automática.

Observações

O alinhamento do botão de ocultação automática indica onde o botão se encontra na aplicação. Pode ser qualquer um dos seguintes valores:

• CBRS_ALIGN_LEFT

• CBRS_ALIGN_RIGHT

• CRBS_ALIGN_TOP

• CBRS_ALIGN_BOTTOM

CMFCAutoHideButton::GetAutoHideWindow

Devolve o objeto CDockablePane associado ao botão de ocultação automática.

CDockablePane* GetAutoHideWindow() const;

Valor de retorno

Um apontador para o objeto associado CDockablePane .

Observações

Para associar um botão de ocultação automática a um CDockablePane, passe o CDockablePane como parâmetro ao método CMFCAutoHideButton::Create .

CMFCAutoHideButton::GetParentToolBar

CMFCAutoHideBar* GetParentToolBar();

Valor de retorno

Observações

CMFCAutoHideButton::GetRect

CRect GetRect() const;

Valor de retorno

Observações

CMFCAutoHideButton::GetSize

Determina o tamanho do botão de ocultação automática.

CSize GetSize() const;

Valor de retorno

Um CSize objeto que contém o tamanho do botão.

Observações

O tamanho calculado inclui o tamanho da borda do botão de ocultação automática.

CMFCAutoHideButton::GetTextSize

Devolve o tamanho da etiqueta de texto para o botão de ocultação automática.

virtual CSize GetTextSize() const;

Valor de retorno

Um objeto CSize que contém o tamanho do texto para o botão de ocultação automática.

CMFCAutoHideButton::IsActive

Indica se o botão de ocultação automática está ativo.

BOOL IsActive() const;

Valor de retorno

TRUE se o botão de ocultação automática estiver ativo; FALSO, caso contrário.

Observações

Um botão de ocultação automática está ativo quando a janela de classe CDockablePane associada é mostrada.

CMFCAutoHideButton::IsHorizontal

Determina se o botão de ocultação automática é horizontal ou vertical.

BOOL IsHorizontal() const;

Valor de retorno

Diferente de zero se o botão estiver na horizontal; 0 caso contrário.

Observações

O framework define a orientação de um objeto CMFCAutoHideButton quando o crias. Pode controlar a orientação usando o parâmetro dwAlignment no método CMFCAutoHideButton::Create .

CMFCAutoHideButton::IsTop

BOOL IsTop() const;

Valor de retorno

Observações

CMFCAutoHideButton::IsVisible

Indica se o botão de ocultação automática está visível.

virtual BOOL IsVisible() const;

Valor de retorno

TRUE se o botão for visível; FALSO, caso contrário.

CMFCAutoHideButton::OnDraw

O framework chama este método quando desenha o botão de ocultação automática.

virtual void OnDraw(CDC* pDC);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

Observações

Se quiser personalizar a aparência dos botões de ocultação automática na sua aplicação, crie uma nova classe derivada de CMFCAutoHideButton. Na tua classe derivada, anula este método.

CMFCAutoHideButton::OnDrawBorder

A estrutura chama este método quando desenha a borda de um botão de ocultação automática.

virtual void OnDrawBorder(
    CDC* pDC,
    CRect rectBounds,
    CRect rectBorderSize);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

rectBounds
[dentro] O retângulo delimitador do botão de ocultação automática.

rectBorderSize
[dentro] A espessura da borda de cada lado do botão de ocultação automática.

Observações

Se quiser personalizar a borda de cada botão de ocultação automática na sua aplicação, crie uma nova classe derivada do CMFCAutoHideButton. Na tua classe derivada, anula este método.

CMFCAutoHideButton::OnFillBackground

O framework chama este método quando preenche o fundo de um botão de ocultação automática.

virtual void OnFillBackground(
    CDC* pDC,
    CRect rect);

Parâmetros

pDC
[dentro] Um apontador para o contexto de um dispositivo.

retângulo
[dentro] O retângulo delimitador do botão de ocultação automática.

Observações

Se quiser personalizar o fundo para ocultar automaticamente botões na sua aplicação, crie uma nova classe derivada do CMFCAutoHideButton. Na tua classe derivada, anula este método.

CMFCAutoHideButton::MostrarJanela Anexada

Mostra ou esconde a classe CDockablePane associada.

void ShowAttachedWindow(BOOL bShow);

Parâmetros

bShow
[dentro] Um Booleano que especifica se este método mostra o .CDockablePane

CMFCAutoHideButton::MostrarBotão

Mostra ou esconde o botão de ocultação automática.

virtual void ShowButton(BOOL bShow);

Parâmetros

bShow
[dentro] Um Booleano que especifica se deve mostrar o botão de ocultação automática.

CMFCAutoHideButton::Move

void Move(int nOffset);

Parâmetros

[dentro] nOffset

Observações

CMFCAutoHideButton::ReplacePane

void ReplacePane(CDockablePane* pNewBar);

Parâmetros

[dentro] pNewBar

Observações

CMFCAutoHideButton::UnSetAutoHideMode

Desative o modo de ocultação automática.

virtual void UnSetAutoHideMode(CDockablePane* pFirstBarInGroup);

Parâmetros

pFirstBarInGroup
[dentro] Um apontar para a primeira barra do grupo.

Observações

CMFCAutoHideButton::Botão de Destaque

Destaca o botão de ocultação automática.

virtual void HighlightButton(BOOL bHighlight);

Parâmetros

bDestaques
Especifica o novo estado do botão de ocultação automática. TRUE indica que o botão está destacado, FALSE indica que o botão não está destacado.

Observações

CMFCAutoHideButton::IsHighlighted

Devolve o estado de destaque do botão de ocultação automática.

virtual BOOL IsHighlighted() const;

Valor de retorno

Retorna TRUE se o botão de ocultação automática estiver destacado; caso contrário, FALSO.

Observações

Consulte também

Gráfico de Hierarquia
Classes
Classe CMFCAutoHideBar
Classe CAutoHideDockSite