Classe CMFCToolBarButton

Artigo
06/10/2015

Fornece a funcionalidade do botão para barras de ferramentas.

class CMFCToolBarButton : public CObject

Membros

Construtores public

Nome	Descrição
CMFCToolBarButton::CMFCToolBarButton	As compilações e inicializam um objeto de CMFCToolBarButton .
CMFCToolBarButton::~CMFCToolBarButton	Destruidor.

Métodos públicos

Nome	Descrição
CMFCToolBarButton::CanBeDropped	Especifica se um usuário pode posicionar um botão na barra de ferramentas ou o menu durante a personalização.
CMFCToolBarButton::CanBeStored	Especifica se o botão pode ser armazenado.
CMFCToolBarButton::CanBeStretched	Especifica se um usuário pode redimensionar o botão durante a personalização.
CMFCToolBarButton::CompareWith	Compara com essa instância do objeto fornecido CMFCToolBarButton .
CMFCToolBarButton::CopyFrom	Copia as propriedades de outro botão da barra de ferramentas para o botão atual.
CMFCToolBarButton::CreateFromOleData	Cria um objeto de CMFCToolBarButton do objeto fornecido de COleDataObject .
CMFCToolBarButton::CreateObject	Usado pela estrutura dinâmica para criar uma instância de esse tipo da classe.
CMFCToolBarButton::EnableWindow	Habilita ou desabilita a entrada de mouse e teclado.
CMFCToolBarButton::ExportToMenuButton	Copia texto do botão da barra de ferramentas para um menu.
CMFCToolBarButton::GetClipboardFormat	Recupera o formato global da área de transferência para o aplicativo.
CMFCToolBarButton::GetHwnd	Recupera o identificador de janela que está associado com o botão da barra de ferramentas.
CMFCToolBarButton::GetImage	Retorna o índice de imagem do botão.
CMFCToolBarButton::GetInvalidateRect	Recupera a região da área cliente do botão que deve ser redesenhado.
CMFCToolBarButton::GetParentWnd	Recupera a janela pai do botão.
CMFCToolBarButton::GetProtectedCommands	Recupera a lista de comandos que o usuário não pode personalizar.
CMFCToolBarButton::GetTextSize	Retorna o tamanho do texto do botão.
CMFCToolBarButton::HasFocus	Determina se o botão tem o foco de entrada atual.
CMFCToolBarButton::HaveHotBorder	Determina se uma borda do botão é exibida quando um usuário selecione.
CMFCToolBarButton::IsDrawImage	Determina se uma imagem é exibida no botão.
CMFCToolBarButton::IsDrawText	Determina se um rótulo de texto é exibida no botão.
CMFCToolBarButton::IsDroppedDown	Determina se o botão exibe um submenu.
CMFCToolBarButton::IsEditable	Determina se o botão pode ser personalizado.
CMFCToolBarButton::IsExtraSize	Determina se o botão pode ser exibido com uma borda estendido.
CMFCToolBarButton::IsFirstInGroup	Determina se o botão está na primeira posição em seu grupo de botões.
CMFCToolBarButton::IsHidden	Determina se o botão está oculto.
CMFCToolBarButton::IsHorizontal	Determina se o botão está localizado em uma barra de ferramentas horizontal.
CMFCToolBarButton::IsLastInGroup	Especifica se o botão está na posição a última em seu grupo de botões.
CMFCToolBarButton::IsLocked	Determina se o botão está em uma barra de ferramentas (não) personalizável bloqueado.
CMFCToolBarButton::IsOwnerOf	Determina se o botão é o proprietário do identificador de janela fornecido.
CMFCToolBarButton::IsVisible	Determina se o botão na barra de ferramentas é visível.
CMFCToolBarButton::IsWindowVisible	Determina se o identificador de janela subjacente do botão é visível.
CMFCToolBarButton::NotifyCommand	Especifica se o botão processa a mensagem de WM_COMMAND .
CMFCToolBarButton::OnAddToCustomizePage	Chamado pela estrutura quando o botão é adicionado a uma caixa de diálogo de Personalizar .
CMFCToolBarButton::OnBeforeDrag	Especifica se o botão pode ser arrastado.
CMFCToolBarButton::OnBeforeDrop	Especifica se um usuário pode soltar o botão na barra de ferramentas de destino.
CMFCToolBarButton::OnCalculateSize	Chamado pela estrutura para calcular o tamanho do botão para o contexto de dispositivo e o estado de encaixe especificados.
CMFCToolBarButton::OnCancelMode	Chamado pela estrutura para manipular a mensagem de WM_CANCELMODE .
CMFCToolBarButton::OnChangeParentWnd	Chamado pela estrutura quando o botão é inserido em uma nova barra de ferramentas.
CMFCToolBarButton::OnClick	Chamado pela estrutura quando o usuário clica no botão do mouse.
CMFCToolBarButton::OnClickUp	Chamado pela estrutura quando o usuário liberar o botão do mouse.
CMFCToolBarButton::OnContextHelp	Chamado pela estrutura quando a barra de ferramentas pai manipular uma mensagem de WM_HELPHITTEST .
CMFCToolBarButton::OnCtlColor	Chamado pela estrutura quando a barra de ferramentas pai manipular uma mensagem de WM_CTLCOLOR .
CMFCToolBarButton::OnCustomizeMenu	Permite que o botão modifique o menu fornecido quando o aplicativo exibe um menu de atalho na barra de ferramentas pai.
CMFCToolBarButton::OnDblClk	Chamado pela estrutura quando a barra de ferramentas pai manipular uma mensagem de WM_LBUTTONDBLCLK .
CMFCToolBarButton::OnDraw	Chamado pela estrutura para desenhar o botão usando os estilos e opções especificadas.
CMFCToolBarButton::OnDrawOnCustomizeList	Chamado pela estrutura para desenhar o botão no painel de Comandos da caixa de diálogo de Personalizar .
CMFCToolBarButton::OnGetCustomToolTipText	Chamado pela estrutura para recuperar o texto personalizado de dica de ferramenta para o botão.
CMFCToolBarButton::OnGlobalFontsChanged	Chamado pela estrutura quando a fonte global alterar.
CMFCToolBarButton::OnMove	Chamado pela estrutura quando a barra de ferramentas pai mover.
CMFCToolBarButton::OnShow	Chamado pela estrutura quando o botão se torna visível ou invisível.
CMFCToolBarButton::OnSize	Chamado pela estrutura quando a barra de ferramentas pai se altera sua posição e tamanho ou essa alteração requerem o botão alterar o tamanho.
CMFCToolBarButton::OnToolHitTest	Chamado pela estrutura quando a barra de ferramentas pai deve determinar se um ponto está no retângulo delimitador do botão.
CMFCToolBarButton::OnUpdateToolTip	Chamado pela estrutura quando a barra de ferramentas pai atualizar o texto de tooltip.
CMFCToolBarButton::PrepareDrag	Chamado pela estrutura quando o botão é o ponto de executar uma operação de arrastar e soltar.
CMFCToolBarButton::Rect	Recupera o retângulo delimitador do botão.
CMFCToolBarButton::ResetImageToDefault	Defina o valor padrão a imagem que está associada com o botão.
CMFCToolBarButton::SaveBarState	Salvar o estado do botão da barra de ferramentas.
CMFCToolBarButton::Serialize	Este objeto ler de um arquivo ou neutro o grava em um arquivo neutro. Overrides ( CObject::Serialize.)
CMFCToolBarButton::SetACCData	Preenche o objeto fornecido de CAccessibilityData com dados de acessibilidade do botão da barra de ferramentas.
CMFCToolBarButton::SetClipboardFormatName	Renomeie o formato global da área de transferência.
CMFCToolBarButton::SetImage	Define o índice de imagem do botão.
CMFCToolBarButton::SetProtectedCommands	Define a lista de comandos que o usuário não pode personalizar.
CMFCToolBarButton::SetRadio	Chamado pela estrutura quando um botão mude seu estado selecionado.
CMFCToolBarButton::SetRect	Define o retângulo delimitador do botão.
CMFCToolBarButton::SetStyle	Defina o estilo do botão.
CMFCToolBarButton::SetVisible	Especifica se o botão é visível.
CMFCToolBarButton::Show	Mostra ou oculta o botão.

Membros de dados

Nome	Descrição
CMFCToolBarButton::m_bImage	Especifica se uma imagem é exibida no botão.
CMFCToolBarButton::m_bText	Especifica se um rótulo de texto é exibida no botão.
CMFCToolBarButton::m_bTextBelow	Especifica se o rótulo de texto é exibida embaixo de imagem no botão.
CMFCToolBarButton::m_bUserButton	Especifica se o botão tem uma imagem definido pelo usuário.
CMFCToolBarButton::m_bWholeText	Especifica se o botão exibe seu rótulo de texto completo mesmo se não couber no retângulo delimitador.
CMFCToolBarButton::m_bWrap	Especifica se o botão próximo a um separador será colocado na próxima linha.
CMFCToolBarButton::m_bWrapText	Especifica se multi-linha rótulos de texto está habilitada.
CMFCToolBarButton::m_nID	A identificação de comando do botão.
CMFCToolBarButton::m_nStyle	O estilo do botão.
CMFCToolBarButton::m_strText	O rótulo de texto do botão.

Comentários

Um objeto de CMFCToolbarButton é um controle que reside em uma barra de ferramentas. Seu comportamento lembra a de um botão comum. Você pode atribuir uma imagem e um rótulo de texto para este objeto. Um botão na barra de ferramentas também pode ter uma identificação de comando Quando o usuário clica no botão da barra de ferramentas, a estrutura executa o comando que essa identificação especificar.

Normalmente, os botões da barra de ferramentas podem ser personalizados: o usuário pode arrastar os botões da barra de ferramentas para outra, e colar, copiar, excluir, editar e rótulos e imagens de texto. Para impedir que o usuário personaliza a barra de ferramentas, você pode bloquear a barra de ferramentas de duas maneiras. Ou define o parâmetro de bLocked a TRUE quando você chama CMFCToolBar::LoadToolBar, ou adiciona a identificação de comando de um botão individual para a lista global de comandos protegidos usando o método de CMFCToolBarButton::SetProtectedCommands .

Imagens de exibição de objetos deCMFCToolBarButton das coleções globais da barra de ferramentas imagens no aplicativo. Essas coleções são mantidas pela barra de ferramentas pai, Classe CMFCToolBar. Para mais informações, consulte Classe CMFCToolBarImages.

Quando o usuário clica em um botão da barra de ferramentas, sua barra de ferramentas pai processa a mensagem de mouse e comunica as ações apropriadas para o botão. Se o botão tem um identificador válido de comando, a barra de ferramentas pai envia a mensagem de WM_COMMAND para o elemento pai.

A classe de CMFCToolBarButton é a classe base para outras classes de botão da barra de ferramentas, como Classe CMFCToolBarMenuButton, Classe CMFCToolBarEditBoxButton, e Classe CMFCToolBarComboBoxButton.

Exemplo

O exemplo a seguir demonstra como configurar um objeto de CMFCToolBarButton usando vários métodos na classe de CMFCToolBarButton . O exemplo ilustra como habilitar a entrada de mouse e teclado, defina o índice da imagem do botão, defina o retângulo delimitador do botão, e fazer o botão visível. Este trecho de código é parte de Exemplo de controle da guia.

 CMFCToolBarButton* pOffice2007 = NULL;
    int nIndex = -1;
    
    for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
    {
        // CMFCToolBar  m_wndToolBarTheme
        nIndex = m_wndToolBarTheme.CommandToIndex (uiCmd);

        CMFCToolBarButton* pButton = m_wndToolBarTheme.GetButton (nIndex);
    
        if (pButton != NULL)
        {
            pOffice2007 = pButton;
            break;
        }
    }


...


    pOffice2007->EnableWindow();
    pOffice2007->SetImage(1);
    pOffice2007->SetRect( CRect(1,1,1,1));
    pOffice2007->SetVisible();
    pOffice2007->Show(true);