Classe CToolBarCtrl

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

class CToolBarCtrl : public CWnd

Comentários

Esse controle (e, portanto, a CToolBarCtrl classe) está disponível somente para programas em execução no Windows 95/98 e Windows NT versão 3.51 e posterior.

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

CToolBarCtrl objetos contêm várias estruturas de dados internas importantes: uma lista de bitmaps de imagem de botão ou uma lista de imagens, uma lista de cadeias de caracteres de rótulo de botão e uma lista de TBBUTTON estruturas que associar uma imagem e/ou seqüência com a posição, estilo, estado e ID do botão de comando. Cada um dos elementos dessas estruturas de dados é chamada por um índice baseado em zero.Antes de usar um CToolBarCtrl objeto que você deve configurar essas estruturas de dados. A lista de seqüências de caracteres pode ser usada somente para os rótulos de botão; não é possível recuperar seqüências de caracteres na barra de ferramentas.

Para usar um CToolBarCtrl objeto que você normalmente executar as seguintes etapas:

  1. Construir o CToolBarCtrl objeto.

  2. De telefonarCriar para criar o controle comum de barra de ferramentas do Windows e anexá-lo à CToolBarCtrl objeto. Indica o estilo da barra de ferramentas usando estilos, sistema autônomo TBSTYLE_TRANSPARENT para uma barra de ferramentas transparente ou TBSTYLE_DROPDOWN para uma barra de ferramentas que oferece suporte a botões de estilo de lista suspensa.

  3. Identificar como deseja que os botões na barra de ferramentas exibida:

    • Para usar imagens de bitmap para botões, adicionar os bitmaps de botão à barra de ferramentas chamando AddBitmap.

    • Para usar imagens exibidas a partir de uma lista de imagens para botões, especifique a lista de imagens, chamando SetImageList, SetHotImageList, or SetDisabledImageList.

    • Para usar rótulos de seqüência de caracteres para botões, adicione as seqüências de caracteres para a barra de ferramentas chamando AddString and/or AddStrings.

  4. Adicionar estruturas botão à barra de ferramentas chamando AddButtons.

  5. Se desejar dicas de ferramenta para um botão de barra de ferramentas em uma janela do proprietário que não seja um CFrameWnd, você precisa manipular o TTN_NEEDTEXT mensagens na janela do proprietário da barra de ferramentas sistema autônomo descrito em Manipulação de notificações de dica de ferramenta.Se a janela pai da barra de ferramentas é derivada de CFrameWnd, as dicas de ferramenta são exibidas sem qualquer esforço extra de você porque CFrameWnd Fornece um manipulador padrão.

  6. Se você quiser que o usuário para personalizar a barra de ferramentas, lidar com mensagens de notificação de personalização na janela do proprietário, conforme descrito em Manipulação de notificações de personalização.

Você pode usar SaveState para salvar o estado corrente de um controle de barra de ferramentas no registro e RestoreState restauração o estado com base nas informações anteriormente armazenadas no registro.Além salvando o estado da barra de ferramentas entre os usos do aplicativo, aplicativos geralmente armazenam o estado antes do usuário começa Personalizando a barra de ferramentas, caso o usuário deseje posteriormente restauração a barra de ferramentas a seu estado original.

Suporte para o Internet Explorer versão 4.0 e posterior

Para oferecer suporte à funcionalidade introduzida no Internet Explorer, versão 4.0 e posterior, MFC fornece suporte a lista de imagem e estilos simples e transparente para os controles da barra de ferramentas.

Uma barra de ferramentas transparente permite que o cliente sob a barra de ferramentas visível através dela.Para criar uma barra de ferramentas transparente, use tanto TBSTYLE_FLAT and TBSTYLE_TRANSPARENT estilos.Barras de ferramentas transparente apresentam realçamento; ou seja, quando o ponteiro do mouse se move sobre um botão de acesso na barra de ferramentas, altera a aparência do botão.Barras de ferramentas criadas com apenas o TBSTYLE_FLAT estilo contém botões que não são transparente.

Suporte de lista de imagem permite que um controle maior flexibilidade para o comportamento padrão, hot imagens e imagens desativadas.Use GetImageList, GetHotImageList, and 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 and Usando CToolBarCtrl.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Tarefas

Exemplo de CMNCTRL1: Demonstra a classes do MFC de Controlarar ComComumComum, parte 1

Exemplo MFCIE: Demonstra o MFC CHtmlView e CReBar classes

Referência

Classe CWnd

Gráfico de hierarquia

Classe CToolBar

Outros recursos

CToolBarCtrl membros