Classe CMFCToolBarButton

Artigo
08/25/2010

Fornece a funcionalidade botão em barras de ferramentas.

class CMFCToolBarButton : public CObject

Membros

Construtores públicos

Nome	Descrição
CMFCToolBarButton::CMFCToolBarButton	Cria e inicializa um CMFCToolBarButton objeto.
CMFCToolBarButton::~CMFCToolBarButton	Destruidor.

Métodos públicos

Nome	Descrição
CMFCToolBarButton::CanBeDropped	Especifica se um usuário pode posicionar um botão em uma barra de ferramentas ou menu durante a personalização.
CMFCToolBarButton::CanBeStored	Especifica se o botão pode ser armazenado.
CMFCToolBarButton::CanBeStretched	Especifica se um usuário pode alongar o botão durante a personalização.
CMFCToolBarButton::CompareWith	Compara essa instância com o fornecidoCMFCToolBarButton objeto.
CMFCToolBarButton::CopyFrom	Copia as propriedades de outro botão de barra de ferramentas do botão corrente.
CMFCToolBarButton::CreateFromOleData	Cria um CMFCToolBarButton objeto fornecida COleDataObject objeto.
CMFCToolBarButton::CreateObject	Usados pela estrutura para criar uma instância desse tipo de classe dinâmica.
CMFCToolBarButton::EnableWindow	Ativa ou desativa a entrada de teclado e mouse.
CMFCToolBarButton::ExportToMenuButton	Cópias de texto de botão de barra de ferramentas a um menu.
CMFCToolBarButton::GetClipboardFormat	Recupera o formato de área de trabalho global para o aplicativo.
CMFCToolBarButton::GetHwnd	Recupera o identificador de janela que está associado com botão de barra de ferramentas.
CMFCToolBarButton::GetImage	Recupera o índice de imagem do botão.
CMFCToolBarButton::GetInvalidateRect	Recupera a região da área de 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 é possível personalizar.
CMFCToolBarButton::GetTextSize	Recupera o dimensionar do texto do botão.
CMFCToolBarButton::HasFocus	Determina se o botão tem o foco de entrada corrente.
CMFCToolBarButton::HaveHotBorder	Determina se uma borda do botão é exibida quando um usuário seleciona o botão.
CMFCToolBarButton::IsDrawImage	Determina se uma imagem é exibida no botão.
CMFCToolBarButton::IsDrawText	Determina se um rótulo de texto é exibido 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 estendida.
CMFCToolBarButton::IsFirstInGroup	Determina se o botão está na primeira posição no seu agrupar 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 na última posição no seu agrupar de botões.
CMFCToolBarButton::IsLocked	Determina se o botão está em uma barra de ferramentas (não personalizável) bloqueada.
CMFCToolBarButton::IsOwnerOf	Determina se o botão é o proprietário do identificador de janela fornecido.
CMFCToolBarButton::IsVisible	Determina se botão de barra de ferramentas está visível.
CMFCToolBarButton::IsWindowVisible	Determina se o identificador da janela subjacente do botão é visível.
CMFCToolBarButton::NotifyCommand	Especifica se o botão processa o WM_COMMAND mensagem.
CMFCToolBarButton::OnAddToCustomizePage	Chamado pela estrutura quando o botão é adicionado a um Personalizar caixa de diálogo.
CMFCToolBarButton::OnBeforeDrag	Especifica se o botão pode ser arrastado.
CMFCToolBarButton::OnBeforeDrop	Especifica se um usuário pode soltar o botão para a barra de ferramentas de destino.
CMFCToolBarButton::OnCalculateSize	Chamado pela estrutura para calcular o dimensionar do botão para o contexto de dispositivo especificado e o estado de encaixe.
CMFCToolBarButton::OnCancelMode	Chamada pela estrutura para lidar com o WM_CANCELMODE mensagem.
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 libera o botão do mouse.
CMFCToolBarButton::OnContextHelp	Chamado pela estrutura quando a barra de ferramentas pai manipula um WM_HELPHITTEST mensagem.
CMFCToolBarButton::OnCtlColor	Chamado pela estrutura quando a barra de ferramentas pai manipula um WM_CTLCOLOR mensagem.
CMFCToolBarButton::OnCustomizeMenu	Permite que o botão para modificar o menu fornecido quando o aplicativo exibe um menu de atalho na barra de ferramentas da pai.
CMFCToolBarButton::OnDblClk	Chamado pela estrutura quando a barra de ferramentas pai manipula um WM_LBUTTONDBLCLK mensagem.
CMFCToolBarButton::OnDraw	Chamado pela estrutura para desenhar o botão usando estilos especificados e opções.
CMFCToolBarButton::OnDrawOnCustomizeList	Chamada pela estrutura para desenhar o botão no Comandos painel do Personalizar caixa de diálogo.
CMFCToolBarButton::OnGetCustomToolTipText	Chamado pela estrutura para recuperar o texto de dica de ferramenta personalizada para o botão.
CMFCToolBarButton::OnGlobalFontsChanged	Chamado pela estrutura quando a fonte global foi alterada.
CMFCToolBarButton::OnMove	Chamado pela estrutura quando move a barra de ferramentas do pai.
CMFCToolBarButton::OnShow	Chamado pela estrutura quando o botão ficará visível ou invisível.
CMFCToolBarButton::OnSize	Chamado pela estrutura quando a barra de ferramentas pai altera seu dimensionar ou posição e essa alteração exige que o botão para alterar o dimensionar.
CMFCToolBarButton::OnToolHitTest	Chamado pela estrutura quando a barra de ferramentas pai deve determinar se um ponto é no retângulo delimitador do botão.
CMFCToolBarButton::OnUpdateToolTip	Chamado pela estrutura quando a barra de ferramentas pai atualiza seu texto de dica de ferramenta.
CMFCToolBarButton::PrepareDrag	Chamado pela estrutura quando o botão está prestes a executar uma operação de do tipo arrastar e soltar.
CMFCToolBarButton::Rect	Recupera o retângulo delimitador do botão.
CMFCToolBarButton::ResetImageToDefault	Configura o valor padrão a imagem que está associada com o botão.
CMFCToolBarButton::SaveBarState	Salva o estado do botão de barra de ferramentas.
CMFCToolBarButton::Serialize	Lê este objeto de um arquivar ou grava em um sistema de arquivar.(Substitui CObject::Serialize.)
CMFCToolBarButton::SetACCData	Preenche o fornecidoCAccessibilityData objeto com dados de acessibilidade do botão de barra de ferramentas.
CMFCToolBarButton::SetClipboardFormatName	Renomeia o formato de área de trabalho global.
CMFCToolBarButton::SetImage	Define o índice de imagem do botão.
CMFCToolBarButton::SetProtectedCommands	Define a lista de comandos que o usuário não é possível personalizar.
CMFCToolBarButton::SetRadio	Chamado pela estrutura quando um botão muda seu estado selecionado.
CMFCToolBarButton::SetRect	Define o retângulo delimitador do botão.
CMFCToolBarButton::SetStyle	Define o estilo do botão.
CMFCToolBarButton::SetVisible	Especifica se o botão estará 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 é exibido no botão.
CMFCToolBarButton::m_bTextBelow	Especifica se o rótulo de texto é exibido embaixo da imagem do botão.
CMFCToolBarButton::m_bUserButton	Especifica se o botão tem uma imagem definida pelo usuário.
CMFCToolBarButton::m_bWholeText	Especifica se o botão exibe seu rótulo de texto completo, mesmo se ele não se ajuste no retângulo delimitador.
CMFCToolBarButton::m_bWrap	Especifica se o botão ao lado de um separador será colocado na próxima linha.
CMFCToolBarButton::m_bWrapText	Especifica se rótulos de várias linhas de texto estão habilitados.
CMFCToolBarButton::m_nID	A ID de comando do botão.
CMFCToolBarButton::m_nStyle	Estilo do botão.
CMFCToolBarButton::m_strText	O rótulo de texto do botão.

Comentários

A CMFCToolbarButton objeto é um controle que reside em uma barra de ferramentas. Seu comportamento é semelhante a que um botão comum.Você pode atribuir uma imagem e um rótulo de texto para este objeto.Um botão de barra de ferramentas também pode ter uma ID de comando.Quando o usuário clica no botão de barra de ferramentas, a estrutura executará o comando que especifica esse ID.

Normalmente, os botões da barra de ferramentas podem ser personalizados: o usuário pode arrastar os botões de uma barra de ferramentas para outro e copiar, colar, excluir e edição rótulos de texto e imagens.Para impedir que o usuário personalizar a barra de ferramentas, você pode bloquear a barra de ferramentas de duas maneiras.conjunto o bLocked sinalizar para TRUE Quando você telefonar CMFCToolBar::LoadToolBar, ou adicionar a ID de comando de um botão individual a lista global de comandos protegidos usando o CMFCToolBarButton::SetProtectedCommands método.

CMFCToolBarButton objetos display images from coleções global de barra de ferramentas imagens do aplicativo. Essas coleções são mantidas pelo pai barra de ferramentas, Classe CMFCToolBar. Para obter mais informações, consulte Classe CMFCToolBarImages.

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

The CMFCToolBarButton classe é a classe base para outras classes de botão de barra de ferramentas, sistema autônomo Classe CMFCToolBarMenuButton, Classe CMFCToolBarEditBoxButton, e Classe CMFCToolBarComboBoxButton.

Exemplo

O exemplo a seguir demonstra como configurar um CMFCToolBarButton objeto usando vários métodos no CMFCToolBarButton classe. O exemplo ilustra como habilitar o mouse e as entradas do teclado, conjunto o índice de imagem do botão, defina o retângulo delimitador do botão e tornar visível o botão.Neste trecho de código faz parte o Exemplo do TabControl: controle guia Aplicativo MFC.

   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);

Hierarquia de herança

CObject

CMFCToolBarButton

Requisitos

Cabeçalho: afxtoolbarbutton.h

Consulte também

Partilhar via