CToolBarCtrl

A classe CToolBarCtrl fornece a funcionalidade do Controlarar comum de barra de ferramentas do Windows. Esse Controlarar (e, portanto, a classe CToolBarCtrl ) está disponível somente para programas em executando no Windows 95 e Windows NT versão 3.51 e posterior.

Um Controlarar comum de barra de ferramentas de 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, ele envia uma mensagem de comando para janela de proprietário da barra de ferramentas. Normalmente, os botões em uma barra de ferramentas correspondem aos itens no menu do aplicativo; Eles fornecem uma maneira mais direta para o usuário acessar comandos de um aplicativo.

Objetos de CToolBarCtrl contêm diversas estruturas de dados interno importantes: uma lista de bitmaps de imagem de botão ou uma lista de imagem, uma lista de picadas de rótulo do botão e uma lista de estruturas TBBUTTON que associar uma imagem e/ou seqüência de caracteres com a posição, estilo, estado e identificação do botão de comando. Cada um dos elementos dessas estruturas de dados é referenciada por um índice baseado em zero. Antes de usar um objeto de CToolBarCtrl , você deve configurar essas estruturas de dados. A lista de seqüências de caracteres só pode ser usada para rótulos de botões; você não pode recuperar seqüências de caracteres na barra de ferramentas.

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

  1. Construir o objeto CToolBarCtrl.

  2. Chamada criar para criar o Controlarar comum de barra de ferramentas do Windows e anexá-lo para o objeto CToolBarCtrl . Indicar o estilo de barra de ferramentas usando estilos, como TBSTYLE_TRANSPARENT para uma transparente barra de ferramentas ou TBSTYLE_DROPDOWN para uma barra de ferramentas que oferece suporte a botões de estilo de soltar-para baixo.

  3. Identifique como você deseja que os botões da barra de ferramentas exibida:
    • Para usar imagens de bitmap para botões, adicione os bitmaps de botão para a barra de ferramentas, chamando AddBitmap.

    • Para usar imagens exibidas em uma lista de imagens para os botões, especificar a lista de imagem, chamando SetImageList, SetHotImageListou 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 e/ou AddStrings.
  4. Adicionar estruturas de botão para a barra de ferramentas chamando AddButtons.

  5. Se você desejar dicas de ferramentas para um botão de barra de ferramentas em uma janela do proprietário que não seja um CFrameWnd, você precisará manipular as mensagens TTN_NEEDTEXT na janela de proprietário da barra de ferramentas conforme descrito em CToolBarCtrl: notificações de dica de ferramenta manipulação. Se a janela pai da barra de ferramentas é derivada de CFrameWnd, dicas de ferramenta são exibidas sem qualquer esforço extra de você como CFrameWnd oferece um manipulador padrão.

  6. Se você deseja que seu usuário ser capaz de personalizar a barra de ferramentas, manipular mensagens de notificação de personalização na janela do proprietário, conforme descrito em CToolBarCtrl: manipulação de notificações de personalização.

Você pode usar SaveState para salvar o estado atual de um Controlarar de barra de ferramentas no registro e RestoreState para restaurar o Estado com base nas informações armazenadas anteriormente no registro. Além de salvar o estado de barra de ferramentas entre usos do aplicativo, aplicativos geralmente armazenam o estado antes que o usuário inicia personalizando a barra de ferramentas, no caso do usuário deseja posteriormente restaurar a barra de ferramentas ao seu estado original.

Suporte para Internet Explorer versão 4.0 e posterior

Para oferecer suporte a funcionalidade introduzida no Internet Explorer, versão 4.0 e posterior, MFC fornece suporte de lista de imagens e estilos transparentes e simples para controles de barra de ferramentas.

Uma barra de ferramentas transparente permite que o cliente sob a barra de ferramentas mostrar através de. Para criar uma barra de ferramentas transparente, use tanto a TBSTYLE_FLAT TBSTYLE_TRANSPARENT estilos. Barras de ferramentas transparentes recurso hot controle; 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 estilo TBSTYLE_FLAT irão conter botões que não são transparentes.

Suporte de lista de imagem permite uma flexibilidade maior controle para o comportamento padrão, hot imagens e imagens desabilitadas. Usar GetImageList, GetHotImageListe GetDisabledImageList com a barra de ferramentas transparente para manipular a imagem de acordo com seu estado:

Para obter mais informações sobre o uso de CToolBarCtrl, consulte Tópicos de controle e Usando CToolBarCtrl no Guia do programador do Visual C++.

# include lt;afxcmn.h>

Membros da classe |  Classe base | Gráfico de hierarquia

&Nbsp amostras; MFC exemplo CMNCTRL1 | MFC exemplo MFCIE

Co&nsulte tambémnbsp;CToolBar

Index