Barra de ferramentas
Esta seção contém informações sobre os elementos de programação usados com controles da barra de ferramentas.
Visão geral
| Tópico | Índice |
|---|---|
| Sobre os controles da barra de ferramentas | Uma barra de ferramentas é um controle que contém um ou mais botões. Cada botão, quando clicado por um usuário, envia uma mensagem de comando para a janela pai. Normalmente, os botões em uma barra de ferramentas correspondem a itens no menu do aplicativo, fornecendo uma maneira adicional e mais direta para o usuário acessar os comandos de um aplicativo. |
| Usando controles da barra de ferramentas | Este tópico contém detalhes de implementação e código de exemplo para usar controles de barra de ferramentas em seus aplicativos. |
Funções
| Tópico | Índice |
|---|---|
| CreateMappedBitmap | Cria um bitmap para uso em uma barra de ferramentas. |
| CreateToolbarEx | Cria uma janela da barra de ferramentas e adiciona os botões especificados à barra de ferramentas.
Nota: Esta função foi preterida, porque não suporta todos os recursos das barras de ferramentas. Use CreateWindowEx em vez disso. Para obter exemplos, consulte Usando controles da barra de ferramentas. |
Mensagens
| Tópico | Índice |
|---|---|
| TB_ADDBITMAP | Adiciona uma ou mais imagens à lista de imagens de botão disponíveis para uma barra de ferramentas. |
| TB_ADDBUTTONS | Adiciona um ou mais botões a uma barra de ferramentas. |
| TB_ADDSTRING | Adiciona uma nova cadeia de caracteres ao pool de cadeias de caracteres da barra de ferramentas. |
| TB_AUTOSIZE | Faz com que uma barra de ferramentas seja redimensionada. |
| TB_BUTTONCOUNT | Recupera uma contagem dos botões atualmente na barra de ferramentas. |
| TB_BUTTONSTRUCTSIZE | Especifica o tamanho do TBBUTTON estrutura. |
| TB_CHANGEBITMAP | Altera o bitmap de um botão em uma barra de ferramentas. |
| TB_CHECKBUTTON | Marca ou desmarca um determinado botão em uma barra de ferramentas. |
| TB_COMMANDTOINDEX | Recupera o índice baseado em zero para o botão associado ao identificador de comando especificado. |
| TB_CUSTOMIZE | Exibe a caixa de diálogo Personalizar Barra de Ferramentas. |
| TB_DELETEBUTTON | Exclui um botão da barra de ferramentas. |
| TB_ENABLEBUTTON | Habilita ou desabilita o botão especificado em uma barra de ferramentas. |
| TB_GETANCHORHIGHLIGHT | Recupera a configuração de realce de âncora para uma barra de ferramentas. |
| TB_GETBITMAP | Recupera o índice do bitmap associado a um botão em uma barra de ferramentas. |
| TB_GETBITMAPFLAGS | Recupera os sinalizadores que descrevem o tipo de bitmap a ser usado. |
| TB_GETBUTTON | Recupera informações sobre o botão especificado em uma barra de ferramentas. |
| TB_GETBUTTONINFO | Recupera informações estendidas para um botão em uma barra de ferramentas. |
| TB_GETBUTTONSIZE | Recupera a largura e a altura atuais dos botões da barra de ferramentas, em pixels. |
| TB_GETBUTTONTEXT | Recupera o texto de exibição de um botão em uma barra de ferramentas. |
| TB_GETCOLORSCHEME | Recupera as informações do esquema de cores do controle da barra de ferramentas. |
| TB_GETDISABLEDIMAGELIST | Recupera a lista de imagens que um controle de barra de ferramentas usa para exibir botões inativos. |
| TB_GETEXTENDEDSTYLE | Recupera os estilos estendidos para um controle de barra de ferramentas. |
| TB_GETHOTIMAGELIST | Recupera a lista de imagens que um controle de barra de ferramentas usa para exibir botões de atalho. |
| TB_GETHOTITEM | Recupera o índice do item ativo em uma barra de ferramentas. |
| TB_GETIDEALSIZE | Obtém o tamanho ideal da barra de ferramentas. |
| TB_GETIMAGELIST | Recupera a lista de imagens que um controle de barra de ferramentas usa para exibir botões em seu estado padrão. Um controle de barra de ferramentas usa essa lista de imagens para exibir botões quando eles não estão quentes ou desativados. |
| TB_GETIMAGELISTCOUNT | Obtém o número de listas de imagens associadas à barra de ferramentas. |
| TB_GETINSERTMARK | Recupera a marca de inserção atual da barra de ferramentas. |
| TB_GETINSERTMARKCOLOR | Recupera a cor usada para desenhar a marca de inserção para a barra de ferramentas. |
| TB_GETITEMDROPDOWNRECT | Obtém o retângulo delimitador da janela suspensa para um item da barra de ferramentas com estilo BTNS_DROPDOWN. |
| TB_GETITEMRECT | Recupera o retângulo delimitador de um botão em uma barra de ferramentas. |
| TB_GETMAXSIZE | Recupera o tamanho total de todos os botões e separadores visíveis na barra de ferramentas. |
| TB_GETMETRICS | Recupera as métricas de um controle de barra de ferramentas. |
| TB_GETOBJECT | Recupera o IDropTarget para um controle de barra de ferramentas. |
| TB_GETPADDING | Recupera o preenchimento para um controle de barra de ferramentas. |
| TB_GETPRESSEDIMAGELIST | Obtém a lista de imagens que um controle de barra de ferramentas usa para exibir botões em um estado pressionado. |
| TB_GETRECT | Recupera o retângulo delimitador de um botão da barra de ferramentas especificado. |
| TB_GETROWS | Recupera o número de linhas de botões em uma barra de ferramentas com o estilo TBSTYLE_WRAPABLE. |
| TB_GETSTATE | Recupera informações sobre o estado do botão especificado em uma barra de ferramentas, como se ele está habilitado, pressionado ou marcado. |
| TB_GETSTRING | Recupera uma cadeia de caracteres do pool de cadeias de caracteres de uma barra de ferramentas. |
| TB_GETSTYLE | Recupera os estilos atualmente em uso para um controle de barra de ferramentas. |
| TB_GETTEXTROWS | Recupera o número máximo de linhas de texto que podem ser exibidas em um botão da barra de ferramentas. |
| TB_GETTOOLTIPS | Recupera o identificador para o controle de dica de ferramenta, se houver, associado à barra de ferramentas. |
| TB_GETUNICODEFORMAT | Recupera o sinalizador de formato de caractere Unicode para o controle. |
| TB_HASACCELERATOR |
Destinados a uso interno; Não recomendado para uso em aplicações. Recupera uma contagem de botões da barra de ferramentas que têm o caractere acelerador especificado. |
| TB_HIDEBUTTON | Oculta ou mostra o botão especificado em uma barra de ferramentas. |
| TB_HITTEST | Determina onde um ponto está em um controle de barra de ferramentas. |
| TB_INDETERMINATE | Define ou limpa o estado indeterminado do botão especificado em uma barra de ferramentas. |
| TB_INSERTBUTTON | Insere um botão em uma barra de ferramentas. |
| TB_INSERTMARKHITTEST | Recupera as informações da marca de inserção de um ponto em uma barra de ferramentas. |
| TB_ISBUTTONCHECKED | Determina se o botão especificado em uma barra de ferramentas está marcado. |
| TB_ISBUTTONENABLED | Determina se o botão especificado em uma barra de ferramentas está habilitado. |
| TB_ISBUTTONHIDDEN | Determina se o botão especificado em uma barra de ferramentas está oculto. |
| TB_ISBUTTONHIGHLIGHTED | Verifica o estado de realce de um botão da barra de ferramentas. |
| TB_ISBUTTONINDETERMINATE | Determina se o botão especificado em uma barra de ferramentas é indeterminado. |
| TB_ISBUTTONPRESSED | Determina se o botão especificado em uma barra de ferramentas é pressionado. |
| TB_LOADIMAGES | Carrega imagens de botão definidas pelo sistema na lista de imagens de um controle de barra de ferramentas. |
| TB_MAPACCELERATOR | Determina a ID do botão que corresponde ao caractere acelerador especificado. |
| TB_MARKBUTTON | Define o estado de realce de um determinado botão em um controle de barra de ferramentas. |
| TB_MOVEBUTTON | Move um botão de um índice para outro. |
| TB_PRESSBUTTON | Pressiona ou libera o botão especificado em uma barra de ferramentas. |
| TB_REPLACEBITMAP | Substitui um bitmap existente por um novo bitmap. |
| TB_SAVERESTORE | Envie esta mensagem para iniciar o salvamento ou restauração do estado da barra de ferramentas. |
| TB_SETANCHORHIGHLIGHT | Define a configuração de realce de âncora para uma barra de ferramentas. |
| TB_SETBITMAPSIZE | Define o tamanho das imagens bitmapped a serem adicionadas a uma barra de ferramentas. |
| TB_SETBOUNDINGSIZE |
Destinados a uso interno; Não recomendado para uso em aplicações. Define o tamanho delimitador para um controle de barra de ferramentas de várias colunas. |
| TB_SETBUTTONINFO | Define as informações de um botão existente em uma barra de ferramentas. |
| TB_SETBUTTONSIZE | Define o tamanho dos botões em uma barra de ferramentas. |
| TB_SETBUTTONWIDTH | Define as larguras mínima e máxima do botão no controle da barra de ferramentas. |
| TB_SETCMDID | Define o identificador de comando de um botão da barra de ferramentas. |
| TB_SETCOLORSCHEME | Define as informações do esquema de cores para o controle da barra de ferramentas. |
| TB_SETDISABLEDIMAGELIST | Define a lista de imagens que o controle da barra de ferramentas usará para exibir botões desativados. |
| TB_SETDRAWTEXTFLAGS | Define os sinalizadores de desenho de texto para a barra de ferramentas. |
| TB_SETEXTENDEDSTYLE | Define os estilos estendidos para um controle de barra de ferramentas. |
| TB_SETHOTIMAGELIST | Define a lista de imagens que o controle da barra de ferramentas usará para exibir botões atalhos. |
| TB_SETHOTITEM | Define o item ativo em uma barra de ferramentas. |
| TB_SETHOTITEM2 | Define o item ativo em uma barra de ferramentas. |
| TB_SETIMAGELIST | Define a lista de imagens que a barra de ferramentas usa para exibir botões que estão em seu estado padrão. |
| TB_SETINDENT | Define o recuo para o primeiro botão em um controle de barra de ferramentas. |
| TB_SETINSERTMARK | Define a marca de inserção atual para a barra de ferramentas. |
| TB_SETINSERTMARKCOLOR | Define a cor usada para desenhar a marca de inserção para a barra de ferramentas. |
| TB_SETLISTGAP | Define a distância entre os botões da barra de ferramentas em uma barra de ferramentas específica. |
| TB_SETMAXTEXTROWS | Define o número máximo de linhas de texto exibidas em um botão da barra de ferramentas. |
| TB_SETMETRICS | Define as métricas de um controle de barra de ferramentas. |
| TB_SETPADDING | Define o preenchimento para um controle de barra de ferramentas. |
| TB_SETPARENT | Define a janela para a qual o controle da barra de ferramentas envia códigos de notificação. |
| TB_SETPRESSEDIMAGELIST | Define a lista de imagens que a barra de ferramentas usa para exibir botões que estão em um estado pressionado. |
| TB_SETROWS | Define o número de linhas de botões em uma barra de ferramentas. |
| TB_SETSTATE | Define o estado do botão especificado em uma barra de ferramentas. |
| TB_SETSTYLE | Define o estilo de um controle de barra de ferramentas. |
| TB_SETTOOLTIPS | Associa um controle de dica de ferramenta a uma barra de ferramentas. |
| TB_SETUNICODEFORMAT | Define o sinalizador de formato de caractere Unicode para o controle. Esta mensagem permite que você altere o conjunto de caracteres usado pelo controle em tempo de execução em vez de ter que recriar o controle. |
| TB_SETWINDOWTHEME | Define o estilo visual de um controle de barra de ferramentas. |
| TB_TRANSLATEACCELERATOR | Passa uma mensagem de teclado para a barra de ferramentas. |
Notificações
| Tópico | Índice |
|---|---|
| NM_CHAR (barra de ferramentas) | Enviado pela barra de ferramentas quando recebe uma mensagem WM_CHAR. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_CLICK (barra de ferramentas) | Enviado por um controle de barra de ferramentas quando o usuário clica em um item com o botão esquerdo do mouse. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_CUSTOMDRAW (barra de ferramentas) | Enviado pela barra de ferramentas para notificar a janela pai sobre operações de desenho. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_DBLCLK (barra de ferramentas) | Notifica a janela pai de um controle de barra de ferramentas que o usuário clicou duas vezes no botão esquerdo do mouse dentro do controle. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_KEYDOWN (barra de ferramentas) | Enviado por um controle quando o controle tem o foco do teclado e o usuário pressiona uma tecla. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_LDOWN | Notifica a janela pai de uma barra de ferramentas de que o botão esquerdo do mouse foi pressionado. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_RCLICK (barra de ferramentas) | Enviado por um controle de barra de ferramentas quando o usuário clica na barra de ferramentas com o botão direito do mouse. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_RDBLCLK (barra de ferramentas) | Notifica a janela pai de um controle de que o usuário clicou duas vezes no botão direito do mouse dentro do controle. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_RELEASEDCAPTURE (barra de ferramentas) | Notifica a janela pai de um controle de barra de ferramentas de que o controle está liberando a captura do mouse. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| NM_TOOLTIPSCREATED (barra de ferramentas) | Notifica a janela pai de uma barra de ferramentas de que a barra de ferramentas criou um controle de dica de ferramenta. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_BEGINADJUST | Notifica a janela pai de uma barra de ferramentas de que o usuário começou a personalizar uma barra de ferramentas. Este código de mensagem é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_BEGINDRAG | Notifica a janela pai de uma barra de ferramentas de que o usuário começou a arrastar um botão em uma barra de ferramentas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_CUSTHELP | Notifica a janela pai de uma barra de ferramentas de que o usuário escolheu o botão Ajuda na caixa de diálogo Personalizar Barra de Ferramentas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_DELETINGBUTTON | Enviado por um controle de barra de ferramentas quando um botão está prestes a ser excluído. |
| TBN_DRAGOUT | Enviado por um controle de barra de ferramentas quando o usuário clica em um botão e, em seguida, move o cursor para fora do botão. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_DRAGOVER | Verifica se uma mensagem TB_MARKBUTTON deve ser enviada para um botão que está sendo arrastado. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_DROPDOWN | Enviado por um controle de barra de ferramentas quando o usuário clica em um botão suspenso. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_DUPACCELERATOR | Verifica se uma tecla aceleradora pode ser usada em duas ou mais barras de ferramentas ativas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_ENDADJUST | Notifica a janela pai de uma barra de ferramentas de que o usuário parou de personalizar uma barra de ferramentas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_ENDDRAG | Notifica a janela pai da barra de ferramentas de que o usuário parou de arrastar um botão em uma barra de ferramentas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_GETBUTTONINFO | Recupera informações de personalização da barra de ferramentas e notifica a janela pai da barra de ferramentas sobre quaisquer alterações feitas na barra de ferramentas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_GETDISPINFO | Recupera informações de exibição para um item da barra de ferramentas. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY. |
| TBN_GETINFOTIP | Recupera informações de dica de informações para um item da barra de ferramentas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_GETOBJECT | Enviado por um controle de barra de ferramentas que usa o estilo TBSTYLE_REGISTERDROP para solicitar um objeto de destino de soltar quando o ponteiro passa sobre um de seus botões. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_HOTITEMCHANGE | Enviado por um controle de barra de ferramentas quando o item quente (realçado) é alterado. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_INITCUSTOMIZE | Notifica a janela pai de uma barra de ferramentas de que a personalização foi iniciada. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_MAPACCELERATOR | Solicita o índice do botão na barra de ferramentas correspondente ao caractere acelerador especificado. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_QUERYDELETE | Notifica a janela pai da barra de ferramentas se um botão pode ser excluído de uma barra de ferramentas enquanto o usuário está personalizando a barra de ferramentas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_QUERYINSERT | Notifica a janela pai da barra de ferramentas se um botão pode ser inserido à esquerda do botão especificado enquanto o usuário está personalizando uma barra de ferramentas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_RESET | Notifica a janela pai da barra de ferramentas de que o usuário redefiniu o conteúdo da caixa de diálogo Personalizar Barra de Ferramentas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_RESTORE | Notifica a janela pai de uma barra de ferramentas de que uma barra de ferramentas está em processo de restauração. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_SAVE | Notifica a janela pai de uma barra de ferramentas de que uma barra de ferramentas está sendo salva. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_TOOLBARCHANGE | Notifica a janela pai da barra de ferramentas de que o usuário personalizou uma barra de ferramentas. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_WRAPACCELERATOR | Solicita o índice do botão em uma ou mais barras de ferramentas correspondentes ao caractere acelerador especificado. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| TBN_WRAPHOTITEM | Notifica um aplicativo com duas ou mais barras de ferramentas que o item ativo está prestes a ser alterado. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
Estruturas
| Tópico | Índice |
|---|---|
| COLORMAP | Contém informações usadas pelo função de CreateMappedBitmap para mapear as cores do bitmap. |
| NMTBCUSTOMDRAW | Contém informações específicas para um NM_CUSTOMDRAW código de notificação enviado por um controle de barra de ferramentas. |
| NMTBDISPINFO | Contém e recebe informações de exibição para um item da barra de ferramentas. Essa estrutura é usada com o código de notificação TBN_GETDISPINFO. |
| NMTBGETINFOTIP | Contém e recebe informações de dica de informação para um item da barra de ferramentas. Essa estrutura é usada com o código de notificação TBN_GETINFOTIP. |
| NMTBHOTITEM | Contém informações usadas com o código de notificação TBN_HOTITEMCHANGE. |
| NMTBRESTORE | Permite que os aplicativos extraiam as informações que foram colocadas em NMTBSAVE quando o estado da barra de ferramentas foi salvo. Essa estrutura é passada para os aplicativos quando eles recebem um código de notificação TBN_RESTORE. |
| NMTBSAVE | Essa estrutura é passada para os aplicativos quando eles recebem um código de notificação TBN_SAVE. Ele contém informações sobre o botão que está sendo salvo no momento. Os aplicativos podem modificar os valores dos membros para salvar informações adicionais. |
| NMTOOLBAR | Contém informações usadas para processar códigos de notificação da barra de ferramentas. Esta estrutura substitui a estrutura TBNOTIFY. |
| TBADDBITMAP | Adiciona um bitmap que contém imagens de botão a uma barra de ferramentas. |
| TBBUTTON | Contém informações sobre um botão em uma barra de ferramentas. |
| TBBUTTONINFO | Contém ou recebe informações para um botão específico em uma barra de ferramentas. |
| TBINSERTMARK | Contém informações sobre a marca de inserção em um controle de barra de ferramentas. |
| TBMETRICS | Define as métricas de uma barra de ferramentas que são usadas para reduzir ou expandir itens da barra de ferramentas. |
| TBREPLACEBITMAP | Usado com a mensagem TB_REPLACEBITMAP para substituir um bitmap da barra de ferramentas por outro. |
| TBSAVEPARAMS | Especifica o local no Registro onde a mensagem TB_SAVERESTORE armazena e recupera informações sobre o estado de uma barra de ferramentas. |
Constantes
| Tópico | Índice |
|---|---|
| dos Estados do botão da barra de ferramentas | Esta seção lista os estados que um botão da barra de ferramentas pode ter. |
| controle da barra de ferramentas e estilos de botão | Os estilos de janela a seguir são específicos para barras de ferramentas. Eles são combinados com outros estilos de janela quando a barra de ferramentas é criada. Observação Para controles comuns versão 6.00, se um de estilo visual estiver sendo usado com a barra de ferramentas, os botões serão sempre transparentes, independentemente da configuração de estilo. Caso contrário, o comportamento de transparência é normal, conforme indicado pelo uso do estilo TBSTYLE_FLAT ou TBSTYLE_TRANSPARENT. Nota: Comctl32.dll versão 6 não é redistribuível, mas está incluído no Windows ou posterior. Para usar Comctl32.dll versão 6, especifique-a em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais. |
| Estilos estendidos da barra de ferramentas | Esta seção lista os estilos estendidos suportados pelos controles da barra de ferramentas. |
| Valores de índice de imagem do botão padrão da barra de ferramentas | Esta seção especifica valores de índice de imagens em bitmaps padrão. |