Partilhar via


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 etiqueta 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. Para usar um objeto CToolBarCtrl, configure estas estruturas de dados. Para obter uma lista das estruturas de dados, confira 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 objeto CToolBarCtrl, 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 objeto CToolBarCtrl. 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 Dimensionamento Automático para que a cadeia de caracteres ou as cadeias de caracteres apareçam.

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

  4. Se você quiser dicas de ferramenta, trate mensagens TTN_NEEDTEXT na janela de proprietário da barra de ferramentas, conforme descrito em Tratamento de notificações de dica de ferramentas.

  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.

Confira também

Usando CToolBarCtrl
Controles