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.

Nota 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, conforme indicado pelo uso do estilo TBSTYLE_FLAT ou TBSTYLE_TRANSPARENT.

Observação

Comctl32.dll versão 6 não é redistribuível, mas está incluída no Windows. Para usar Comctl32.dll versão 6, especifique-a em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Constante	Descrição
TBSTYLE_ALTDRAG	Permite que os usuários alterem a posição de um botão de barra de ferramentas arrastando-o enquanto seguram a tecla ALT. Se esse estilo não for especificado, o usuário deverá manter pressionada a tecla SHIFT enquanto arrasta um botão. Observe que o estilo de CCS_ADJUSTABLE deve ser especificado para permitir que os botões da barra de ferramentas sejam arrastados.
TBSTYLE_CUSTOMERASE	Versão 4.70. Gera códigos de notificação NM_CUSTOMDRAW quando a barra de ferramentas processa mensagens WM_ERASEBKGND .
TBSTYLE_FLAT	Versão 4.70. Cria uma barra de ferramentas simples. Em uma barra de ferramentas simples, a barra de ferramentas e os botões são transparentes e o acompanhamento frequente está habilitado. O texto do botão aparece em bitmaps de botão. Para evitar problemas de repintação, esse estilo deve ser definido antes que o controle da barra de ferramentas fique visível.
TBSTYLE_LIST	Versão 4.70. Cria uma barra de ferramentas simples com texto do botão à direita do bitmap. Caso contrário, esse estilo é idêntico ao TBSTYLE_FLAT. Para evitar problemas de repintação, esse estilo deve ser definido antes que o controle da barra de ferramentas fique visível.
TBSTYLE_REGISTERDROP	Versão 4.71. Gera TBN_GETOBJECT códigos de notificação para solicitar objetos de destino de soltar quando o cursor passa sobre botões da barra de ferramentas.
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.
TBSTYLE_TRANSPARENT	Versão 4.71. 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. Para evitar problemas de repintação, esse estilo deve ser definido antes que o controle da barra de ferramentas fique visível.
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. Quando a barra de ferramentas for encapsulada, a quebra ocorrerá no separador mais à direita ou no botão mais à direita se não houver separadores na barra. Esse estilo deve ser definido para exibir um controle de barra de ferramentas vertical quando a barra de ferramentas faz parte de um controle rebar vertical. Esse estilo não pode ser combinado com CCS_VERT.

Nota: Um botão de barra de ferramentas pode ter uma combinação dos estilos a seguir. Para especificar um estilo de botão, defina os sinalizadores apropriados no membro fsStyle da estrutura TBBUTTON do botão. Nem todos os estilos podem ser combinados.

Para o Shell versão 4.72 e anterior, os sinalizadores de estilo de janela e de botão tinham o formulário TBSTYLE_XXX. Se você estiver compilando um aplicativo com a versão 4.72 ou anterior do Commctrl.h, deverá usar os sinalizadores de estilo do botão TBSTYLE_XXX. Para a versão 5.80 e posterior, todos os estilos de botão têm o formulário BTNS_XXX. Todos os valores de TBSTYLE_XXX têm valores BTNS_XXX equivalentes, com o mesmo significado e valor numérico. Para sua conveniência, ambos os formulários são dados na tabela a seguir.

Constante	Descrição
BTNS_AUTOSIZE	Versão 5.80. Especifica que o controle de barra de ferramentas não deve atribuir a largura padrão ao botão. Em vez disso, a largura do botão será calculada com base na largura do texto mais a imagem do botão. Use o sinalizador de estilo equivalente, TBSTYLE_AUTOSIZE, para a versão 4.72 e anterior.
BTNS_BUTTON	Versão 5.80. Cria um botão padrão. Use o sinalizador de estilo equivalente, TBSTYLE_BUTTON, para a versão 4.72 e anterior. Esse sinalizador é definido como 0 e deve ser usado para indicar que nenhum outro sinalizador está definido.
BTNS_CHECK	Versão 5.80. Cria um botão de push de estado duplo que alterna entre os estados pressionado e não compactado sempre que o usuário clica nele. O botão tem uma cor de tela de fundo diferente quando está no estado pressionado. Use o sinalizador de estilo equivalente, TBSTYLE_CHECK, para a versão 4.72 e anterior.
BTNS_CHECKGROUP	Versão 5.80. Cria um botão que permanece pressionado até que outro botão no grupo seja pressionado, semelhante aos botões de opção (também conhecidos como botões de opção). É equivalente a combinar BTNS_CHECK e BTNS_GROUP. Use o sinalizador de estilo equivalente, TBSTYLE_CHECKGROUP, para a versão 4.72 e anterior.
BTNS_DROPDOWN	Versão 5.80. Cria um botão de estilo suspenso que pode exibir uma lista quando o botão é clicado. Em vez da mensagem de WM_COMMAND usada para botões normais, os botões suspensos enviam um código de notificação TBN_DROPDOWN . Em seguida, um aplicativo pode fazer com que o manipulador de notificação exiba uma lista de opções. Use o sinalizador de estilo equivalente, TBSTYLE_DROPDOWN, para a versão 4.72 e anterior. Se a barra de ferramentas tiver o TBSTYLE_EX_DRAWDDARROWS estilo estendido, os botões suspensos terão uma seta suspensa exibida em uma seção separada à direita. Se a seta for clicada, um TBN_DROPDOWN código de notificação será enviado. Se o botão associado for clicado, uma mensagem WM_COMMAND será enviada.
BTNS_GROUP	Versão 5.80. Quando combinado com BTNS_CHECK, cria um botão que permanece pressionado até que outro botão no grupo seja pressionado. Use o sinalizador de estilo equivalente, TBSTYLE_GROUP, para a versão 4.72 e anterior.
BTNS_NOPREFIX	Versão 5.80. Especifica que o texto do botão não terá um prefixo de acelerador associado a ele. Use o sinalizador de estilo equivalente, TBSTYLE_NOPREFIX, para a versão 4.72 e anterior.
BTNS_SEP	Versão 5.80. Cria um separador, fornecendo uma pequena lacuna entre grupos de botões. Um botão que tem esse estilo não recebe entrada do usuário. Use o sinalizador de estilo equivalente, TBSTYLE_SEP, para a versão 4.72 e anterior.
BTNS_SHOWTEXT	Versão 5.81. Especifica que o texto do botão deve ser exibido. Todos os botões podem ter texto, mas somente esses botões com o estilo do botão BTNS_SHOWTEXT o exibirão. Esse estilo de botão deve ser usado com o estilo TBSTYLE_LIST e o estilo estendido TBSTYLE_EX_MIXEDBUTTONS . Se você definir texto para botões que não têm o estilo BTNS_SHOWTEXT, o controle da barra de ferramentas o exibirá automaticamente como uma dica de ferramenta quando o cursor passar o mouse sobre o botão. Esse recurso permite que seu aplicativo evite lidar com o código de notificação TBN_GETINFOTIP ou TTN_GETDISPINFO para a barra de ferramentas.
BTNS_WHOLEDROPDOWN	Versão 5.80. Especifica que o botão terá uma seta suspensa, mas não como uma seção separada. Botões com esse estilo se comportam da mesma forma, independentemente de o TBSTYLE_EX_DRAWDDARROWS estilo estendido ser definido.
TBSTYLE_AUTOSIZE	Equivalente a BTNS_AUTOSIZE. Use TBSTYLE_AUTOSIZE para a versão 4.72 e anterior.
TBSTYLE_BUTTON	Equivalente a BTNS_BUTTON. Use TBSTYLE_BUTTON para a versão 4.72 e anterior.
TBSTYLE_CHECK	Equivalente a BTNS_CHECK. Use TBSTYLE_CHECK para a versão 4.72 e anterior.
TBSTYLE_CHECKGROUP	Equivalente a BTNS_CHECKGROUP. Use TBSTYLE_CHECKGROUP para a versão 4.72 e anterior.
TBSTYLE_DROPDOWN	Equivalente a BTNS_DROPDOWN. Use TBSTYLE_DROPDOWN para a versão 4.72 e anterior.
TBSTYLE_GROUP	Equivalente a BTNS_GROUP. Use TBSTYLE_GROUP para a versão 4.72 e anterior.
TBSTYLE_NOPREFIX	Equivalente a BTNS_NOPREFIX. Use TBSTYLE_NOPREFIX para a versão 4.72 e anterior.
TBSTYLE_SEP	Equivalente a BTNS_SEP. Use TBSTYLE_SEP para a versão 4.72 e anterior.

Requisitos

Requisito	Valor
parâmetro	CommCtrl.h