Barra de ferramentas

  • Artigo

Esta seção contém informações sobre os elementos de programação usados com controles da barra de ferramentas.

Visões gerais

Tópico Contents
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, oferecendo um modo adicional e mais direto 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 Contents
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 todas as funcionalidades das barras de ferramentas. Em vez disso, use CreateWindowEx. Para obter exemplos, consulte Usando controles da barra de ferramentas.

Mensagens

Tópico Contents
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 da estrutura TBBUTTON .
TB_CHANGEBITMAP Altera o bitmap de um botão em uma barra de ferramentas.
TB_CHECKBUTTON Verifica ou cancela a verificação de um determinado botão em uma barra de ferramentas.
TB_COMMANDTOINDEX Recupera o índice baseado em zero do 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 de um botão em uma barra de ferramentas.
TB_GETBUTTONSIZE Recupera a largura e a altura atuais dos botões de 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 quentes.
TB_GETHOTITEM Recupera o índice do item de acesso frequente 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 desabilitados.
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 da barra de ferramentas.
TB_GETITEMDROPDOWNRECT Obtém o retângulo delimitador da janela suspensa para um item da barra de ferramentas com BTNS_DROPDOWN de estilo.
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 visíveis e separadores 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 de 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 para um botão de 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 usados 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 Destinado ao uso interno; não recomendado para uso em aplicativos.
Recupera uma contagem de botões da barra de ferramentas que têm o caractere acelerador especificado.
TB_HIDEBUTTON Oculta ou exibe o botão especificado em uma barra de ferramentas.
TB_HITTEST Determina a localização de um ponto 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 de 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 da 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 a restauração de um 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 de bitmap a serem adicionadas a uma barra de ferramentas.
TB_SETBOUNDINGSIZE Destinado ao uso interno; não recomendado para uso em aplicativos.
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ínimas e máximas do botão no controle de 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 de barra de ferramentas usará para exibir os botões desabilitados.
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 quentes.
TB_SETHOTITEM Define o item de acesso frequente em uma barra de ferramentas.
TB_SETHOTITEM2 Define o item de acesso frequente 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 do primeiro botão em um controle de barra de ferramentas.
TB_SETINSERTMARK Define a marca de inserção atual da barra de ferramentas.
TB_SETINSERTMARKCOLOR Define a cor usada para desenhar a marca de inserção da 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 de barra de ferramentas.
TB_SETMETRICS Define as métricas de um controle de barra de ferramentas.
TB_SETPADDING Define o preenchimento de 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 da 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. Essa 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 do controle de barra de ferramentas.
TB_TRANSLATEACCELERATOR Passa uma mensagem de teclado para a barra de ferramentas.

Notifications

Tópico Contents
NM_CHAR (barra de ferramentas) Enviado pela barra de ferramentas quando recebe uma mensagem WM_CHAR. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_CUSTOMDRAW (barra de ferramentas) Enviado pela barra de ferramentas para notificar sua janela pai sobre operações de desenho. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_LDOWN Notifica a janela pai de uma barra de ferramentas de que o botão esquerdo do mouse foi pressionado. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_RDBLCLK (barra de ferramentas) Notifica a janela pai de um controle que o usuário clicou duas vezes no botão direito do mouse dentro do controle. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
NM_RELEASEDCAPTURE (barra de ferramentas) Notifica a janela pai de um controle de barra de ferramentas que o controle está liberando a captura do mouse. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse 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. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_DELETINGBUTTON Enviado por um controle da 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. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_DRAGOVER Verifica se uma mensagem TB_MARKBUTTON deve ser enviada para um botão que está sendo arrastado. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_DROPDOWN Enviado por um controle de barra de ferramentas quando o usuário clica em um botão suspenso. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_DUPACCELERATOR Verifica se uma tecla aceleradora pode ser usada em duas ou mais barras de ferramentas ativas. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_GETDISPINFO Recupera informações de exibição de um item da barra de ferramentas. Esta notificação é enviada sob a forma de uma mensagem WM_NOTIFY .
TBN_GETINFOTIP Recupera informações de infodica para um item da barra de ferramentas. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_GETOBJECT Enviado por um controle de barra de ferramentas que usa o estilo TBSTYLE_REGISTERDROP para solicitar um objeto de destino solto quando o ponteiro passa sobre um de seus botões. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_HOTITEMCHANGE Enviado por um controle de barra de ferramentas quando o item quente (realçado) é alterado. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_INITCUSTOMIZE Notifica a janela pai de uma barra de ferramentas de que a personalização foi iniciada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_MAPACCELERATOR Solicita o índice do botão na barra de ferramentas correspondente ao caractere acelerador especificado. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de 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. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_SAVE Notifica a janela pai de uma barra de ferramentas de que uma barra de ferramentas está em processo de ser salva. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_TOOLBARCHANGE Notifica a janela pai da barra de ferramentas de que o usuário personalizou uma barra de ferramentas. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_WRAPACCELERATOR Solicita o índice do botão em uma ou mais barras de ferramentas correspondentes ao caractere acelerador especificado. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
TBN_WRAPHOTITEM Notifica um aplicativo com duas ou mais barras de ferramentas que o item quente está prestes a mudar. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.

Estruturas

Tópico Contents
MAPA DE CORES Contém informações usadas pela função CreateMappedBitmap para mapear as cores do bitmap.
NMTBCUSTOMDRAW Contém informações específicas para um código de notificação NM_CUSTOMDRAW 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 infodica 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 no 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.
Barra de ferramentas do NM Contém informações usadas para processar códigos de notificação da barra de ferramentas. Essa estrutura substitui a estrutura TBNOTIFY .
TBADDBITMAP Adiciona um bitmap que contém imagens de botão a uma barra de ferramentas.
Botão TBBUTTON Contém informações sobre um botão em uma barra de ferramentas.
TBBUTTONINFO Contém ou recebe informações de 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 Contents
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 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, como indicado pelo uso do estilo TBSTYLE_FLAT ou TBSTYLE_TRANSPARENT. Nota: Comctl32.dll versão 6 não é redistribuível, mas está incluída 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.