Partilhar via


Classe CMFCToolBarButton

Fornece funcionalidade de botão para barras de ferramentas.

Sintaxe

class CMFCToolBarButton : public CObject

Membros

Construtores públicos

Nome Descrição
CMFCToolBarButton::CMFCToolBarButton Constrói e inicializa um objeto CMFCToolBarButton.
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 no 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 objeto CMFCToolBarButton fornecido.
CMFCToolBarButton::CopyFrom Copia as propriedades de outro botão de barra de ferramentas para o botão atual.
CMFCToolBarButton::CreateFromOleData Gera um objeto CMFCToolBarButton do COleDataObject fornecido.
CMFCToolBarButton::CreateObject Usado pela estrutura para criar uma instância dinâmica desse tipo de classe.
CMFCToolBarButton::EnableWindow Habilita ou desabilita a entrada de mouse e teclado.
CMFCToolBarButton::ExportToMenuButton Copia o texto do botão de barra de ferramentas para um menu.
CMFCToolBarButton::GetClipboardFormat Recupera o formato da área de transferência global para o aplicativo.
CMFCToolBarButton::GetHwnd Recupera o identificador de janela associado ao botão de barra de ferramentas.
CMFCToolBarButton::GetImage Recupera o índice da imagem do botão.
CMFCToolBarButton::GetInvalidateRect Recupera a região da área de cliente do botão que deve ser redesenhada.
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 Recupera 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 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 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 última posição em seu grupo de botões.
CMFCToolBarButton::IsLocked Determina se o botão está em uma barra de ferramentas bloqueada (não personalizável).
CMFCToolBarButton::IsOwnerOf Determina se o botão é o proprietário do identificador de janela fornecido.
CMFCToolBarButton::IsVisible Determina se o botão de barra de ferramentas está visível.
CMFCToolBarButton::IsWindowVisible Determina se o identificador da janela subjacente do botão está visível.
CMFCToolBarButton::NotifyCommand Especifica se o botão processa a mensagem WM_COMMAND.
CMFCToolBarButton::OnAddToCustomizePage Chamado pela estrutura quando o botão é adicionado a uma caixa de diálogo 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 do dispositivo e o estado de encaixe especificados.
CMFCToolBarButton::OnCancelMode Chamado pela estrutura para lidar com a mensagem 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 libera o botão do mouse.
CMFCToolBarButton::OnContextHelp Chamado pela estrutura quando a barra de ferramentas pai manipula uma mensagem WM_HELPHITTEST.
CMFCToolBarButton::OnCtlColor Chamado pela estrutura quando a barra de ferramentas pai manipula uma mensagem 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 manipula uma mensagem WM_LBUTTONDBLCLK.
CMFCToolBarButton::OnDraw Chamado pela estrutura para desenhar o botão usando os estilos e as opções especificados.
CMFCToolBarButton::OnDrawOnCustomizeList Chamado pela estrutura para desenhar o botão no painel Comandos da caixa de diálogo Personalizar.
CMFCToolBarButton::OnGetCustomToolTipText Chamado pela estrutura para recuperar o texto da dica de ferramenta personalizado para o botão.
CMFCToolBarButton::OnGlobalFontsChanged Chamado pela estrutura quando a fonte global foi alterada.
CMFCToolBarButton::OnMove Chamado pela estrutura quando a barra de ferramentas pai se move.
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 altera seu tamanho ou posição e essa alteração requer que o botão altere 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 atualiza o texto da dica de ferramenta.
CMFCToolBarButton::PrepareDrag Chamado pela estrutura quando o botão está prestes a executar uma operação do tipo "arrastar e soltar".
CMFCToolBarButton::Rect Recupera o retângulo delimitador do botão.
CMFCToolBarButton::ResetImageToDefault Define como o valor padrão a imagem associada ao botão.
CMFCToolBarButton::SaveBarState Salva o estado do botão de barra de ferramentas.
CMFCToolBarButton::Serialize Lê esse objeto de um arquivo morto ou grava-o em um arquivo morto. (Substitui CObject::Serialize.)
CMFCToolBarButton::SetACCData Preenche o objeto CAccessibilityData fornecido com os dados de acessibilidade do botão de barra de ferramentas.
CMFCToolBarButton::SetClipboardFormatName Renomeia o formato da área de transferência global.
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 altera seu estado verificado.
CMFCToolBarButton::SetRect Define o retângulo delimitador do botão.
CMFCToolBarButton::SetStyle Define o estilo de um botão.
CMFCToolBarButton::SetVisible Especifica se o botão está 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 sob a imagem no 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 que não se encaixe 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 os rótulos de texto de várias linhas estão habilitados.
CMFCToolBarButton::m_nID A ID 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 CMFCToolbarButton é um controle que reside em uma barra de ferramentas. Seu comportamento se assemelha ao de um botão comum. Você pode atribuir uma imagem e um rótulo de texto a 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 executa o comando especificado por essa ID.

Normalmente, os botões da barra de ferramentas podem ser personalizados: o usuário pode arrastar botões de uma barra de ferramentas para outra e copiar, colar, excluir e editar rótulos e imagens de texto. Para impedir que o usuário personalize a barra de ferramentas, você pode bloqueá-la de duas maneiras. Defina o sinalizador bLocked como TRUE quando você chamar CMFCToolBar::LoadToolBar ou adicione a ID de comando de um botão individual à lista global de comandos protegidos usando o método CMFCToolBarButton::SetProtectedCommands.

Os objetos CMFCToolBarButton exibem imagens das coleções globais de imagens da barra de ferramentas no aplicativo. Essas coleções são mantidas pela barra de ferramentas pai, classe CMFCToolBar. Para mais informações, confira a 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 comunica as ações apropriadas ao botão. Se o botão tiver uma ID de comando válida, a barra de ferramentas pai enviará a mensagem WM_COMMAND para o quadro pai.

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

Exemplo

O exemplo a seguir demonstra como configurar um objeto CMFCToolBarButton usando vários métodos na classe CMFCToolBarButton. O exemplo ilustra como habilitar a entrada do mouse e do teclado, definir o índice de imagem do botão, definir o retângulo delimitador do botão e tornar o botão visível. Esse snippet de código faz parte do exemplo de Controle 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);

Hierarquia de herança

CObject

CMFCToolBarButton

Requisitos

Cabeçalho: afxtoolbarbutton.h

CMFCToolBarButton::CanBeDropped

Especifica se um usuário pode posicionar um botão em uma barra de ferramentas ou no menu durante a personalização.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

Parâmetros

pToolbar
[in] Não é usado.

Valor de retorno

Esse método retorna TRUE.

Comentários

Por padrão, um botão de barra de ferramentas pode ser removido em cada barra de ferramentas personalizável (ou seja, não bloqueada).

A implementação padrão desse método retorna TRUE. Substitua esse método e retorne FALSE se você quiser impedir que o usuário reposicione o botão.

CMFCToolBarButton::CanBeStored

Determina se o botão pode ser armazenado.

virtual BOOL CanBeStored() const;

Valor de retorno

Esse método retorna TRUE.

Comentários

A estrutura usa esse método para determinar se o botão pode participar de uma operação do tipo "arrastar e soltar".

A implementação padrão retorna TRUE. Substitua esse método se o botão não puder ser armazenado como parte de uma operação do tipo "arrastar e soltar". Para obter mais informações sobre operações do tipo "arrastar e soltar", confira Arrastar e soltar no OLE.

CMFCToolBarButton::CanBeStretched

Especifica se um usuário pode alongar o botão durante a personalização.

virtual BOOL CanBeStretched() const;

Valor de retorno

Esse método retorna FALSE.

Comentários

Esse método é usado pela estrutura para determinar se o botão pode ser estendido no modo de personalização.

A implementação padrão desse método retorna FALSE. Substitua esse método para retornar TRUE para um controle de largura variável, como uma caixa de combinação ou controle deslizante.

Para mais informações sobre o modo de personalização, confira CMFCToolBar::SetCustomizeMode.

CMFCToolBarButton::CMFCToolBarButton

Constrói e inicializa um objeto CMFCToolBarButton.

CMFCToolBarButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE,
    BOOL bLocked=FALSE);

Parâmetros

uiID
[in] A ID de comando do botão.

iImage
[in] O índice de imagem do botão na coleção de imagens.

lpszTexto
[in] O rótulo de texto do botão. Pode ser NULL.

bUserButton
[in] Um valor booliano que determina se o botão é definido pelo usuário. Se esse parâmetro for TRUE, o botão será definido pelo usuário. Caso contrário, a imagem do botão será carregada de um recurso.

bLocked
[in] Um valor booliano que determina se o botão pode ser personalizado. Se esse parâmetro for TRUE, o botão não poderá ser personalizado. Caso contrário, o botão pode ser personalizado.

CMFCToolBarButton::CompareWith

Compara essa instância com o objeto CMFCToolBarButton fornecido.

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parâmetros

other
[in] Referência ao objeto a ser comparado a essa instância.

Valor de retorno

Não zero se o objeto fornecido for igual ao valor dessa instância; caso contrário, 0.

Comentários

A implementação padrão determina se a ID de comando do objeto fornecido é igual à ID de comando dessa instância. Substitua esse método se você precisar executar processamento adicional para determinar se dois objetos CMFCToolBarButton são iguais.

CMFCToolBarButton::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.

CMFCToolBarButton::CreateFromOleData

Gera um objeto CMFCToolBarButton do COleDataObject fornecido.

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

Parâmetros

pDataObject
[in] O objeto de dados OLE de origem.

Valor de retorno

O objeto CMFCToolBarButton criado.

Comentários

Esse método é usado pela estrutura para executar a transferência de dados em vários formatos. Por exemplo, o método CMFCOutlookBarPane::OnDragOver usa esse método para executar operações do tipo "arrastar e soltar".

CMFCToolBarButton::EnableWindow

Habilita ou desabilita a entrada de mouse e teclado.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parâmetros

bEnable
[in] Defina esse parâmetro como TRUE para habilitar a entrada ou false para desabilitar a entrada.

Comentários

Esse método chama a função EnableWindow para habilitar ou desabilitar a entrada. Para mais informações, confira EnableWindow no SDK do Windows.

CMFCToolBarButton::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

Esse método retorna TRUE.

Comentários

A estrutura chama esse método para copiar o texto de um botão de barra de ferramentas para um botão de menu. A implementação padrão copia o rótulo de texto do botão. Se o rótulo de texto estiver vazio, esse método copiará o texto da dica de ferramenta do botão.

A implementação padrão desse método retorna TRUE. Substitua esse método se você quiser executar ações adicionais quando a estrutura converter um objeto derivado de CMFCToolbarButton em um botão de menu.

CMFCToolBarButton::GetClipboardFormat

Recupera o formato da área de transferência global para o aplicativo.

static CLIPFORMAT __stdcall GetClipboardFormat();

Valor de retorno

O valor CLIPFORMAT global para o aplicativo.

Comentários

A estrutura chama esse método para recuperar o formato da área de transferência para operações de transferência de dados OLE. Por exemplo, o método CMFCToolBarButton::CreateFromOleData usa esse método para copiar dados de um objeto de dados OLE de origem.

Esse método define o valor CLIPFORMAT global na primeira vez que esse método é chamado. Todas as chamadas subsequentes para esse método retornam esse valor.

Para permitir que as operações do tipo "arrastar e soltar" ocorram entre aplicativos, chame o método CMFCToolBarButton::SetClipboardFormatName.

Para mais informações sobre áreas de transferência no MFC, confira Área de Transferência.

CMFCToolBarButton::GetHwnd

Recupera o identificador de janela associado ao botão de barra de ferramentas.

virtual HWND GetHwnd();

Valor de retorno

O identificador de janela associado ao botão de barra de ferramentas ou NULL se o botão de barra de ferramentas não tiver nenhum identificador de janela associado.

Comentários

A implementação padrão desse método retorna NULL. Substitua esse método para retornar o identificador de janela do controle específico.

CMFCToolBarButton::GetImage

Recupera o índice da imagem do botão.

int GetImage() const;

Valor de retorno

O índice da imagem associada a este botão.

Comentários

Se o botão tiver uma imagem definida pelo usuário (ou seja, se bUserButton for TRUE no construtor), o índice retornado especificará uma imagem na coleção de imagens definidas pelo usuário (confira CMFCToolBar::GetUserImages). Caso contrário, o índice especificará uma imagem na coleção de imagens que são carregadas de um arquivo de recurso (confira CMFCToolBar::GetImages). Para mais informações sobre arquivos de recurso, confira Como trabalhar com arquivos de recurso.

CMFCToolBarButton::GetInvalidateRect

Recupera a região da área de cliente do botão que deve ser redesenhada.

virtual const CRect GetInvalidateRect() const;

Valor de retorno

Um objeto CRect que especifica a região que deve ser redesenhada.

Comentários

A implementação padrão desse método retorna toda a área de cliente. Substitua esse método se você quiser que uma área diferente seja redesenhada.

CMFCToolBarButton::GetParentWnd

Recupera a janela pai do botão.

CWnd* GetParentWnd() const;

Valor de retorno

A janela pai do botão.

CMFCToolBarButton::GetProtectedCommands

Recupera a lista de comandos que o usuário não pode personalizar.

static const CList<UINT,UINT>& GetProtectedCommands();

Valor de retorno

A lista de comandos protegidos.

Comentários

No modo de personalização, a estrutura desabilita comandos de botão de barra de ferramentas protegidos. O usuário não pode executar operações do tipo "arrastar e soltar" e editar em botões de barra de ferramentas desabilitados.

Use o método CMFCToolBarButton::SetProtectedCommands para definir a lista de comandos protegidos.

CMFCToolBarButton::GetTextSize

Recupera o tamanho do texto do botão.

SIZE GetTextSize() const;

Valor de retorno

Um objeto SIZE que contém o tamanho, em pixels, do texto do botão.

CMFCToolBarButton::HasFocus

Determina se o botão tem o foco de entrada atual.

virtual BOOL HasFocus() const;

Valor de retorno

Diferente de zero se o botão tiver o foco de entrada; caso contrário, 0.

Comentários

A implementação padrão desse método retornará diferente de zero se o botão tiver o foco de entrada ou for uma janela filho ou descendente da janela que tenha o foco de entrada. Você pode substituir essa função para personalizar esse comportamento.

CMFCToolBarButton::HaveHotBorder

Determina se uma borda do botão é exibida quando um usuário seleciona o botão.

virtual BOOL HaveHotBorder() const;

Valor de retorno

Esse método retorna TRUE.

Comentários

A estrutura chama esse método para determinar se o botão de barra de ferramentas deve exibir sua borda quando um usuário o seleciona.

A implementação padrão retorna TRUE. Você pode substituir esse método para personalizar esse comportamento.

CMFCToolBarButton::IsDrawImage

Determina se uma imagem é exibida no botão.

BOOL IsDrawImage() const;

Valor de retorno

Diferente de zero se uma imagem for exibida no botão; caso contrário, 0.

Comentários

Esse método retornará FALSE se o botão de barra de ferramentas não tiver nenhuma imagem associada (CMFCToolBarButton::GetImage retornar -1) ou se CMFCToolBarButton::m_bImage estiver definido como FALSE.

CMFCToolBarButton::IsDrawText

Determina se um rótulo de texto é exibido no botão.

BOOL IsDrawText() const;

Valor de retorno

Diferente de zero se um rótulo de texto for exibido; caso contrário, 0.

Comentários

Esse método retornará FALSE se o botão de barra de ferramentas não tiver um rótulo de texto associado (CMFCToolBarButton::m_strText estiver vazio) ou CMFCToolBarButton::m_bText estiver definido como FALSE.

CMFCToolBarButton::IsDroppedDown

Determina se o botão exibe um submenu.

virtual BOOL IsDroppedDown() const;

Valor de retorno

Esse método retorna FALSE.

Comentários

A implementação padrão desse método retorna FALSE. Substitua esse método para retornar TRUE se o controle exibir um submenu.

CMFCToolBarButton::IsEditable

Determina se o botão pode ser personalizado.

virtual BOOL IsEditable() const;

Valor de retorno

Diferente de zero se um botão puder ser personalizado pelo usuário; caso contrário, 0.

Comentários

A estrutura chama esse método para determinar se o usuário pode personalizar o botão de barra de ferramentas usando operações do tipo "arrastar e soltar" ou editar.

A implementação padrão retornará FALSE se a ID de comando do botão for um comando padrão (você pode determinar isso chamando a função IsStandardCommand) ou se a ID de comando estiver na lista de comandos protegidos. Para mais informações sobre comandos protegidos, confira CMFCToolBarButton::GetProtectedCommands e CMFCToolBarButton::SetProtectedCommands.

Substitua esse método para personalizar seu comportamento.

CMFCToolBarButton::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

Várias capas usam tamanho extra para as bordas dos botões da barra de ferramentas (por exemplo, botões redondos).

Se o usuário mover esse botão de uma barra de ferramentas para outra, a estrutura chamará o método CMFCToolBarButton::OnChangeParentWnd. O método CMFCToolBarButton::OnChangeParentWnd define o sinalizador de tamanho extra como o da nova barra de ferramentas pai (para mais informações, confira CMFCToolBar::IsButtonExtraSizeAvailable).

CMFCToolBarButton::IsFirstInGroup

Determina se o botão está na primeira posição em seu grupo de botões.

virtual BOOL IsFirstInGroup() const;

Valor de retorno

TRUE se o botão for o primeiro botão em seu grupo de botões; caso contrário, FALSE.

Comentários

Esse método define um grupo de botões como um conjunto vizinho de botões posicionados na mesma linha e limitados por separadores ou pela borda da barra de ferramentas. Esse método retornará FALSE se o botão de barra de ferramentas se referir ao botão Personalizar. Para mais informações sobre o botão Personalizar, confira CMFCToolBar::GetCustomizeButton.

Chame o método CMFCToolBarButton::IsLastInGroup para determinar se o botão está na última posição em seu grupo de botões.

CMFCToolBarButton::IsHidden

Determina se o botão está oculto.

BOOL IsHidden() const;

Valor de retorno

Não zero se o botão estiver oculto (invisível); caso contrário, 0.

Comentários

A estrutura chama esse método quando a barra de ferramentas pai é estendida para determinar se o botão de barra de ferramentas está visível.

Se você definir o botão como invisível usando o método CMFCToolBarButton::SetVisible, use CMFCToolBarButton::IsVisible para determinar se o botão de barra de ferramentas está visível.

Por padrão, todos os botões da barra de ferramentas ficam visíveis. Use o método CMFCToolBarButton::Show para ocultar ou mostrar botões da barra de ferramentas.

CMFCToolBarButton::IsHorizontal

Determina se o botão está localizado em uma barra de ferramentas horizontal.

BOOL IsHorizontal() const;

Valor de retorno

Não zero se um botão de barra de ferramentas estiver localizado em uma barra de ferramentas horizontal; caso contrário, 0.

Comentários

A estrutura chama esse método para determinar o layout dos botões da barra de ferramentas.

Esse método retorna o membro de dados m_bHorz. O valor padrão do membro de dados m_bHorz é TRUE; ele é redefinido em cada chamada para o método CMFCToolBarButton::OnDraw.

CMFCToolBarButton::IsLastInGroup

Especifica se o botão está na última posição em seu grupo de botões.

virtual BOOL IsLastInGroup() const;

Valor de retorno

TRUE se o botão for o último botão em seu grupo de botões; caso contrário, FALSE.

Comentários

Esse método define um grupo de botões como um conjunto vizinho de botões que estão posicionados na mesma linha e são limitados por separadores ou pela borda da barra de ferramentas Esse método retorna FALSE se o botão de barra de ferramentas não tiver nenhuma barra de ferramentas pai ou o botão de barra de ferramentas se referir ao botão Personalizar. Para mais informações sobre o botão Personalizar, confira CMFCToolBar::GetCustomizeButton.

Chame o método CMFCToolBarButton::IsFirstInGroup para determinar se o botão está na primeira posição em seu grupo de botões.

CMFCToolBarButton::IsLocked

Determina se o botão está em uma barra de ferramentas bloqueada (não personalizável).

BOOL IsLocked() const;

Valor de retorno

Não zero se o botão estiver em uma barra de ferramentas bloqueada; caso contrário, 0.

Comentários

A estrutura chama esse método para determinar se o usuário pode personalizar o botão de barra de ferramentas usando operações do tipo "arrastar e soltar" ou editar. Defina o atributo bloqueado na barra de ferramentas pai usando o método CMFCToolBar::LoadToolBar. A estrutura passa o valor desse atributo para o construtor de cada botão de barra de ferramentas (CMFCToolbarButton) que ele insere na barra de ferramentas pai.

CMFCToolBarButton::IsOwnerOf

Determina se o botão é o proprietário do identificador de janela fornecido.

virtual BOOL IsOwnerOf(HWND hwnd);

Parâmetros

hwnd
[in] Um identificador de janela.

Valor de retorno

Não zero se o botão for o proprietário do identificador de janela fornecido; caso contrário, 0.

Comentários

Esse método retornará não zero se hwnd se referir ao identificador de janela direta ou for um filho do identificador de janela associado ao botão. Esse método retornará 0 se hwnd for NULL.

CMFCToolBarButton::IsVisible

Determina se o botão de barra de ferramentas está visível.

BOOL IsVisible() const;

Valor de retorno

Não zero se o botão de barra de ferramentas estiver visível; caso contrário, 0.

Comentários

Você pode mostrar ou ocultar o botão de barra de ferramentas usando o método CMFCToolBarButton::SetVisible. Chame o método CPane::AdjustSizeImmediate na barra de ferramentas pai depois de chamar CMFCToolBarButton::SetVisible para recalcular o layout de uma barra de ferramentas pai.

CMFCToolBarButton::IsWindowVisible

Determina se o identificador da janela subjacente do botão está visível.

virtual BOOL IsWindowVisible();

Valor de retorno

Não zero se o identificador da janela subjacente do botão estiver visível; caso contrário, 0.

Comentários

Esse método retornará não zero se o atributo de estilos do identificador de janela subjacente contiver o estilo WS_VISIBLE. Esse método retornará FALSE se o identificador de janela subjacente do botão for NULL.

CMFCToolBarButton::m_bImage

Especifica se uma imagem é exibida no botão.

BOOL m_bImage;

Comentários

Se esse membro de dados estiver definido como TRUE, a estrutura exibirá a imagem associada ao botão de barra de ferramentas; caso contrário, a estrutura não exibirá a imagem. Esse membro afeta o valor retornado do método CMFCToolBarButton::m_bImage.

CMFCToolBarButton::m_bText

Especifica se um rótulo de texto é exibido no botão.

BOOL m_bText;

Comentários

Se esse membro de dados estiver definido como TRUE, a estrutura exibirá o rótulo de texto do botão de barra de ferramentas; caso contrário, a estrutura não exibirá o rótulo de texto. Esse membro afeta o valor retornado do método CMFCToolBarButton::m_bText.

CMFCToolBarButton::m_bTextBelow

Especifica se o rótulo de texto é exibido sob a imagem no botão.

BOOL m_bTextBelow;

Comentários

Se essa variável de membro for definida como TRUE, a estrutura exibirá o texto do botão abaixo da imagem. O valor padrão desse membro é FALSE.

CMFCToolBarButton::m_bUserButton

Especifica se o botão tem uma imagem definida pelo usuário

BOOL m_bUserButton;

Comentários

Esse membro de dados é definido como TRUE quando o botão tem uma imagem definida pelo usuário associada a ele.

CMFCToolBarButton::m_bWholeText

Especifica se o botão exibe seu rótulo de texto completo mesmo que não se encaixe no retângulo delimitador.

BOOL m_bWholeText;

Comentários

Se esse membro de dados estiver definido como TRUE, a estrutura exibirá o rótulo de texto completo ampliando o botão. Caso contrário, a estrutura será truncada e acrescentará uma reticências (...) ao rótulo de texto.

CMFCToolBarButton::m_bWrap

Especifica se o botão ao lado de um separador será colocado na próxima linha.

BOOL m_bWrap;

Comentários

A estrutura define esse membro de dados como TRUE quando o botão de barra de ferramentas não se encaixa na linha atual ou quando você especifica um layout (por exemplo, um número específico de botões da barra de ferramentas por linha).

A estrutura coloca esse botão na próxima linha se esse membro de dados está definido como TRUE e a barra de ferramentas está encaixada horizontalmente ou é flutuante.

O valor padrão desse membro de dados é FALSE.

CMFCToolBarButton::m_bWrapText

Especifica se os rótulos de texto de várias linhas estão habilitados.

AFX_IMPORT_DATA static BOOL m_bWrapText;

Comentários

Se essa variável de membro estático for TRUE, a estrutura permitirá que todas as barras de ferramentas exibam rótulos de texto de várias linhas nos botões da barra de ferramentas.

O valor padrão desse membro de dados é FALSE.

CMFCToolBarButton::m_nID

A ID de comando do botão.

UINT m_nID;

Comentários

Uma ID de comando de -1 indica que o botão é um separador. Todos os separadores de botão têm o estilo TBBS_SEPARATOR. Confira CMFCToolBarButton::m_nStyle para mais informações sobre estilos de botão.

CMFCToolBarButton::m_nStyle

O estilo do botão.

UINT m_nStyle;

Comentários

Confira Estilos de Controle de Barra de Ferramentas para a lista de estilos de botão de barra de ferramentas disponíveis.

CMFCToolBarButton::m_strText

O rótulo de texto do botão.

CString m_strText;

Comentários

Esse membro de dados contém o rótulo de texto do botão. O rótulo de texto pode estar vazio.

CMFCToolBarButton::NotifyCommand

Especifica se o botão processa a mensagem WM_COMMAND.

virtual BOOL NotifyCommand(int iNotifyCode);

Parâmetros

iNotifyCode
[in] A mensagem de notificação associada ao comando.

Valor de retorno

Esse método retorna FALSE.

Comentários

A estrutura chama esse método quando está prestes a enviar uma mensagem WM_COMMAND para a janela pai.

Por padrão, esse método retorna FALSE. Substitua esse método para retornar TRUE se você quiser processar a mensagem WM_COMMAND ou FALSE para indicar que a barra de ferramentas pai deve lidar com a mensagem.

CMFCToolBarButton::OnAddToCustomizePage

Chamado pela estrutura quando o botão é adicionado a uma caixa de diálogo Personalizar.

virtual void OnAddToCustomizePage();

Comentários

A implementação padrão desse método não faz nada. Substitua esse método se você quiser executar alguma ação quando o botão for adicionado a uma caixa de diálogo Personalizar.

CMFCToolBarButton::OnBeforeDrag

Especifica se o botão pode ser arrastado.

virtual BOOL OnBeforeDrag() const;

Valor de retorno

TRUE se o botão puder ser arrastado; caso contrário, FALSE.

Comentários

A estrutura chama esse método antes que o usuário comece a arrastar o botão.

A implementação padrão desse método retorna TRUE. Substitua esse método para retornar FALSE para desabilitar a arrastar do botão.

CMFCToolBarButton::OnBeforeDrop

Especifica se um usuário pode soltar o botão na barra de ferramentas de destino.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

Parâmetros

pTarget
[in] O destino da operação do tipo "arrastar e soltar".

Valor de retorno

TRUE se o botão puder ser removido para a barra de ferramentas de destino fornecida; caso contrário, FALSE.

Comentários

A estrutura chama esse método antes que o botão seja deixado na barra de ferramentas.

A implementação padrão desse método retorna TRUE. Substitua esse método para retornar FALSE para desabilitar a operação de descarte no destino especificado.

CMFCToolBarButton::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

A estrutura chama esse método para determinar o tamanho do botão de barra de ferramentas para o contexto do dispositivo especificado e o estado do encaixe.

A implementação padrão considera os tamanhos de texto e imagem (se forem exibidos), as posições de texto e imagem (o texto abaixo ou no lado direito da imagem) e o estado do encaixe da barra de ferramentas.

Substitua esse método se você quiser fornecer o tamanho de um botão não padrão (por exemplo, um botão de caixa de edição).

CMFCToolBarButton::OnCancelMode

Chamado pela estrutura para lidar com a mensagem WM_CANCELMODE.

virtual void OnCancelMode();

Comentários

A implementação padrão desse método não faz nada. Substitua esse método se você quiser lidar com a mensagem WM_CANCELMODE .

CMFCToolBarButton::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

O botão é inserido em uma barra de ferramentas, por exemplo, quando o usuário o arrasta de uma barra de ferramentas para outra barra de ferramentas.

A implementação padrão desse método não faz nada.

CMFCToolBarButton::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

Esse método retorna FALSE.

Comentários

A estrutura chama esse método quando o usuário clica no botão de barra de ferramentas.

A implementação padrão não faz nada e retorna FALSE. Substitua esse método para retornar um valor diferente de zero se o botão processar a mensagem de clique.

CMFCToolBarButton::OnClickUp

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

virtual BOOL OnClickUp();

Valor de retorno

Esse método retorna FALSE.

Comentários

A estrutura chama esse método quando o usuário libera o botão de barra de ferramentas.

A implementação padrão não faz nada e retorna FALSE. Substitua esse método para retornar um valor diferente de zero se o botão processar a mensagem de clique.

CMFCToolBarButton::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

Esse método retorna FALSE.

Comentários

A implementação padrão desse método não faz nada e retorna FALSE. Substitua esse método para retornar um valor diferente de zero se o botão processar a mensagem de ajuda.

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

CMFCToolBarButton::OnCtlColor

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

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parâmetros

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

nCtlColor
[in] A notificação de cor específica.

Valor de retorno

Um identificador para o objeto brush que a estrutura usa para pintar a tela de fundo do botão.

Comentários

A estrutura chama esse método quando a barra de ferramentas pai processa a mensagem WM_CTLCOLOR para um botão de barra de ferramentas que contém um controle do Windows. A estrutura não chamará esse método se o botão de barra de ferramentas estiver sem janelas.

A estrutura chamará esse método quando a estrutura da barra de ferramentas estiver no modo de personalização e o botão de barra de ferramentas estiver desbloqueado. Para mais informações sobre o modo de personalização, confira CMFCToolBar::SetCustomizeMode. Para mais informações sobre como bloquear botões da barra de ferramentas, confira CMFCToolBarButton::IsLocked.

A implementação padrão não faz nada e retorna NULL.

CMFCToolBarButton::OnCustomizeMenu

Permite que o botão modifique 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 FALSE.

Comentários

A implementação padrão não faz nada e retorna FALSE. Substitua esse método e retorne um valor diferente de zero se você quiser modificar o conteúdo do menu fornecido.

CMFCToolBarButton::OnDblClk

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

virtual void OnDblClk(CWnd* pWnd);

Parâmetros

pWnd
[in] – A janela pai do botão.

Comentários

Esse método é chamado pelo método CMFCToolBar::OnLButtonDblClk quando a barra de ferramentas pai manipula uma mensagem WM_LBUTTONDBLCLK.

A implementação padrão desse método não faz nada.

CMFCToolBarButton::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.

CMFCToolBarButton::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] Especifica se o botão está 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 o botão está prestes a ser exibido na caixa de listagem de desenho do proprietário.

A implementação padrão desse método exibirá a imagem e o rótulo de texto do botão se eles estiverem disponíveis. Se o rótulo de texto do botão não estiver disponível, o método exibirá o texto da dica de ferramenta.

Substitua esse método para executar o desenho personalizado.

CMFCToolBarButton::OnGetCustomToolTipText

Chamado pela estrutura para recuperar o texto da dica de ferramenta personalizado para o botão.

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

Parâmetros

strToolTip
[out] Um objeto CString que recebe o texto da dica de ferramenta personalizado.

Valor de retorno

Esse método retorna FALSE.

Comentários

A estrutura chama esse método quando exibe a dica de ferramenta para o botão de barra de ferramentas. Se esse método retornar FALSE, a estrutura usará uma dica de ferramenta padrão.

A implementação padrão não faz nada e retorna FALSE. Substitua esse método e retorne um valor diferente de zero para fornecer texto de dica de ferramenta personalizado para o botão de barra de ferramentas.

CMFCToolBarButton::OnGlobalFontsChanged

Chamado pela estrutura quando a fonte global foi alterada.

virtual void OnGlobalFontsChanged();

Comentários

A implementação padrão desse método não faz nada. Substitua esse método para atualizar a fonte usada para exibir o texto do botão.

CMFCToolBarButton::OnMove

Chamado pela estrutura quando a barra de ferramentas pai se move.

virtual void OnMove();

Comentários

A implementação padrão desse método não faz nada. Substitua esse método para reposicionar o botão quando a barra de ferramentas pai for movida.

CMFCToolBarButton::OnShow

Chamado pela estrutura quando o botão se torna visível ou invisível.

virtual void OnShow(BOOL bShow);

Parâmetros

bShow
[in] Especifica se o botão está visível. Se esse parâmetro for TRUE, o botão ficará visível. Caso contrário, o botão não ficará visível.

Comentários

A implementação padrão desse método não faz nada. Substitua esse método para atualizar a visibilidade do botão.

CMFCToolBarButton::OnSize

Chamado pela estrutura quando a barra de ferramentas pai muda de tamanho ou posição e essa alteração faz com que o botão mude de tamanho.

virtual void OnSize(int iSize);

Parâmetros

iSize
[in] A nova largura do botão.

Comentários

A implementação padrão desse método não faz nada. Substitua esse método para redimensionar o botão quando o tamanho ou a posição da barra de ferramentas pai mudar.

CMFCToolBarButton::OnToolHitTest

Chamado pela estrutura quando a barra de ferramentas pai deve determinar se um ponto está no retângulo delimitador do botão.

virtual BOOL OnToolHitTest(
    const CWnd* pWnd,
    TOOLINFO* pTI);

Parâmetros

pWnd
[in] A janela pai do botão. Pode ser NULL.

pTI
[in] Uma estrutura TOOLINFO que contém informações sobre uma ferramenta em um controle de dica de ferramenta.

Valor de retorno

O resultado de OnMenuButtonToolHitTest se o botão pode recuperar um ponteiro para a janela do quadro pai; caso contrário, FALSE.

Comentários

Esse método chamará um dos seguintes métodos se puder converter a janela pai em um objeto de quadro válido:

CMFCToolBarButton::OnUpdateToolTip

Chamado pela estrutura quando a barra de ferramentas pai atualiza o texto da dica de ferramenta.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parâmetros

pWndParent
[in] A janela pai.

iButtonIndex
[in] O índice baseado em zero do botão na coleção de botões pai.

wndToolTip
[in] O controle que exibe o texto da dica de ferramenta.

str
[out] Um objeto CString que recebe o texto da dica de ferramenta atualizado.

Valor de retorno

Esse método retorna FALSE.

Comentários

A implementação padrão desse método não faz nada e retorna FALSE. Substitua esse método para retornar um valor diferente de zero se você fornecer uma cadeia de caracteres de texto de dica de ferramenta.

CMFCToolBarButton::PrepareDrag

Chamado pela estrutura quando o botão está prestes a executar uma operação do tipo "arrastar e soltar".

virtual BOOL PrepareDrag(COleDataSource& srcItem);

Parâmetros

srcItem
[in] Um objeto COleDataSource que armazena informações de estado sobre a operação do tipo "arrastar e soltar".

Valor de retorno

TRUE se a operação for bem-sucedida; caso contrário, FALSE.

Comentários

A estrutura chama esse método para preparar o botão de barra de ferramentas para armazenar seu estado no objeto COleDataSource fornecido. Esse método armazena seu estado serializando a si mesmo em um arquivo compartilhado e então passando esse arquivo para o método COleDataSource::CacheGlobalData. Para mais informações sobre a serialização do botão de barra de ferramentas, confira CMFCToolBarButton::Serialize.

Esse método não faz nada e retorna TRUE se o botão não puder ser armazenado (o método CMFCToolBarButton::CanBeStored retorna FALSE). Ele retornará FALSE se ocorrer uma exceção durante a serialização de objeto.

Para mais informações sobre operações do tipo "arrastar e soltar" OLE, confira Arrastar e soltar do OLE.

CMFCToolBarButton::Rect

Recupera o retângulo delimitador do botão.

const CRect& Rect() const;

Valor de retorno

Um objeto CRect que contém o retângulo delimitador de um botão.

CMFCToolBarButton::ResetImageToDefault

Define como o valor padrão a imagem associada ao botão.

virtual void ResetImageToDefault();

Comentários

Esse método recupera a imagem padrão de sua barra de ferramentas pai usando o método CMFCToolBar::GetDefaultImage. Se o botão não tiver nenhuma imagem padrão associada, esse método definirá o rótulo de texto do botão de acordo com seu recurso de cadeia de caracteres usando o método CStringT::LoadString. Para mais informações sobre recursos de cadeia de caracteres, confira Como trabalhar com arquivos de recurso.

Esse método não fará nada se o botão tiver uma imagem definida pelo usuário.

CMFCToolBarButton::SaveBarState

Salva o estado do botão de barra de ferramentas.

virtual void SaveBarState();

Comentários

A estrutura chama esse método quando cria um objeto CMFCToolBarButton como resultado de uma operação do tipo "arrastar e soltar".

A implementação padrão desse método não faz nada. Substitua esse método para salvar o estado do botão de barra de ferramentas em uma fonte de dados externa.

CMFCToolBarButton::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 dá suporte a processos de transferência de dados, como área de transferência ou operações do tipo "arrastar e soltar". Ele lê ou grava propriedades do botão, como a ID, o rótulo de texto e a ID da imagem de ou para o objeto CArchive fornecido.

Para exemplos de serialização, confira Serialização: Como serializar um objeto.

CMFCToolBarButton::SetACCData

Preenche o objeto CAccessibilityData fornecido com os dados de acessibilidade do botão de barra de ferramentas.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parâmetros

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

data
[in] Um objeto CAccessibilityData que é preenchido com os dados de acessibilidade do botão de barra de ferramentas.

Valor de retorno

Esse método retorna TRUE.

Comentários

Substitua esse método para retornar FALSE se o botão de barra de ferramentas não fornecer dados de acessibilidade.

CMFCToolBarButton::SetClipboardFormatName

Renomeia o formato da área de transferência global.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

Parâmetros

lpszName
[in] O novo nome do formato da área de transferência global. Não pode ser NULL.

Comentários

Esse método possibilita que operações do tipo "arrastar e soltar" ocorram entre vários aplicativos. Cada aplicativo deve fornecer o mesmo nome de formato de área de transferência.

Você deve chamar esse método antes que a estrutura chame CMFCToolBarButton::GetClipboardFormat.

CMFCToolBarButton::SetImage

Define o índice de imagem do botão.

virtual void SetImage(int iImage);

Parâmetros

iImage
[in] O índice da imagem na coleção de imagens da barra de ferramentas.

Comentários

Se o botão de barra de ferramentas for um separador, iImage fará referência à nova largura do botão separador.

Se iImage for menor que zero, esse método desabilitará o desenho da imagem e habilitará o desenho do rótulo de texto do botão.

CMFCToolBarButton::SetProtectedCommands

Define a lista de comandos que o usuário não pode personalizar.

static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);

Parâmetros

lstCmds
[in] A lista de comandos protegidos.

Comentários

No modo de personalização, a estrutura desabilita comandos de botão de barra de ferramentas protegidos. O usuário não pode executar operações do tipo "arrastar e soltar" e editar em botões de barra de ferramentas desabilitados.

Use o método CMFCToolBarButton::GetProtectedCommands para recuperar a lista de comandos protegidos.

CMFCToolBarButton::SetRadio

Chamado pela estrutura quando um botão altera seu estado verificado.

virtual void SetRadio();

Comentários

A implementação padrão desse método não faz nada. Substitua esse método para executar uma ação personalizada quando o botão alterar o estado verificado.

CMFCToolBarButton::SetRect

Define o retângulo delimitador do botão.

void SetRect(const CRect rect);

Parâmetros

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

Comentários

Esse método chama o método CMFCToolBarButton::OnMove depois de definir o novo retângulo delimitador.

CMFCToolBarButton::SetStyle

Define o estilo de um botão.

virtual void SetStyle(UINT nStyle);

Parâmetros

nEstilo
[in] O novo estilo do botão.

Comentários

A implementação padrão define o membro de dados CMFCToolBarButton::m_nStyle como nStyle. Substitua esse método se você quiser executar processamento adicional para lidar com a alteração no estilo. Confira Estilos de Controle de Barra de Ferramentas para obter uma lista de sinalizadores de estilo válidos.

CMFCToolBarButton::SetVisible

Especifica se o botão está visível.

void SetVisible(BOOL bShow=TRUE);

Parâmetros

bShow
[in] Um valor booliano que especifica se o botão deve ser mostrado ou ocultado. Se esse parâmetro for TRUE, o botão será mostrado. Se o parâmetro for FALSE, o botão ficará oculto.

Comentários

Use essa função para ocultar ou mostrar um botão de barra de ferramentas específico. Chame o método CPane::AdjustSizeImmediate depois de chamar esse método.

CMFCToolBarButton::Show

Mostra ou oculta o botão.

void Show(BOOL bShow);

Parâmetros

bShow
[in] Um valor booliano que especifica se o botão deve ser mostrado ou ocultado. Se esse parâmetro for TRUE, o botão será mostrado. Se o parâmetro for FALSE, o botão ficará oculto.

Comentários

A estrutura chama esse método para atualizar a visibilidade dos botões da barra de ferramentas quando a barra de ferramentas pai é redimensionada. A estrutura chama esse método com bShow definido como FALSE quando o botão não se encaixa mais nos limites da barra de ferramentas. A estrutura chama esse método com bShow definido como TRUE quando, depois do redimensionamento, o botão se ajusta novamente aos limites da barra de ferramentas.

Use o método CMFCToolBarButton::SetVisible para definir a visibilidade geral do botão.

Esse método chama o método CMFCToolBarButton::OnShow depois de atualizar o estado de visibilidade do botão.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCToolBar
Classe CMFCToolBarImages