Barra de ferramentas
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. |