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:
Construir o CToolBarCtrl objeto.
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.
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.
Adicionar estruturas botão à barra de ferramentas chamando AddButtons.
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.
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