Partilhar via


Personalizando a aparência de um controle de barra de ferramentas

A classe CToolBarCtrl fornece muitos estilos que afetam a aparência (e, ocasionalmente, o comportamento) do objeto da barra de ferramentas. Modifique o objeto da barra de ferramentas definindo o parâmetro dwCtrlStyle da função de membro CToolBarCtrl::Create (ou CToolBar::CreateEx) ao criar pela primeira vez o controle da barra de ferramentas.

Os estilos a seguir afetam o aspecto "3D" dos botões da barra de ferramentas e o posicionamento do texto do botão:

  • TBSTYLE_FLAT Cria uma barra de ferramentas plana em que a barra de ferramentas e os botões são transparentes. O texto do botão aparece em bitmaps de botão. Quando esse estilo é usado, o botão abaixo do cursor é realçado automaticamente.

  • TBSTYLE_TRANSPARENT Cria uma barra de ferramentas transparente. Em uma barra de ferramentas transparente, a barra de ferramentas é transparente, mas os botões não são. O texto do botão aparece em bitmaps de botão.

  • TBSTYLE_LIST Coloca o texto do botão à direita dos bitmaps de botão.

Observação

Para evitar problemas de redesenho, os estilos TBSTYLE_FLAT e TBSTYLE_TRANSPARENT devem ser definidos antes que o objeto da barra de ferramentas fique visível.

Os estilos a seguir determinam se a barra de ferramentas permite que um usuário reposicione botões individuais dentro de um objeto da barra de ferramentas usando arrastar e soltar:

  • TBSTYLE_ALTDRAG Permite que os usuários alterem a posição de um botão de barra de ferramentas arrastando-o enquanto seguram ALT. Se esse estilo não for especificado, o usuário deverá segurar SHIFT enquanto arrasta um botão.

    Observação

    O estilo CCS_ADJUSTABLE deve ser especificado para permitir que os botões da barra de ferramentas sejam arrastados.

  • TBSTYLE_REGISTERDROP Gera mensagens de notificação TBN_GETOBJECT para solicitar objetos de destino de soltar quando o ponteiro do mouse passar sobre botões da barra de ferramentas.

Os estilos restantes afetam aspectos visuais e não visuais do objeto da barra de ferramentas:

  • TBSTYLE_WRAPABLE Cria uma barra de ferramentas que pode ter várias linhas de botões. Os botões da barra de ferramentas podem "quebrar" para a próxima linha quando a barra de ferramentas ficar muito estreita para incluir todos os botões na mesma linha. A quebra ocorre em limites de separação e não de grupo.

  • TBSTYLE_CUSTOMERASE Gera mensagens de notificação NM_CUSTOMDRAW quando processa mensagens WM_ERASEBKGND.

  • TBSTYLE_TOOLTIPS Cria um controle de dica de ferramenta que um aplicativo pode usar para exibir texto descritivo para os botões na barra de ferramentas.

Para obter uma listagem completa de estilos de barra de ferramentas e estilos estendidos, consulte Controle da Barra de Ferramentas e Estilos de Botão e Estilos Estendidos da Barra de Ferramentas no SDK do Windows.

Confira também

Usando CToolBarCtrl
Controles