Usando controles da barra de ferramentas - Win32 apps | Microsoft Learn

Artigo
03/16/2025

Este tópico contém detalhes de implementação e código de exemplo para usar controles de barra de ferramentas em seus aplicativos.

Nesta secção

Tópico	Descrição
Como criar barras de ferramentas	Para criar uma barra de ferramentas, use a função CreateWindowEx, especificando a TOOLBARCLASSNAME classe de janela. A barra de ferramentas resultante inicialmente não contém botões. Adicione botões à barra de ferramentas usando a mensagem TB_ADDBUTTONS ou TB_INSERTBUTTON. Você deve enviar a mensagem TB_AUTOSIZE depois que todos os itens e cadeias de caracteres foram inseridos no controle, para fazer com que a barra de ferramentas recalcule seu tamanho com base em seu conteúdo.
Como criar barras de ferramentas verticais	A chave para criar uma barra de ferramentas vertical é incluir CCS_VERT no estilo da janela e definir o estilo TBSTATE_WRAP para cada botão.
Como rotular dinamicamente botões da barra de ferramentas	Você pode atribuir texto a um botão existente usando a mensagem TB_SETBUTTONINFO.
Como exibir dicas de ferramentas para botões	Quando você especifica o estilo TBSTYLE_TOOLTIPS, a barra de ferramentas cria e gerencia um controle de dica de ferramenta. O controle de dica de ferramenta está oculto e aparece somente quando os usuários movem o ponteiro sobre um botão da barra de ferramentas e o deixam lá por aproximadamente um segundo.
Como lidar com botões de lista suspensa	Um botão suspenso pode apresentar aos usuários uma lista de opções. Para criar esse estilo de botão, especifique o estilo BTNS_DROPDOWN (também chamado de TBSTYLE_DROPDOWN para compatibilidade com versões anteriores dos controles comuns). Para mostrar um botão suspenso com uma seta, você também deve definir o estilo da barra de ferramentas TBSTYLE_EX_DRAWDDARROWS enviando uma mensagem TB_SETEXTENDEDSTYLE.
Como personalizar barras de ferramentas	A maioria dos aplicativos baseados no Windows usa controles de barra de ferramentas para fornecer aos usuários acesso conveniente à funcionalidade do programa. No entanto, as barras de ferramentas estáticas têm algumas deficiências, como muito pouco espaço para exibir efetivamente todas as ferramentas disponíveis. A solução para esse problema é tornar as barras de ferramentas do seu aplicativo personalizáveis pelo usuário. Em seguida, os usuários podem optar por exibir apenas as ferramentas de que precisam e podem organizá-las de uma maneira que se adapte ao seu estilo de trabalho pessoal.
Como incorporar controles sem botão em barras de ferramentas	As barras de ferramentas suportam apenas botões; portanto, se a sua aplicação requer um tipo diferente de controlo, você deve criar uma janela filha. A ilustração a seguir mostra uma barra de ferramentas com um controle de edição incorporado.
Como usar o Hot-tracking com barras de ferramentas	Quando um ponteiro do mouse passa sobre um item, o item fica quente. Se o rastreamento a quente estiver ativado, o item ativo será realçado. Uma barra de ferramentas criada com o estilo TBSTYLE_FLAT, ou que utiliza Estilos Visuais, oferece suporte ao rastreio visual por padrão.
Como criar uma barra de ferramentas no estilo Internet Explorer	Um dos principais recursos de interface do usuário do Windows Internet Explorer é a barra de ferramentas. Ele não só dá aos usuários acesso a uma ampla gama de recursos, mas também permite que os usuários personalizem seu layout de acordo com suas preferências pessoais.
Como criar uma barra de menus no estilo Internet Explorer	À primeira vista, a barra de menus no Microsoft Internet Explorer 5 e posterior é semelhante a um menu padrão. No entanto, parece bastante diferente quando você começa a usá-lo.