Classe CMFCToolBar

Artigo
08/25/2010

The CMFCToolBar classe semelhante Classe CToolBar, mas oferece suporte adicional para recursos da interface do usuário. Isso inclui barras de ferramentas simples, barras de ferramentas com hot imagens, ícones grandes, botões de pager, barras de ferramentas bloqueadas, rebar controles, texto em imagens, imagens de plano de fundo e com guias as barras de ferramentas.The CMFCToolBar classe também contém suporte interno para personalização do usuário das barras de ferramentas e menus, do tipo arrastar e soltar entre barras de ferramentas e menus, botões da caixa de combinação, edite caixa botões, selecionadores de cores e botões de roll-up.

class CMFCToolBar : public CMFCBaseToolBar

Membros

Construtores públicos

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	Incrementos por um contador que está associado a determinado comando.
CMFCToolBar::AddToolBarForImageCollection	Adiciona imagens dos recursos de interface do usuário à coleção de imagens no aplicativo.
CMFCToolBar::AdjustLayout	Recalcula o dimensionar e a posição de uma barra de ferramentas.(Substitui CBasePane::AdjustLayout).
CMFCToolBar::AdjustSize	Recalcula o dimensionar da barra de ferramentas.
CMFCToolBar::AllowChangeTextLabels	Especifica se os rótulos de texto podem ser mostrados em imagens de botões da barra de ferramentas.
CMFCToolBar::AreTextLabels	Especifica se rótulos de texto em imagens no momento são exibidos nos botões de barra de ferramentas.
CMFCToolBar::AutoGrayInactiveImages	Ativar ou desativa a geração automático de imagens de botão inativo.
CMFCToolBar::ButtonToIndex	Retorna o índice de um especificado Classe CMFCToolBarButton objeto nessa barra de ferramentas.
CMFCToolBar::CalcFixedLayout	Calcula o dimensionar horizontal da barra de ferramentas.(Substitui CBasePane::CalcFixedLayout.)
CMFCToolBar::CalcSize	Chamado pela estrutura sistema autônomo parte do processo de cálculo de layout.(Substitui 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 alocados para imagens de barra de ferramentas.
CMFCToolBar::CleanUpLockedImages	Libera os recursos do sistema alocados para imagens de barra de ferramentas bloqueadas.
CMFCToolBar::CanBeClosed	Especifica se um usuário pode fechar a barra de ferramentas.(Substitui CBasePane::CanBeClosed.)
CMFCToolBar::CanBeRestored	Determina se o sistema pode restauração uma barra de ferramentas a seu estado original após a personalização.
CMFCToolBar::CanFocus	Especifica se o painel pode receber o foco.(Substitui 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 do botão na barra de ferramentas com uma ID de comando especificado.
CMFCToolBar::criar	Cria um CMFCToolBar objeto.
CMFCToolBar::CreateEx	Cria um CMFCToolBar objeto que usa opções de estilo adicionais, sistema autônomo ícones grandes.
CMFCToolBar::Deactivate	Desativa a barra de ferramentas.
CMFCToolBar::EnableCustomizeButton	Habilita ou desabilita o Adicionar ou remover botões botão que aparece no participante da barra de ferramentas.
CMFCToolBar::EnableDocking	Permite encaixe do painel para o quadro principal.(Substitui CBasePane::EnableDocking.)
CMFCToolBar::EnableLargeIcons	Ativa ou desativa ícones grandes em botões da barra de ferramentas.
CMFCToolBar::EnableQuickCustomization	Habilita ou desabilita a personalização rápida das barras de ferramentas para que o usuário pode pressionar o ALT chave e arrastar um botão para um novo local.
CMFCToolBar::EnableReflections	Ativa ou desativa a reflexão de comando.
CMFCToolBar::EnableTextLabels	Ativa ou desativa rótulos de texto em imagens de botão de barra de ferramentas.
CMFCToolBar::FromHandlePermanent	Recupera um ponteiro para o CMFCToolBar objeto que contém o identificador de janela específico.
CMFCToolBar::GetAllButtons	Retorna uma lista somente leitura dos botões na barra de ferramentas.
CMFCToolBar::GetAllToolbars	Retorna uma lista somente leitura de todas as barras de ferramentas no aplicativo.
CMFCToolBar::GetBasicCommands	Retorna uma lista somente leitura dos comandos do básicos definido no aplicativo.
CMFCToolBar::GetButton	Retorna um ponteiro para o CMFCToolBarButton objeto que tem um índice de botão de barra de ferramentas especificada.
CMFCToolBar::GetButtonInfo	Retorna o ID de comando, o estilo e o índice de 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 corrente do botão de barra de ferramentas que está localizado no índice especificado.
CMFCToolBar::GetButtonText	Retorna o rótulo de texto de um botão que tem um índice especificado.
CMFCToolBar::GetColdImages	Retorna um ponteiro para a coleção de imagens de botão de barra de ferramentas frio no aplicativo.
CMFCToolBar::GetColumnWidth	Retorna a largura dos botões da barra de ferramentas.
CMFCToolBar::GetCommandButtons	Retorna uma lista de botões que possuem uma ID de comando especificado de todas as barras de ferramentas no aplicativo.
CMFCToolBar::GetCount	Retorna o número de botões na barra de ferramentas.
CMFCToolBar::GetCustomizeButton	Recupera um ponteiro para o CMFCCustomizeButton objeto que está associado com a barra de ferramentas.
CMFCToolBar::GetDefaultImage	Retorna o índice da imagem padrão para um botão de barra de ferramentas com uma ID de comando especificado.
CMFCToolBar::GetDisabledImages	Retorna um ponteiro para a coleção de imagens que são usadas para os botões da barra de ferramentas inativo no aplicativo.
CMFCToolBar::GetDisabledMenuImages	Retorna um ponteiro para a coleção de imagens que são usadas para botões de menu inativo no aplicativo.
CMFCToolBar::GetDroppedDownMenu	Recupera um ponteiro para o objeto de botão de menu que está exibindo atualmente submenu correspondente.
CMFCToolBar::GetGrayDisabledButtons	Especifica se as imagens de botões desabilitados são esmaecido versões das imagens de botão regular ou da coleção de imagens de botão desabilitado.
CMFCToolBar::GetHighlightedButton	Retorna um ponteiro para botão de barra de ferramentas que está realçado no momento.
CMFCToolBar::GetHotBorder	Determina se os botões da barra de ferramentas são controladas quente.
CMFCToolBar::GetHotTextColor	Retorna a cor do texto dos botões da barra de ferramentas realçado.
CMFCToolBar::GetHwndLastFocus	Retorna um identificador de janela que tinha o foco de entrada antes da barra de ferramentas foi.
CMFCToolBar::GetIgnoreSetText
CMFCToolBar::GetImageSize	Retorna o dimensionar corrente de imagens de botão de barra de ferramentas.
CMFCToolBar::GetImages	Retorna um ponteiro para a coleção de padrão de imagens de botão no aplicativo.
CMFCToolBar::GetImagesOffset	Retorna o deslocamento de índice usado para localizar imagens de botão da barra de ferramentas para esta barra de ferramentas na lista global de imagens de botão de barra de ferramentas.
CMFCToolBar::GetInvalidateItemRect	Recupera a região da área de cliente deve ser redesenhada do botão em dado índice.
CMFCToolBar::GetItemID	Retorna a ID de comando do botão de barra de ferramentas em um índice especificado.
CMFCToolBar::GetItemRect	Retorna o retângulo delimitador do botão em um índice especificado.
CMFCToolBar::GetLargeColdImages	Retorna um ponteiro para a coleção de imagens de botão grandes da barra de ferramentas frio no aplicativo.
CMFCToolBar::GetLargeDisabledImages	Retorna um ponteiro para a coleção de grandes desabilitado imagens de botão de barra de ferramentas no aplicativo.
CMFCToolBar::GetLargeImages	Retorna um ponteiro para a coleção de grandes botão de barra de ferramentas imagens no aplicativo.
CMFCToolBar::GetLockedColdImages	Retorna um ponteiro para a coleção de bloqueado fria imagens na barra de ferramentas.
CMFCToolBar::GetLockedDisabledImages	Retorna um ponteiro à coleção de bloqueado desabilitado imagens na barra de ferramentas.
CMFCToolBar::GetLockedImages	Retorna um ponteiro para a coleção de bloqueado botão imagens na barra de ferramentas.
CMFCToolBar::GetLockedImageSize	Retorna o dimensionar padrão das imagens bloqueadas barra de ferramentas.
CMFCToolBar::GetLockedMenuImages	Retorna um ponteiro para a coleção de bloqueado imagens do menu de barra de ferramentas na barra de ferramentas.
CMFCToolBar::GetMenuButtonSize	Retorna o dimensionar dos botões de menu no aplicativo.
CMFCToolBar::GetMenuImageSize	Retorna o dimensionar das imagens de botão de menu no aplicativo.
CMFCToolBar::GetMenuImages	Retorna um ponteiro para a coleção de imagens de botão de menu no aplicativo.
CMFCToolBar::GetOrigButtons	Recupera a coleção de botões não personalizado da barra de ferramentas.
CMFCToolBar::GetOrigResetButtons	Recupera a coleção de botões de reiniciar não personalizado da barra de ferramentas.
CMFCToolBar::GetResourceID	Recupera a ID do recurso da barra de ferramentas.
CMFCToolBar::GetRouteCommandsViaFrame	Determina qual objeto, o quadro 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 de botão de barra de ferramentas definidas pelo usuário no aplicativo.
CMFCToolBar::HitTest	Retorna o índice do botão de 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 área de cliente do botão de barra de ferramentas que existe no índice fornecido.
CMFCToolBar::IsAddRemoveQuickCustomize
CMFCToolBar::IsAltCustomizeMode
CMFCToolBar::IsAutoGrayInactiveImages	Especifica se a geração automático de imagens de botão desabilitado está ativada.
CMFCToolBar::IsBasicCommand	Determina se é um comando na lista de comandos básicos.
CMFCToolBar::IsButtonExtraSizeAvailable	Determina se a barra de ferramentas pode exibir botões estendeu bordas.
CMFCToolBar::IsCommandPermitted	Determina se é permitido um comando.
CMFCToolBar::IsCommandRarelyUsed	Determina se um comando raramente é usado (consulte CMFCToolBar::SetCommandUsageOptions).
CMFCToolBar::IsCustomizeMode	Especifica se a barra de ferramentas estrutura está no modo de personalização.
CMFCToolBar::IsDragButton
CMFCToolBar::IsExistCustomizeButton	Determina se a barra de ferramentas contém o Personalizar botão.
CMFCToolBar::IsFloating	(Substitui CBasePane::IsFloating.)
CMFCToolBar::IsLargeIcons	Especifica se as barras de ferramentas no aplicativo atualmente exibem ícones grandes.
CMFCToolBar::IsLastCommandFromButton	Determina se executados mais recentemente comando foi enviado a partir do botão de barra de ferramentas especificada.
CMFCToolBar::IsLocked	Determina se a barra de ferramentas é bloqueado.
CMFCToolBar::IsOneRowWithSibling	Determina se a barra de ferramentas e barra de ferramentas correspondente irmão são posicionados na mesma linha.
CMFCToolBar::IsUserDefined	Especifica se a barra de ferramentas é definida pelo usuário.
CMFCToolBar::LoadBitmap	Carrega imagens da barra de ferramentas de recursos do aplicativo.
Classe CMFCToolBarEditBoxButton	Carrega imagens da barra de ferramentas de recursos do aplicativo.Inclui imagens grandes.
CMFCToolBar::LoadParameters	Carrega opções da barra de ferramentas global no registro do Windows.
CMFCToolBar::LoadState	Carrega as informações de estado da barra de ferramentas de registro do Windows.(Substitui CPane::LoadState.)
CMFCToolBar::LoadToolBar	Carrega a barra de ferramentas de recursos do aplicativo.
CMFCToolBar::LoadToolBarEx	Carrega a barra de ferramentas de recursos de aplicativos usando o CMFCToolBarInfo classe auxiliar para permitir que o aplicativo usar imagens grandes.
CMFCToolBar::OnChangeHot	Chamado pela estrutura quando um usuário seleciona um botão da barra de ferramentas.
CMFCToolBar::OnFillBackground	Chamado pela estrutura a partir de CBasePane::DoPaint para preencher o plano de fundo da barra de ferramentas.
CMFCToolBar::OnReset	Restaura a barra de ferramentas a seu estado original.
CMFCToolBar::OnSetAccData	(Substitui CBasePane::OnSetAccData.)
CMFCToolBar::OnSetDefaultButtonText	Restaura o texto de um botão de barra de ferramentas para seu estado padrão.
CMFCToolBar::OnUpdateCmdUI	(Substitui CBasePane::OnUpdateCmdUI.)
CMFCToolBar::RemoveAllButtons	Remove todos os botões da barra de ferramentas.
CMFCToolBar::RemoveButton	Remove o botão com o índice especificado na barra de ferramentas.
CMFCToolBar::RemoveStateFromRegistry	Exclui as informações de estado da barra de ferramentas do registro do Windows.
CMFCToolBar::ReplaceButton	Substitui um botão de barra de ferramentas com outro botão de barra de ferramentas.
CMFCToolBar::ResetAll	Restaura todas as barras de ferramentas em seus estados originais.
CMFCToolBar::ResetAllImages	Limpa todas as coleções de barra de ferramentas imagem no aplicativo.
CMFCToolBar::RestoreOriginalstate	Restaura o estado original de uma barra de ferramentas.
CMFCToolBar::SaveState	Salva as informações de estado da barra de ferramentas no registro do Windows.(Substitui CPane::SaveState.)
CMFCToolBar::Serialize	(Substitui CBasePane::Serialize.)
CMFCToolBar::SetBasicCommands	Define a lista de comandos que são sempre exibidos quando um usuário abre um menu.
CMFCToolBar::SetButtonInfo	Define o ID de comando, o estilo e a identificação de imagem de um botão de barra de ferramentas.
CMFCToolBar::SetButtonStyle	Define o estilo do botão de barra de ferramentas no índice fornecido.
CMFCToolBar::SetButtonText	Define o rótulo de texto de um botão de barra de ferramentas.
CMFCToolBar::SetButtons	Define os botões da barra de ferramentas.
CMFCToolBar::SetCommandUsageOptions	Especifica quando comandos raramente usados não aparecem no menu do aplicativo.
CMFCToolBar::SetCustomizeMode	Ativa ou desativa o modo de personalização para todas as barras de ferramentas no aplicativo.
CMFCToolBar::SetGrayDisabledButtons	Especifica se o desabilitado botões da barra de ferramentas são esmaecido ou se forem usadas imagens desativadas para os botões desabilitados.
CMFCToolBar::SetHeight	Define a altura da barra de ferramentas.
CMFCToolBar::SetHotBorder	Especifica se a botões da barra de ferramentas são hot-controladas.
CMFCToolBar::SetHotTextColor	Define a cor do texto para os botões da barra de ferramentas hot.
CMFCToolBar::SetLargeIcons	Especifica se os botões da barra de ferramentas Exibir ícones grandes.
CMFCToolBar::SetLockedSizes	Define o tamanho das bloqueado botões e bloqueado imagens na barra de ferramentas.
CMFCToolBar::SetMenuSizes	Define o dimensionar de botões de menu da barra de ferramentas e suas imagens.
CMFCToolBar::SetNonPermittedCommands	Define a lista de comandos que não pode ser executado pelo usuário.
CMFCToolBar::SetOneRowWithSibling	Posiciona a barra de ferramentas e seu irmão na mesma linha.
CMFCToolBar::SetPermament	Especifica se um usuário pode fechar a barra de ferramentas.
CMFCToolBar::SetRouteCommandsViaFrame	Especifica se o quadro pai ou o proprietário envia comandos para a barra de ferramentas.
CMFCToolBar::SetShowTooltips	Especifica se a estrutura exibe dicas de ferramenta.
CMFCToolBar::SetSiblingToolBar	Especifica o irmão da barra de ferramentas.
CMFCToolBar::SetSizes	Especifica o tamanho dos botões e imagens em todas as barras de ferramentas.
CMFCToolBar::SetToolBarBtnText	Especifica as propriedades de um botão na barra de ferramentas.
CMFCToolBar::SetTwoRowsWithSibling	Posiciona a barra de ferramentas e seu irmão em linhas separadas.
CMFCToolBar::SetUserImages	Define o conjunto de imagens definidas pelo usuário no aplicativo.
CMFCToolBar::StretchPane	(Substitui CBasePane::StretchPane.)
CMFCToolBar::TranslateChar
CMFCToolBar::UpdateButton
CMFCToolBar::WrapToolBar

Métodos protegidos

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

Membros de dados

Nome	Descrição
CMFCToolBar::m_dblLargeImageRatio	Especifica a relação entre a dimensão (largura ou altura) de imagens grandes e a dimensão de imagens regulares.

Comentários

Para incorporar um CMFCToolBar objeto em seu aplicativo, execute essas etapas:

Adicionar um CMFCToolBar objeto para a janela do quadro principal.
Quando você processar o WM_CREATE mensagem para a janela do quadro principal, chame qualquer um CMFCToolBar::criar ou CMFCToolBar::CreateEx Para criar a barra de ferramentas e especificar seu estilo.
De telefonarCBasePane::EnableDocking Para especificar o estilo de encaixe.

Para inserir um botão especial, sistema autônomo uma caixa de combinação ou uma barra de ferramentas da lista suspensa, reservar um botão fictício no recurso pai e substituir o botão fictício em tempo de execução usando CMFCToolBar::ReplaceButton. Para obter mais informações, consulte Como: Colocar controles em barras de ferramentas.

CMFCToolBar é a classe base para as classes da biblioteca MFC Classe CMFCToolBar, Classe CMFCPopupMenuBar, e Classe CMFCDropDownToolBar.

Exemplo

O exemplo a seguir demonstra como usar diversos métodos no CMFCToolBar classe. O exemplo mostra como conjunto o texto do rótulo da janela da BAR de ferramenta, conjunto as bordas, conjunto o estilo do painel e habilitar o Adicionar ou remover botões botão que aparece no participante da BAR de ferramentas.Neste trecho de código faz parte o Exemplo do IEDemo: Aplicativo do MFC Internet Explorer.

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