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
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de