Classe de CToolBarCtrl

Artigo
02/25/2013

Fornece a funcionalidade do controle comum da barra de ferramentas do windows.

class CToolBarCtrl : public CWnd

Membros

Construtores public

Nome	Descrição
CToolBarCtrl::CToolBarCtrl	Constrói um objeto de CToolBarCtrl .

Métodos públicos

Nome	Descrição
CToolBarCtrl::AddBitmap	Adiciona uma ou mais imagens do botão de bitmap à lista de imagens do botão disponíveis para um controle de barra de ferramentas.
CToolBarCtrl::AddButtons	Adiciona um ou mais botões a um controle de barra de ferramentas.
CToolBarCtrl::AddString	Adiciona uma nova cadeia de caracteres, passada como um ID de recurso, a lista interna da barra de ferramentas de cadeias de caracteres.
CToolBarCtrl::AddStrings	Adiciona uma nova cadeia de caracteres ou cadeias de caracteres, passada como um ponteiro para um buffer de cadeias de caracteres NULL- separada, a lista interna da barra de ferramentas de cadeias de caracteres.
CToolBarCtrl::AutoSize	Redimensiona um controle de barra de ferramentas.
CToolBarCtrl::ChangeBitmap	Altera o bitmap de um botão no controle de barra de ferramentas atual.
CToolBarCtrl::CheckButton	Verifica ou limpa um determinado botão em um controle de barra de ferramentas.
CToolBarCtrl::CommandToIndex	Retorna o índice com base zero para o botão associado com o identificador de comando especificado.
CToolBarCtrl::Create	Cria um controle de barra de ferramentas e anexá-la a um objeto de CToolBarCtrl .
CToolBarCtrl::CreateEx	Cria um controle de barra de ferramentas com os estilos estendidos o windows especificados e anexá-la a um objeto de CToolBarCtrl .
CToolBarCtrl::Customize	Exibe a caixa de diálogo da barra de ferramentas personalizar.
CToolBarCtrl::DeleteButton	Exclui um botão de controle de barra de ferramentas.
CToolBarCtrl::EnableButton	Habilita ou desabilita o botão especificado em um controle de barra de ferramentas.
CToolBarCtrl::GetAnchorHighlight	Recupera a configuração de realce de âncora para uma barra de ferramentas.
CToolBarCtrl::GetBitmap	Retorna o índice de bitmap associado com um botão na barra de ferramentas.
CToolBarCtrl::GetBitmapFlags	Obtém os sinalizadores associados com o bitmap da barra de ferramentas.
CToolBarCtrl::GetButton	Recupera informações sobre o botão especificado em um controle de barra de ferramentas.
CToolBarCtrl::GetButtonCount	Recupera uma contagem dos botões no controle de barra de ferramentas.
CToolBarCtrl::GetButtonInfo	Recupera informações para um botão na barra de ferramentas.
CToolBarCtrl::GetButtonSize	Obtém a largura e altura atuais dos botões da barra de ferramentas, em pixels.
CToolBarCtrl::GetColorScheme	Recupera o esquema de cores de controle de barra de ferramentas atual.
CToolBarCtrl::GetDisabledImageList	Recupera a lista de imagem que um controle de barra de ferramentas usa para exibir os botões desativados.
CToolBarCtrl::GetDropTarget	Recupera a interface de IDropTarget para um controle de barra de ferramentas.
CToolBarCtrl::GetExtendedStyle	Recupera os estilos estendidos para um controle de barra de ferramentas.
CToolBarCtrl::GetHotImageList	Recupera a lista de imagem que um controle de barra de ferramentas usa para exibir os botões “quentes”.Um botão quente aparece realçado quando o ponteiro do mouse está acima de ele.
CToolBarCtrl::GetHotItem	Retorna o índice do item quente em uma barra de ferramentas.
CToolBarCtrl::GetImageList	Recupera a lista de imagem que um controle de barra de ferramentas usa para exibir os botões em seu estado padrão.
CToolBarCtrl::GetInsertMark	Recupera a marca de inserção atual para a barra de ferramentas.
CToolBarCtrl::GetInsertMarkColor	Recupera a cor usada para desenhar a marca de inserção para a barra de ferramentas.
CToolBarCtrl::GetItemRect	Recupera o retângulo delimitador de um botão em um controle de barra de ferramentas.
CToolBarCtrl::GetMaxSize	Retorna o tamanho total de todos os botões e separadores visíveis na barra de ferramentas.
CToolBarCtrl::GetMaxTextRows	Retorna o número máximo de linhas de texto exibido em um botão da barra de ferramentas.
CToolBarCtrl::GetMetrics	Recupera métricas de um controle de barra de ferramentas.
CToolBarCtrl::GetPadding	Recupera o preenchimento horizontal e vertical do controle de barra de ferramentas atual.
CToolBarCtrl::GetPressedImageList	Recupera a lista de imagem que o controle de barra de ferramentas atual usa para representar os botões o estado pressionado.
CToolBarCtrl::GetRect	Recupera o retângulo delimitador de um botão da barra de ferramentas especificado.
CToolBarCtrl::GetRows	Retorna o número de linhas de botões exibidos na barra de ferramentas.
CToolBarCtrl::GetState	Recupera informações sobre o estado do botão especificado em um controle de barra de ferramentas, como se estiver ativado, pressionado, ou verificado.
CToolBarCtrl::GetString	Recupera uma cadeia de caracteres de barra de ferramentas.
CToolBarCtrl::GetStyle	Recupera os estilos atualmentes em uso para um controle de barra de ferramentas.
CToolBarCtrl::GetToolTips	Recupera a alça de controle dica de ferramenta, se houver, associado ao controle de barra de ferramentas.
CToolBarCtrl::HideButton	Oculta ou mostra o botão especificado em um controle de barra de ferramentas.
CToolBarCtrl::HitTest	Determina onde um ponto está em um controle de barra de ferramentas.
CToolBarCtrl::Indeterminate	Define ou limpa o estado (cinza) indefinido do botão especificado em um controle de barra de ferramentas.
CToolBarCtrl::InsertButton	Insere um botão em um controle de barra de ferramentas.
CToolBarCtrl::InsertMarkHitTest	Recupera informações de marca para um ponto de inserção em uma barra de ferramentas.
CToolBarCtrl::IsButtonChecked	Informa se o botão especificado em um controle de barra de ferramentas é verificado.
CToolBarCtrl::IsButtonEnabled	Informa se o botão especificado em um controle de barra de ferramentas está habilitado.
CToolBarCtrl::IsButtonHidden	Informa se o botão especificado em um controle de barra de ferramentas está oculto.
CToolBarCtrl::IsButtonHighlighted	Verifica o estado de realce de botão da barra de ferramentas.
CToolBarCtrl::IsButtonIndeterminate	Informa se o estado do botão especificado em um controle de barra de ferramentas é indefinido (cinza).
CToolBarCtrl::IsButtonPressed	Informa se o botão especificado em um controle de barra de ferramentas está pressionada.
CToolBarCtrl::LoadImages	Bitmaps carrega a imagem de um controle de barra de ferramentas lista.
CToolBarCtrl::MapAccelerator	Mapeia um caractere de aceleradores a um botão da barra de ferramentas.
CToolBarCtrl::MarkButton	Define o estado de realce de um determinado botão em um controle de barra de ferramentas.
CToolBarCtrl::MoveButton	Move um botão de um índice para outro.
CToolBarCtrl::PressButton	Pressiona o botão ou versões especificado em um controle de barra de ferramentas.
CToolBarCtrl::ReplaceBitmap	Substitui o projeto existente no controle de barra de ferramentas atual com um novo projeto.
CToolBarCtrl::RestoreState	Restaura o estado do controle de barra de ferramentas.
CToolBarCtrl::SaveState	Salvar o estado do controle de barra de ferramentas.
CToolBarCtrl::SetAnchorHighlight	Define a configuração de realce de âncora para uma barra de ferramentas.
CToolBarCtrl::SetBitmapSize	Defina o tamanho das imagens bitmap a ser adicionadas a um controle de barra de ferramentas.
CToolBarCtrl::SetButtonInfo	Define informações de um botão existente em uma barra de ferramentas.
CToolBarCtrl::SetButtonSize	Defina o tamanho dos botões para ser adicionados a um controle de barra de ferramentas.
CToolBarCtrl::SetButtonStructSize	Especifica o tamanho da estrutura de TBBUTTON .
CToolBarCtrl::SetButtonWidth	Define o mínimo e máximo as larguras de botão no controle de barra de ferramentas.
CToolBarCtrl::SetCmdID	Define o identificador de comando para ser enviadas para a janela do proprietário quando o botão é pressionado especificado.
CToolBarCtrl::SetColorScheme	Defina o esquema de cores de controle de barra de ferramentas atual.
CToolBarCtrl::SetDisabledImageList	Define a lista de imagem que o controle de barra de ferramentas usará para exibir os botões desativados.
CToolBarCtrl::SetDrawTextFlags	Defina os sinalizadores na função DrawTextWin32, que é usada para desenhar texto no retângulo especificado, formatado de acordo com os sinalizadores são definidos como.
CToolBarCtrl::SetExtendedStyle	Define estilos estendidos para um controle de barra de ferramentas.
CToolBarCtrl::SetHotImageList	Define a lista de imagem que o controle de barra de ferramentas usará para exibir os botões “quentes”.
CToolBarCtrl::SetHotItem	Define o item quente em uma barra de ferramentas.
CToolBarCtrl::SetImageList	Define a lista de imagem que a barra de ferramentas usará para exibir botões que estão em seu estado padrão.
CToolBarCtrl::SetIndent	Define o recuo para o primeiro botão em um controle de barra de ferramentas.
CToolBarCtrl::SetInsertMark	Define a marca de inserção atual para a barra de ferramentas.
CToolBarCtrl::SetInsertMarkColor	Define a cor usada para desenhar a marca de inserção para a barra de ferramentas.
CToolBarCtrl::SetMaxTextRows	Define o número máximo de linhas de texto exibido em um botão da barra de ferramentas.
CToolBarCtrl::SetMetrics	Define métricas de um controle de barra de ferramentas.
CToolBarCtrl::SetOwner	Define a janela para receber notificações do controle de barra de ferramentas.
CToolBarCtrl::SetPadding	Define o preenchimento horizontal e vertical do controle de barra de ferramentas atual.
CToolBarCtrl::SetPressedImageList	Define a lista de imagem que o controle de barra de ferramentas atual usa para representar os botões o estado pressionado.
CToolBarCtrl::SetRows	Define o número de linhas de botões exibidos na barra de ferramentas.
CToolBarCtrl::SetState	Define o estado do botão especificado em um controle de barra de ferramentas.
CToolBarCtrl::SetStyle	Defina os estilos de um controle de barra de ferramentas.
CToolBarCtrl::SetToolTips	Associa um controle dica de ferramenta com o controle de barra de ferramentas.
CToolBarCtrl::SetWindowTheme	Defina o estilo visual de um controle de barra de ferramentas.

Comentários

Este controle (e portanto a classe de CToolBarCtrl ) estão disponíveis somente para programas que executam na versão 3,51 do /98 Windows 95 e Windows NT e posterior.

Um controle comum da barra de ferramentas do windows é uma janela filho retangular que contém um ou mais botões.Esses botões podem exibir uma imagem de bitmap, uma cadeia de caracteres, ou ambos.Quando o usuário escolhe um botão, envia uma mensagem de comando na janela do proprietário da barra de ferramentas.Normalmente, os botões na barra de ferramentas correspondem aos itens no menu de aplicativo; fornecem uma maneira mais direta para que o usuário acessa os comandos de um aplicativo.

Os objetos deCToolBarCtrl contêm várias estruturas de dados internas importantes: uma lista de bitmaps de imagem do botão ou uma lista de imagem, uma lista de cadeias de caracteres de rótulo do botão, e uma lista de estruturas de TBBUTTON que associam uma imagem e/ou uma cadeia de caracteres com a posição, suporta, indicam comando, e a identificação do botão.Cada um dos elementos de essas estruturas de dados é referenciado por um índice com base zero.Antes de usar um objeto de CToolBarCtrl , você deve configurar essas estruturas de dados.A lista de cadeias de caracteres somente pode ser usada para rótulos do botão; você não pode recuperar cadeias de caracteres de barra de ferramentas.

Para usar um objeto de CToolBarCtrl , você normalmente irá seguir estas etapas:

Construir o objeto de CToolBarCtrl .
Chame Criar para criar o controle comum da barra de ferramentas do windows para e anexá-la ao objeto de CToolBarCtrl .Indica o estilo da barra de ferramentas usando estilos, como TBSTYLE_TRANSPARENT para uma barra de ferramentas transparente ou TBSTYLE_DROPDOWN para uma barra de ferramentas que suporta os botões lista de estilo.
Identifica como você deseja que os botões na barra de ferramentas exibida:
- Para usar imagens de bitmap para adicionar botões, bitmaps de botão à barra de ferramentas chamando AddBitmap.
- Para usar imagens exibidas de uma imagem para listar os botões, especifique a lista de imagem chamando SetImageList, SetHotImageList, ou SetDisabledImageList.
- Para usar rótulos de cadeia de caracteres para os botões, adicione as cadeias de caracteres para a barra de ferramentas chamando AddString e/ou AddStrings.
Adicione estruturas de botão à barra de ferramentas chamando AddButtons.
Se você deseja dica de ferramenta para um botão da barra de ferramentas para uma janela proprietária que não é CFrameWnd, você precisar manipular as mensagens de TTN_NEEDTEXT na janela do proprietário da barra de ferramentas como descrito em Notificações de dica de ferramenta de manipulação.Se a janela pai da barra de ferramentas é derivada de CFrameWnd, dicas de ferramenta são exibidas sem nenhum esforço extra de como você CFrameWnd fornece um manipulador padrão.
Se você desejar que o usuário poderá personalizar a barra de ferramentas, manipular notificações de personalização na janela do proprietário como descrito em Notificações de manipulação de personalização.

Você pode usar SaveState para salvar o estado atual de um controle de barra de ferramentas para o Registro e em RestoreState para restaurar o estado baseado nas informações armazenadas anteriormente no Registro.Além de salvar o estado da barra de ferramentas entre os usos de aplicativo, armazenamento de aplicativos normalmente o estado antes que o usuário começar a personalizar a barra de ferramentas caso que o usuário deseja posteriormente para restaurar a barra de ferramentas para seu estado original.

Suporte para a versão do Internet Explorer 4,0 e posterior

Para oferecer suporte à funcionalidade introduzida no Internet Explorer, a versão 4,0 e posterior, MFC fornece suporte a lista de imagem e estilos transparentes e lisos para controles de barra de ferramentas.

Uma barra de ferramentas transparente permite que o cliente na barra de ferramentas mostra completamente.Para criar uma barra de ferramentas transparente, use estilos de TBSTYLE_FLAT e de TBSTYLE_TRANSPARENT .As barras de ferramentas transparentes apresentam o rastreamento quente; isto é, quando o ponteiro do mouse se move sobre quente um botão na barra de ferramentas, a aparência do botão muda.As barras de ferramentas criadas com apenas o estilo de TBSTYLE_FLAT conterão os botões que não são transparentes.

Suporte a lista de imagem permite a um controle maior flexibilidade para o comportamento padrão, imagens, imagens e quentes desativado.Use GetImageList, GetHotImageList, e GetDisabledImageList com a barra de ferramentas transparente para manipular a imagem de acordo com seu estado:

Para obter mais informações sobre como usar CToolBarCtrl, consulte Controles e usando CToolBarCtrl.