Classe de CMFCToolBar

Artigo
02/25/2013

A classe de CMFCToolBar é semelhante a Classe de CToolBar, mas fornece suporte adicional para recursos de interface do usuário.Esses incluem barras de ferramentas lisas, toolbars com imagens, ícones grandes quentes, botões de paginação, barras de ferramentas com barreira, controles do rebar em texto, imagens, imagens de plano de fundo, e barras de ferramentas com guias.A classe de CMFCToolBar também contém suporte interno para a personalização do usuário de barras de ferramentas e menus, o arrastar e soltar entre barras de ferramentas e menus, botões da caixa de combinação, botões de caixa de edição, as desbastadoras máquinas de cor, e botões de rolagem - anterior.

class CMFCToolBar : public CMFCBaseToolBar

Membros

Construtores public

Nome	Descrição
CMFCToolBar::CMFCToolBar	Construtor padrão.
CMFCToolBar::~CMFCToolBar	Destruidor.

Métodos públicos

Nome	Descrição
CMFCToolBar::AddBasicCommand	Adiciona um comando de menu à lista de comandos que são sempre exibidos quando um usuário abre um menu.
CMFCToolBar::AddCommandUsage	Sai por um contador o que está associado com o comando dado.
CMFCToolBar::AddToolBarForImageCollection	Adicionar imagens dos recursos de interface do usuário à coleção de imagens no aplicativo.
CMFCToolBar::AdjustLayout	Recalcula o tamanho e a posição de uma barra de ferramentas.Overrides ( CBasePane::AdjustLayout).
CMFCToolBar::AdjustSize	Recalcula o tamanho da barra de ferramentas.
CMFCToolBar::AllowChangeTextLabels	Especifica se os rótulos de texto podem ser mostradas em imagens nos botões da barra de ferramentas.
CMFCToolBar::AreTextLabels	Especifica se os rótulos de texto em imagens são exibidas atualmente nos botões da barra de ferramentas.
CMFCToolBar::AutoGrayInactiveImages	Ativar ou desativa verificação que a geração automática de botão inativo imagens.
CMFCToolBar::ButtonToIndex	Retorna o índice de um objeto especificado de Classe de CMFCToolBarButton na barra de ferramentas.
CMFCToolBar::CalcFixedLayout	Calcula o tamanho horizontal da barra de ferramentas.Overrides ( CBasePane::CalcFixedLayout.)
CMFCToolBar::CalcSize	Chamado pela estrutura como parte do processo de cálculo de layout.Overrides ( CPane::CalcSize.)
CMFCToolBar::CanHandleSiblings	Determina se a barra de ferramentas e seu irmão são posicionados no mesmo painel.
CMFCToolBar::CleanUpImages	Libera os recursos do sistema atribuídos para imagens da barra de ferramentas.
CMFCToolBar::CleanUpLockedImages	Libera os recursos do sistema atribuídos para imagens com barreira da barra de ferramentas.
CMFCToolBar::CanBeClosed	Especifica se um usuário pode fechar a barra de ferramentas.Overrides ( CBasePane::CanBeClosed.)
CMFCToolBar::CanBeRestored	Determina se o sistema pode restaurar uma barra de ferramentas para seu estado original após a personalização.
CMFCToolBar::CanFocus	Especifica se o painel pode receber o foco.Overrides ( CBasePane::CanFocus.)
CMFCToolBar::CanHandleSiblings	Determina se a barra de ferramentas e seu irmão são posicionados no mesmo painel.
CMFCToolBar::CommandToIndex	Retorna o índice de botão na barra de ferramentas com um certo ID de comando
CMFCToolBar::Create	Cria um objeto de CMFCToolBar .
CMFCToolBar::CreateEx	Cria um objeto de CMFCToolBar que use opções adicionais de estilo, como ícones grandes.
CMFCToolBar::Deactivate	Desativa a barra de ferramentas.
CMFCToolBar::EnableCustomizeButton	Habilita ou desabilita o botão de Adicionar ou Remover Botões que aparece no final da barra de ferramentas.
CMFCToolBar::EnableDocking	Permite que o encaixe do painel para o quadro chave.Overrides ( CBasePane::EnableDocking.)
CMFCToolBar::EnableLargeIcons	Habilita ou desabilita ícones grandes nos botões da barra de ferramentas.
CMFCToolBar::EnableQuickCustomization	Habilita ou desabilita a personalização rápido de barras de ferramentas para que o usuário pode pressionar a tecla de Alt e arraste um botão para um novo local.
CMFCToolBar::EnableReflections	Habilita ou reflexo de comando desativa.
CMFCToolBar::EnableTextLabels	Habilita ou desabilita rótulos de texto em imagens do botão da barra de ferramentas.
CMFCToolBar::FromHandlePermanent	Recupera um ponteiro para o objeto de CMFCToolBar que contém o identificador de janela dado.
CMFCToolBar::GetAllButtons	Retorna uma lista somente leitura de botões na barra de ferramentas.
CMFCToolBar::GetAllToolbars	Retorna uma lista somente leitura de todas as barras de ferramentas para o aplicativo.
CMFCToolBar::GetBasicCommands	Retorna uma lista somente leitura de comandos básicos definidos no aplicativo.
CMFCToolBar::GetButton	Retorna um ponteiro para o objeto de CMFCToolBarButton que possui um índice especificado do botão da barra de ferramentas.
CMFCToolBar::GetButtonInfo	Retorna a identificação de comando, o estilo, e o índice da imagem de botão em um índice especificado.
CMFCToolBar::GetButtonSize	Retorna as dimensões de cada botão na barra de ferramentas.
CMFCToolBar::GetButtonStyle	Retorna o estilo atual do botão da barra de ferramentas que está localizado no índice especificado.
CMFCToolBar::GetButtonText	Retorna o rótulo de texto de um botão que possui um índice especificado.
CMFCToolBar::GetColdImages	Retorna um ponteiro para a coleção de imagens frias do botão da barra de ferramentas para o aplicativo.
CMFCToolBar::GetColumnWidth	Retorna a largura dos botões da barra de ferramentas.
CMFCToolBar::GetCommandButtons	Retorna uma lista de botões que têm uma identificação especificado de comando de todas as barras de ferramentas para o aplicativo.
CMFCToolBar::GetCount	Retorna o número de botões e separadores da barra de ferramentas.
CMFCToolBar::GetCustomizeButton	Recupera um ponteiro para o objeto de CMFCCustomizeButton que está associado com a barra de ferramentas.
CMFCToolBar::GetDefaultImage	Retorna o índice da imagem padrão para um botão da barra de ferramentas com um certo ID de comando
CMFCToolBar::GetDisabledImages	Retorna um ponteiro para a coleção de imagens que são usadas para os botões da barra de ferramentas desativados no aplicativo.
CMFCToolBar::GetDisabledMenuImages	Retorna um ponteiro para a coleção de imagens que são usadas para os botões desativados no menu no aplicativo.
CMFCToolBar::GetDroppedDownMenu	Recupera um ponteiro para o objeto botão de menu que está exibindo atualmente o submenu.
CMFCToolBar::GetGrayDisabledButtons	Especifica se as imagens dos botões estão desativados versões permanecerá esmaecido imagens normais do botão, ou extraído da coleção do botão desativado imagens.
CMFCToolBar::GetHighlightedButton	Retorna um ponteiro para o botão da barra de ferramentas que é realçado no momento.
CMFCToolBar::GetHotBorder	Determina se os botões da barra de ferramentas quente- são rastreadas.
CMFCToolBar::GetHotTextColor	Retorna a cor do texto dos botões da barra de ferramentas realçadas.
CMFCToolBar::GetHwndLastFocus	Retorna um identificador para a janela que tem o foco de entrada imediatamente antes da barra de ferramentas fez.
CMFCToolBar::GetIgnoreSetText	Especifica se chamadas aos rótulos de conjunto de botões são ignorados.
CMFCToolBar::GetImageSize	Retorna o tamanho atual de imagens do botão da barra de ferramentas.
CMFCToolBar::GetImages	Retorna um ponteiro para a coleção de imagens do botão padrão no aplicativo.
CMFCToolBar::GetImagesOffset	Retorna o deslocamento do índice usado para localizar as imagens do botão da barra de ferramentas para a barra de ferramentas para a lista global de imagens do botão da barra de ferramentas.
CMFCToolBar::GetInvalidateItemRect	Recupera a região da área cliente que deve ser redesenhada no botão no índice especificado.
CMFCToolBar::GetItemID	Retorna a identificação de comando do botão da barra de ferramentas em um índice especificado.
CMFCToolBar::GetItemRect	Retorna o retângulo delimitador de botão em um índice especificado.
CMFCToolBar::GetLargeColdImages	Retorna um ponteiro para a coleção de grandes imagens frias do botão da barra de ferramentas para o aplicativo.
CMFCToolBar::GetLargeDisabledImages	Retorna um ponteiro para a coleção de imagens grandes desativados do botão da barra de ferramentas para o aplicativo.
CMFCToolBar::GetLargeImages	Retorna um ponteiro para a coleção de grandes imagens do botão da barra de ferramentas para o aplicativo.
CMFCToolBar::GetLockedColdImages	Retorna um ponteiro para a coleção de imagens frias bloqueados na barra de ferramentas.
CMFCToolBar::GetLockedDisabledImages	Retorna um ponteiro para a coleção de imagens com barreira desativado na barra de ferramentas.
CMFCToolBar::GetLockedImages	Retorna um ponteiro para a coleção de imagens com barreira de botão na barra de ferramentas.
CMFCToolBar::GetLockedImageSize	Retorna o tamanho padrão de imagens com barreira da barra de ferramentas.
CMFCToolBar::GetLockedMenuImages	Retorna um ponteiro para a coleção de imagens com barreira de menu da barra de ferramentas na barra de ferramentas.
CMFCToolBar::GetMenuButtonSize	Retorna o tamanho dos botões de menu no aplicativo.
CMFCToolBar::GetMenuImageSize	Retorna o tamanho de imagens do botão de menu no aplicativo.
CMFCToolBar::GetMenuImages	Retorna um ponteiro para a coleção de imagens do botão de menu no aplicativo.
CMFCToolBar::GetOrigButtons	Recupera a coleção de botões não personalizados da barra de ferramentas.
CMFCToolBar::GetOrigResetButtons	Recupera a coleção de botões de reinicialização não personalizados da barra de ferramentas.
CMFCToolBar::GetResourceID	Recupera a identificação de recurso da barra de ferramentas.
CMFCToolBar::GetRouteCommandsViaFrame	Determina qual objeto, o elemento pai ou o proprietário, envia comandos para a barra de ferramentas.
CMFCToolBar::GetRowHeight	Retorna a altura dos botões da barra de ferramentas.
CMFCToolBar::GetShowTooltips	Especifica se as dicas de ferramenta são exibidas para os botões da barra de ferramentas.
CMFCToolBar::GetSiblingToolBar	Recupera o irmão da barra de ferramentas.
CMFCToolBar::GetUserImages	Retorna um ponteiro para a coleção de imagens definidas pelo usuário do botão da barra de ferramentas para o aplicativo.
CMFCToolBar::HitTest	Retorna o índice do botão da barra de ferramentas que está localizado na posição especificada.
CMFCToolBar::InsertButton	Insere um botão na barra de ferramentas.
CMFCToolBar::InsertSeparator	Insere um separador na barra de ferramentas.
CMFCToolBar::InvalidateButton	Invalida a área cliente do botão da barra de ferramentas que existe no índice fornecido.
CMFCToolBar::IsAddRemoveQuickCustomize	Determina se um usuário pode adicionar ou remover os botões da barra de ferramentas usando a opção de menu de Personalizar .
CMFCToolBar::IsAltCustomizeMode	Especifica se a personalização rápido sendo usado para arrastar um botão.
CMFCToolBar::IsAutoGrayInactiveImages	Especifica se a geração automática de imagens (não) realçadas inativos do botão está habilitado.
CMFCToolBar::IsBasicCommand	Determina se um comando está na lista de comandos básicos.
CMFCToolBar::IsButtonExtraSizeAvailable	Determina se a barra de ferramentas pode exibir botões que estenderam bordas.
CMFCToolBar::IsButtonHighlighted	Determina se um botão na barra de ferramentas é realçado.
CMFCToolBar::IsCommandPermitted	Determina se um comando é permitido.
CMFCToolBar::IsCommandRarelyUsed	Determina se um comando é raramente usados (consulte CMFCToolBar::SetCommandUsageOptions).
CMFCToolBar::IsCustomizeMode	Especifica se a estrutura da barra de ferramentas está no modo de personalização.
CMFCToolBar::IsDragButton	Determina se um botão da barra de ferramentas está sendo arrastado.
CMFCToolBar::IsExistCustomizeButton	Determina se a barra de ferramentas contém o botão de Personalizar .
CMFCToolBar::IsFloating	Determina se a barra de ferramentas está flutuantes.
CMFCToolBar::IsLargeIcons	Especifica se as barras de ferramentas para o aplicativo atualmente exibe ícones grandes.
CMFCToolBar::IsLastCommandFromButton	Determina se o comando recentemente executado foi enviado do botão da barra de ferramentas especificado.
CMFCToolBar::IsLocked	Determina se a barra de ferramentas é bloqueada.
CMFCToolBar::IsOneRowWithSibling	Determina se a barra de ferramentas e sua barra de ferramentas irmãos são posicionadas na mesma linha.
CMFCToolBar::IsUserDefined	Especifica se a barra de ferramentas é definido pelo usuário.
CMFCToolBar::LoadBitmap	Imagens da barra de ferramentas carrega os recursos do aplicativo.
CMFCToolBar::LoadBitmapEx	Imagens da barra de ferramentas carrega os recursos do aplicativo.Inclui grandes imagens.
CMFCToolBar::LoadParameters	Carrega opções globais da barra de ferramentas de Registro do Windows.
CMFCToolBar::LoadState	Carregar informações de estado da barra de ferramentas de Registro do Windows.Overrides ( CPane::LoadState.)
CMFCToolBar::LoadToolBar	Carrega a barra de ferramentas os recursos do aplicativo.
CMFCToolBar::LoadToolBarEx	Carrega a barra de ferramentas os recursos do aplicativo usando a classe auxiliar de CMFCToolBarInfo para ativar o aplicativo para usar imagens grandes.
CMFCToolBar::OnChangeHot	Chamado pela estrutura quando um usuário seleciona um botão na barra de ferramentas.
CMFCToolBar::OnFillBackground	Chamado pela estrutura de CBasePane::DoPaint para preencher o plano de fundo da barra de ferramentas.
CMFCToolBar::OnReset	Restaura a barra de ferramentas para seu estado original.
CMFCToolBar::OnSetAccData	Overrides ( CBasePane::OnSetAccData.)
CMFCToolBar::OnSetDefaultButtonText	Restaura o texto de um botão da barra de ferramentas para seu estado padrão.
CMFCToolBar::OnUpdateCmdUI	Usado internamente.
CMFCToolBar::RemoveAllButtons	Remove todos os botões da barra de ferramentas.
CMFCToolBar::RemoveButton	Remove o botão com o índice especificado da barra de ferramentas.
CMFCToolBar::RemoveStateFromRegistry	Exclui as informações do estado da barra de ferramentas do Registro do Windows.
CMFCToolBar::ReplaceButton	Substitui um botão da barra de ferramentas com outro botão da barra de ferramentas.
CMFCToolBar::ResetAll	Restaura todas as barras de ferramentas para seus estados originais.
CMFCToolBar::ResetAllImages	Limpa todas as coleções de imagem da barra de ferramentas para o aplicativo.
CMFCToolBar::RestoreOriginalstate	Restaura o estado original de uma barra de ferramentas.
CMFCToolBar::SaveState	Salva informações do estado da barra de ferramentas no Registro do Windows.Overrides ( CPane::SaveState.)
CMFCToolBar::Serialize	Overrides ( CBasePane::Serialize.)
CMFCToolBar::SetBasicCommands	Define a lista de comandos que são sempre exibidos quando um usuário abre um menu.
CMFCToolBar::SetButtonInfo	Define a identificação do comando, o estilo, e a identificação de imagem de um botão da barra de ferramentas.
CMFCToolBar::SetButtonStyle	Defina o estilo do botão da barra de ferramentas no índice especificado.
CMFCToolBar::SetButtonText	Define o rótulo de texto de um botão da barra de ferramentas.
CMFCToolBar::SetButtons	Defina os botões da barra de ferramentas.
CMFCToolBar::SetCommandUsageOptions	Especifica quando os comandos raramente usados não aparecem no menu do aplicativo.
CMFCToolBar::SetCustomizeMode	Habilita ou desabilita o modo de personalização para todas as barras de ferramentas para o aplicativo.
CMFCToolBar::SetGrayDisabledButtons	Especifica se os botões desativados na barra de ferramentas ficão escurecidos ou se as imagens desativado são usadas para os botões desativados.
CMFCToolBar::SetHeight	Defina a altura da barra de ferramentas.
CMFCToolBar::SetHotBorder	Especifica se os botões da barra de ferramentas quente- são rastreadas.
CMFCToolBar::SetHotTextColor	Define a cor do texto dos botões da barra de ferramentas quentes.
CMFCToolBar::SetLargeIcons	Especifica se os botões da barra de ferramentas exibe ícones grandes.
CMFCToolBar::SetLockedSizes	Defina os tamanhos dos botões bloqueados e de imagens bloqueadas na barra de ferramentas.
CMFCToolBar::SetMenuSizes	Defina o tamanho dos botões de menu a barra de ferramentas e das suas figuras.
CMFCToolBar::SetNonPermittedCommands	Define a lista de comandos que não podem ser executados pelo usuário.
CMFCToolBar::SetOneRowWithSibling	Posiciona a barra de ferramentas e seu irmão no mesmo linhas.
CMFCToolBar::SetPermament	Especifica se um usuário pode fechar a barra de ferramentas.
CMFCToolBar::SetRouteCommandsViaFrame	Especifica se o elemento pai ou o proprietário envia comandos para a barra de ferramentas.
CMFCToolBar::SetShowTooltips	Especifica se a estrutura exibe a dica de ferramenta.
CMFCToolBar::SetSiblingToolBar	Especifica o irmão da barra de ferramentas.
CMFCToolBar::SetSizes	Especifica os tamanhos dos botões e imagens em todas as barras de ferramentas.
CMFCToolBar::SetToolBarBtnText	Especifica propriedades de um botão na barra de ferramentas.
CMFCToolBar::SetTwoRowsWithSibling	Posiciona a barra de ferramentas e seu irmão em termos separados.
CMFCToolBar::SetUserImages	Define a coleção de imagens definidas pelo usuário no aplicativo.
CMFCToolBar::StretchPane	Redimensiona a barra de ferramentas verticalmente ou horizontalmente. Overrides ( CBasePane::StretchPane.)
CMFCToolBar::TranslateChar	Executa um comando do botão se o código de chave especificado corresponde a um atalho de teclado válido.
CMFCToolBar::UpdateButton	Atualiza o estado do botão especificado.
CMFCToolBar::WrapToolBar	Reposiciona os botões da barra de ferramentas dentro das dimensões disponíveis.

Métodos protegidos

Nome	Descrição
CMFCToolBar::AllowShowOnList	Determina se a barra de ferramentas é exibida na lista no painel de Barras de Ferramentas da caixa de diálogo de Personalizar .
CMFCToolBar::CalcMaxButtonHeight	Calcula a altura máximo de um botão na barra de ferramentas.
CMFCToolBar::DoPaint	Repintura uma barra de ferramentas.
CMFCToolBar::DrawButton	Repintura um botão da barra de ferramentas.
CMFCToolBar::DrawSeparator	Repintura um separador em uma barra de ferramentas.
CMFCToolBar::OnUserToolTip	Chamado pela estrutura quando a dica de ferramenta para um botão está prestes a ser exibido.

Membros de dados

Nome	Descrição
CMFCToolBar::m_bDontScaleImages	Especifica se dimensionar ou não imagens da barra de ferramentas no modo alto de DPI.
CMFCToolBar::m_dblLargeImageRatio	Especifica a taxa entre a dimensão (altura ou largura) de grandes imagens e dimensão de imagens normal.

Comentários

Para inserir um objeto de CMFCToolBar em seu aplicativo, siga estas etapas:

Adicionar um objeto de CMFCToolBar a janela de quadro chave.
Quando você processa a mensagem de WM_CREATE para a janela do quadro chave, chame CMFCToolBar::Create ou CMFCToolBar::CreateEx para criar a barra de ferramentas e para especificar o estilo.
Chame CBasePane::EnableDocking para especificar o estilo de encaixe.

Para inserir um botão especial, como uma caixa de combinação ou uma barra de ferramentas lista suspensa, permitindo um botão fictício recurso no pai, e substitua o botão fictício em tempo de execução usando CMFCToolBar::ReplaceButton.Para mais informações, consulte Passo a passo: Colocar controles em barras de ferramentas.

CMFCToolBar é a classe base para as classes Classe de CMFCMenuBar, Classe de CMFCPopupMenuBar, e Classe de CMFCDropDownToolBarde biblioteca MFC.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe de CMFCToolBar .O exemplo a seguir mostra como definir o texto do rótulo da janela de barra de ferramentas, defina as bordas, defina o estilo do, e ativar o botão de Adicionar ou Remover Botões que aparece no final da barra de ferramentas.Este trecho de código é parte de Exemplo de demonstração de IE.

    CMFCToolBar     m_wndToolBar;


...


    m_wndToolBar.SetWindowText (_T("Standard"));
    m_wndToolBar.SetBorders ();

    //------------------------------------
    // Remove toolbar gripper and borders:
    //------------------------------------
    m_wndToolBar.SetPaneStyle (m_wndToolBar.GetPaneStyle() &
        ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

    m_wndToolBar.EnableCustomizeButton (TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));