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 estruturas — que associam uma imagem e/ou cadeia de TBBUTTON caracteres à posição, estilo, estado e ID de comando do botão. Cada um dos elementos dessas estruturas de dados é referido 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; Não é possível 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 Create para criar o controle comum da barra de ferramentas do Windows e anexe-o ao CToolBarCtrl objeto. Se você quiser imagens de bitmap para botões, adicione os bitmaps de botão à barra de ferramentas chamando AddBitmap. Se desejar 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 a cadeia ou cadeias de caracteres apareçam.

3. Adicione estruturas de botões à barra de ferramentas chamando AddButtons.

4. Se pretender dicas sobre ferramentas, trate as mensagens TTN_NEEDTEXT na janela do controlador da barra de ferramentas, conforme descrito em Manipulando notificações de dicas de ferramentas.

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

Ver também

Usando CToolBarCtrl
Controlos