Partilhar via

Classe CMFCDropDownToolbarButton

  • Artigo

Um tipo de botão de barra de ferramentas que se comporta como um botão normal quando ele é clicado. No entanto, abre uma barra de ferramentas suspensa (Classe CMFCDropDownToolBar), quando o usuário mantém pressionado o botão de barra de ferramentas.

Sintaxe

class CMFCDropDownToolbarButton : public CMFCToolBarButton

Membros

Construtores públicos

Nome Descrição
CMFCDropDownToolbarButton::CMFCDropDownToolbarButton Constrói um objeto CMFCDropDownToolbarButton.
CMFCDropDownToolbarButton::~CMFCDropDownToolbarButton Destruidor.

Métodos públicos

Nome Descrição
CMFCDropDownToolbarButton::CopyFrom Copia as propriedades de outro botão de barra de ferramentas para o botão atual. (Substitui CMFCToolBarButton::CopyFrom.)
CMFCDropDownToolbarButton::CreateObject Usado pela estrutura para criar uma instância dinâmica desse tipo de classe.
CMFCDropDownToolbarButton::DropDownToolbar Abre uma barra de ferramentas suspensa.
CMFCDropDownToolbarButton::ExportToMenuButton Copia o texto do botão de barra de ferramentas para um menu. (Substitui CMFCToolBarButton::ExportToMenuButton.)
CMFCDropDownToolbarButton::GetDropDownToolBar Recupera a barra de ferramentas suspensa associada ao botão.
CMFCDropDownToolbarButton::GetThisClass Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe.
CMFCDropDownToolbarButton::IsDropDown Determina se a barra de ferramentas suspensa está aberta no momento.
CMFCDropDownToolbarButton::IsExtraSize Determina se o botão pode ser exibido com uma borda estendida. (Substitui CMFCToolBarButton::IsExtraSize.)
CMFCDropDownToolbarButton::OnCalculateSize Chamado pela estrutura para calcular o tamanho do botão para o contexto do dispositivo e o estado de encaixe especificados. (Substitui CMFCToolBarButton::OnCalculateSize.)
CMFCDropDownToolbarButton::OnCancelMode Chamado pela estrutura para lidar com a mensagem WM_CANCELMODE. (Substitui CMCToolBarButton::OnCancelMode.)
CMFCDropDownToolbarButton::OnChangeParentWnd Chamado pela estrutura quando o botão é inserido em uma nova barra de ferramentas. (Substitui CMFCToolBarButton::OnChangeParentWnd.)
CMFCDropDownToolbarButton::OnClick Chamado pela estrutura quando o usuário clica no botão do mouse. (Substitui CMFCToolBarButton::OnClick.)
CMFCDropDownToolbarButton::OnClickUp Chamado pela estrutura quando o usuário libera o botão do mouse. (Substitui CMFCToolBarButton::OnClickUp.)
CMFCDropDownToolbarButton::OnContextHelp Chamado pela estrutura quando a barra de ferramentas pai manipula uma mensagem WM_HELPHITTEST. (Substitui CMFCToolBarButton::OnContextHelp.)
CMFCDropDownToolbarButton::OnCustomizeMenu Modifica o menu fornecido quando o aplicativo exibe um menu de atalho na barra de ferramentas pai. (Substitui CMFCToolBarButton::OnCustomizeMenu.)
CMFCDropDownToolbarButton::OnDraw Chamado pela estrutura para desenhar o botão usando os estilos e as opções especificados. (Substitui CMFCToolBarButton::OnDraw.)
CMFCDropDownToolbarButton::OnDrawOnCustomizeList Chamado pela estrutura para desenhar o botão no painel Comandos da caixa de diálogo Personalizar. (Substitui CMFCToolBarButton::OnDrawOnCustomizeList.)
CMFCDropDownToolbarButton::Serialize Lê esse objeto de um arquivo morto ou grava-o em um arquivo morto. (Substitui CMFCToolBarButton::Serialize.)
CMFCDropDownToolbarButton::SetDefaultCommand Define o comando padrão que a estrutura usa quando um usuário clica no botão.

Membros de dados

Nome Descrição
CMFCDropDownToolbarButton::m_uiShowBarDelay Especifica o período pelo qual um usuário deve manter pressionado o botão do mouse, para que a barra de ferramentas suspensa seja exibida.

Comentários

Um CMFCDropDownToolBarButton é diferente de um botão comum, pois tem uma pequena seta no canto inferior direito do botão. Depois que o usuário seleciona um botão na barra de ferramentas suspensa, a estrutura exibe o ícone no botão de barra de ferramentas de nível superior (o botão com a pequena seta no canto inferior direito).

Para obter informações sobre como implementar uma barra de ferramentas suspensa, confira Classe CMFCDropDownToolBar.

O objeto CMFCDropDownToolBarButton pode ser exportado para um objeto Classe CMFCToolBarMenuButton e exibido como botão de menu com um menu pop-up.

Hierarquia de herança

CObject

CMFCToolBarButton

CMFCDropDownToolbarButton

Requisitos

Cabeçalho: afxdropdowntoolbar.h

CMFCDropDownToolbarButton::CopyFrom

Copia as propriedades de outro botão de barra de ferramentas para o botão atual.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parâmetros

src
[in] Uma referência ao botão de origem do qual copiar.

Comentários

Chame esse método para copiar outro botão de barra de ferramentas para este botão de barra de ferramentas. src deve ser do tipo CMFCDropDownToolbarButton.

CMFCDropDownToolbarButton::CMFCDropDownToolbarButton

Constrói um objeto CMFCDropDownToolbarButton.

CMFCDropDownToolbarButton();

CMFCDropDownToolbarButton(
    LPCTSTR lpszName,
    CMFCDropDownToolBar* pToolBar);

Parâmetros

lpszName
[in] O texto padrão do botão.

pToolBar
[in] Um ponteiro para o objeto CMFCDropDownToolBar exibido quando o usuário pressiona o botão.

Comentários

A segunda sobrecarga do construtor copia para o botão suspenso o primeiro botão na barra de ferramentas especificada por pToolBar.

Normalmente, um botão de barra de ferramentas suspenso usa o texto do botão usado mais recentemente na barra de ferramentas especificada por pToolBar. Ele usa o texto especificado por lpszName, quando o botão é convertido em um botão de menu ou é exibido na guia Comandos da caixa de diálogo Personalizar. Para mais informações sobre a caixa de diálogo Personalizar, confira Classe CMFCToolBarsCustomizeDialog.

Exemplo

O exemplo a seguir demonstra como construir um objeto da classe CMFCDropDownToolbarButton. Esse snippet de código faz parte do exemplo de Demonstração do Visual Studio.

// Add dropdown resources button
// CMFCToolBarsCustomizeDialog* pDlgCust
// CMFCDropDownToolBar m_wndToolbarResource
pDlgCust->AddButton(_T("Build"), CMFCDropDownToolbarButton(_T("Add Resource"), &m_wndToolbarResource));

Abre uma barra de ferramentas suspensa.

BOOL DropDownToolbar(CWnd* pWnd);

Parâmetros

pWnd
[in] A janela pai do quadro suspenso ou NULL para usar a janela pai do botão de barra de ferramentas suspensa.

Valor de retorno

Um valor diferente de zero, se o método tiver êxito. Caso contrário, 0.

Comentários

O método CMFCDropDownToolbarButton::OnClick chama esse método para abrir a barra de ferramentas suspensa, quando o usuário mantém pressionado o botão de barra de ferramentas.

Esses métodos criam a barra de ferramentas suspensa usando o método CMFCDropDownFrame::Create. Se a barra de ferramentas pai estiver encaixada verticalmente, esse método posicionará a barra de ferramentas suspensa no lado esquerdo ou direito da barra de ferramentas pai, dependendo do ajuste. Caso contrário, esse método posiciona a barra de ferramentas suspensa abaixo da barra de ferramentas pai.

Esse método falhará se pWnd for NULL e o botão de barra de ferramentas suspensa não tiver uma janela pai.

CMFCDropDownToolbarButton::ExportToMenuButton

Copia o texto do botão de barra de ferramentas para um menu.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parâmetros

menuButton
[in] Uma referência ao botão de menu de destino.

Valor de retorno

Um valor diferente de zero, se o método tiver êxito. Caso contrário, 0.

Comentários

Esse método chama a implementação da classe base (CMFCToolBarButton::ExportToMenuButton) e acrescenta ao botão de menu de destino um menu pop-up que contém cada item de menu da barra de ferramentas neste botão. Esse método não acrescenta sub menus ao menu pop-up.

Esse método falhará se a barra de ferramentas pai, m_pToolBar, for NULL ou a implementação da classe base retornar FALSE.

CMFCDropDownToolbarButton::GetDropDownToolBar

Recupera a barra de ferramentas suspensa associada ao botão.

CMFCToolBar* GetDropDownToolBar() const;

Valor de retorno

A barra de ferramentas suspensa associada ao botão.

Comentários

Esse método retorna o membro de dados m_pToolBar.

CMFCDropDownToolbarButton::IsDropDown

Determina se a barra de ferramentas suspensa está aberta no momento.

BOOL IsDropDown() const;

Valor de retorno

Um valor diferente de zero, se a barra de ferramentas suspensa estiver aberta no momento. Caso contrário, 0.

Comentários

A estrutura abre a barra de ferramentas suspensa usando o método CMFCDropDownToolbarButton::D ropDownToolbar. A estrutura fecha a barra de ferramentas suspensa, quando o usuário pressiona o botão esquerdo do mouse na área não cliente da barra de ferramentas suspensa.

CMFCDropDownToolbarButton::IsExtraSize

Determina se o botão pode ser exibido com uma borda estendida.

virtual BOOL IsExtraSize() const;

Valor de retorno

Um valor diferente de zero, se o botão de barra de ferramentas puder ser exibido com uma borda estendida. Caso contrário, 0.

Comentários

Para obter mais informações sobre bordas estendidas, confira CMFCToolBarButton::IsExtraSize.

CMFCDropDownToolbarButton::m_uiShowBarDelay

Especifica o período pelo qual um usuário deve manter pressionado o botão do mouse, para que a barra de ferramentas suspensa seja exibida.

static UINT m_uiShowBarDelay;

Comentários

O tempo de atraso é medido em milissegundos. O valor padrão é 500. Você pode definir outro atraso, alterando o valor desse membro de dados compartilhado.

CMFCDropDownToolbarButton::OnCalculateSize

Chamado pela estrutura para calcular o tamanho do botão para o contexto do dispositivo e o estado de encaixe especificados.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parâmetros

pDC
[in] O contexto do dispositivo que exibe o botão.

sizeDefault
[in] O tamanho padrão do botão.

bHorz
[in] O estado do encaixe da barra de ferramentas pai. Esse parâmetro será TRUE se a barra de ferramentas estiver encaixada horizontalmente ou estiver flutuante ou FALSE se a barra de ferramentas estiver encaixada verticalmente.

Valor de retorno

Uma estrutura SIZE que contém as dimensões do botão, em pixels.

Comentários

Esse método estende a implementação da classe base (CMFCToolBarButton::OnCalculateSize), adicionando a largura da seta suspensa à dimensão horizontal do tamanho do botão.

CMFCDropDownToolbarButton::OnChangeParentWnd

Chamado pela estrutura quando o botão é inserido em uma nova barra de ferramentas.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parâmetros

pWndParent
[in] A nova janela pai.

Comentários

Esse método substitui a implementação da classe base (CMFCToolBarButton::OnChangeParentWnd), desmarcando o rótulo de texto (CMFCToolBarButton::m_strText) e definindo os membros de dados CMFCToolBarButton::m_bText e CMFCToolBarButton::m_bUserButton como FALSE.

CMFCDropDownToolbarButton::OnClick

Chamado pela estrutura quando o usuário clica no botão do mouse.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

Parâmetros

pWnd
[in] A janela pai do botão de barra de ferramentas.

bDelay
[in] TRUE se a mensagem deve ser tratada com um atraso.

Valor de retorno

Um valor diferente de zero, se o botão processar a mensagem de clique. Caso contrário, 0.

Comentários

Esse método estende a implementação da classe base, CMFCToolBarButton::OnClick, atualizando o estado da barra de ferramentas suspensa.

Quando um usuário clica no botão de barra de ferramentas, esse método cria um temporizador que aguarda o período especificado pelo membro de dados CMFCDropDownToolbarButton::m_uiShowBarDelay e abre a barra de ferramentas suspensa usando o método CMFCDropDownToolbarButton::D ropDownToolbar. Esse método fecha a barra de ferramentas suspensa na segunda vez que o usuário clica no botão de barra de ferramentas.

CMFCDropDownToolbarButton::OnClickUp

Chamado pela estrutura quando o usuário libera o botão do mouse.

virtual BOOL OnClickUp();

Valor de retorno

Um valor diferente de zero, se o botão processar a mensagem de clique. Caso contrário, 0.

Comentários

Esse método estende a implementação da classe base, CMFCToolBarButton::OnClickUp, atualizando o estado da barra de ferramentas suspensa.

Esse método interromperá o temporizador da barra de ferramentas suspensa, se ele estiver ativo. Ele fechará a barra de ferramentas suspensa, se ela estiver aberta.

Para obter mais informações sobre a barra de ferramentas suspensa e o temporizador da barra de ferramentas suspensa, confira CMFCDropDownToolbarButton::OnClick.

CMFCDropDownToolbarButton::OnContextHelp

Chamado pela estrutura quando a barra de ferramentas pai manipula uma mensagem WM_HELPHITTEST.

virtual BOOL OnContextHelp(CWnd* pWnd);

Parâmetros

pWnd
[in] A janela pai do botão de barra de ferramentas.

Valor de retorno

Um valor diferente de zero, se o botão processar a mensagem de ajuda. Caso contrário, 0.

Comentários

Esse método estende a implementação da classe base (CMFCToolBarButton::OnContextHelp), chamando o método CMFCDropDownToolbarButton::OnClick com o bDelay definido como FALSE. Esse método retorna o valor devolvido por CMFCDropDownToolbarButton::OnClick.

Para mais informações sobre a mensagem WM_HELPHITTEST, confira TN028: Suporte para ajuda contextual.

CMFCDropDownToolbarButton::OnCustomizeMenu

Modifica o menu fornecido quando o aplicativo exibe um menu de atalho na barra de ferramentas pai.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

Parâmetros

pMenu
[in] O menu a ser personalizado.

Valor de retorno

Esse método retorna TRUE.

Comentários

Esse método estende a implementação da classe base (CMFCToolBarButton::OnCustomizeMenu), desabilitando os seguintes itens de menu:

  • Copiar Imagem do Botão

  • Aparência do Botão

  • Imagem

  • Text

  • Imagem e Texto

Substitua esse método para modificar o menu de atalho que a estrutura exibe no modo de personalização.

CMFCDropDownToolbarButton::OnDraw

Chamado pela estrutura para desenhar o botão usando os estilos e as opções especificados.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

Parâmetros

pDC
[in] O contexto do dispositivo que exibe o botão.

rect
[in] O retângulo delimitador do botão.

pImages
[in] A coleção de imagens da barra de ferramentas associada ao botão.

bHorz
[in] O estado do encaixe da barra de ferramentas pai. Esse parâmetro é TRUE quando o botão é encaixado horizontalmente e FALSE quando o botão é encaixado verticalmente.

bCustomizeMode
[in] Especifica se a barra de ferramentas está no modo de personalização. Esse parâmetro é TRUE quando a barra de ferramentas está no modo de personalização e FALSE quando a barra de ferramentas não está no modo de personalização.

bHighlight
[in] Especifica se o botão está realçado. Esse parâmetro é TRUE quando o botão é realçado e FALSE quando o botão não está realçado.

bDrawBorder
[in] Especifica se o botão deve exibir sua borda. Esse parâmetro é TRUE quando o botão deve exibir sua borda e FALSE quando o botão não deve exibir sua borda.

bGrayDisabledButtons
[in] Especifica se os botões desabilitados devem ser sombreados ou usar a coleção de imagens desabilitada. Esse parâmetro é TRUE quando os botões desabilitados devem ser sombreados e FALSE quando esse método deve usar a coleção de imagens desabilitada.

Comentários

Substitua esse método para personalizar o desenho do botão de barra de ferramentas.

CMFCDropDownToolbarButton::OnDrawOnCustomizeList

Chamado pela estrutura para desenhar o botão no painel Comandos da caixa de diálogo Personalizar.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parâmetros

pDC
[in] O contexto do dispositivo que exibe o botão.

rect
[in] O retângulo delimitador do botão.

bSelected
[in] Determina se o botão foi selecionado. Se esse parâmetro for TRUE, o botão será selecionado. Se esse parâmetro for FALSE, o botão não será selecionado.

Valor de retorno

A largura, em pixels, do botão no contexto do dispositivo especificado.

Comentários

Esse método é chamado pela caixa de diálogo de personalização (guia Comandos) quando é necessário que o botão seja exibido na caixa de listagem de desenho do proprietário.

Esse método estende a implementação da classe base (CMFCToolBarButton::OnDrawOnCustomizeList), alterando o rótulo de texto do botão para o nome do botão (ou seja, para o valor do parâmetro lpszName que você passou para o construtor).

CMFCDropDownToolbarButton::Serialize

Lê esse objeto de um arquivo morto ou grava-o em um arquivo morto.

virtual void Serialize(CArchive& ar);

Parâmetros

ar
[in] O objeto CArchive do qual ou para o qual serializar.

Comentários

Esse método estende a implementação da classe base (CMFCToolBarButton::Serialize), serializando a ID do recurso de barra de ferramentas pai. Quando o arquivo está sendo carregado (CArchive::IsLoading retorna um valor diferente de zero), esse método define o membro de dados m_pToolBar para a barra de ferramentas que contém a ID do recurso serializado.

CMFCDropDownToolbarButton::SetDefaultCommand

Define o comando padrão que a estrutura usa quando um usuário clica no botão.

void SetDefaultCommand(UINT uiCmd);

Parâmetros

uiCmd
[in] A ID do comando padrão.

Comentários

Chame esse método para especificar um comando padrão que a estrutura executa quando o usuário clica no botão. Um item com a ID de comando especificada pelo uiCmd deve estar localizado na barra de ferramentas suspensa pai.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCDropDownToolBar
Classe CMFCToolBar
Classe CMFCToolBarMenuButton
Instruções passo a passo: colocando controles em barras de ferramentas