Criando um objeto CToolBarCtrl

Os objetos CToolBarCtrl contêm várias estruturas de dados internas – uma lista de bitmaps de imagem de botão, uma lista de cadeias de caracteres de rótulo de botão e uma lista de TBBUTTON estruturas – que associam uma imagem e/ou cadeia de caracteres à posição, estilo, estado e ID de comando do botão. Cada um dos elementos dessas estruturas de dados é referenciado por um índice baseado em zero. Antes de usar um CToolBarCtrl objeto, você deve configurar essas estruturas de dados. Para obter uma lista das estruturas de dados, consulte Controles da Barra de Ferramentas no SDK do Windows. A lista de cadeias de caracteres só pode ser usada para rótulos de botão; você não pode recuperar cadeias de caracteres da barra de ferramentas.

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

Para usar um objeto CToolBarCtrl

1. Construa o objeto CToolBarCtrl .

2. Chame Criar para criar o controle comum da barra de ferramentas do Windows e anexá-lo ao CToolBarCtrl objeto. Se você quiser imagens de bitmap para botões, adicione os bitmaps de botão à barra de ferramentas chamando AddBitmap. Se você quiser rótulos de cadeia de caracteres para botões, adicione as cadeias de caracteres à barra de ferramentas chamando AddString e/ou AddStrings. Depois de chamar AddString e/ou AddStrings, você deve chamar AutoSize para que o texto ou os textos apareçam.

3. Adicione estruturas de botão à barra de ferramentas chamando AddButtons.

4. Se você quiser dicas de ferramentas, manipule mensagens TTN_NEEDTEXT na janela do proprietário da barra de ferramentas, conforme descrito em Como Manipular Notificações de Dica de Ferramenta.

5. Se você quiser que o usuário possa personalizar a barra de ferramentas, trate as mensagens de notificação de personalização na janela proprietário, conforme descrito em Tratamento de notificações de personalização.

Consulte também

Usando CToolBarCtrl
Controles