Estilos de botão
Especifica uma combinação de estilos de botão. Se você criar um botão usando a classe BUTTON com a função CreateWindow ou CreateWindowEx , poderá especificar qualquer um dos estilos de botão listados abaixo.
Exemplo
HRESULT Button::CreateText(HWND hParent, const TCHAR *szCaption, int nID,
const Rect& rcBound)
{
CREATESTRUCT create;
ZeroMemory(&create, sizeof(CREATESTRUCT));
create.x = rcBound.left;
create.y = rcBound.top;
create.cx = rcBound.right - create.x;
create.cy = rcBound.bottom - create.y;
create.hwndParent = hParent;
create.lpszName = szCaption;
create.hMenu = (HMENU)(INT_PTR)nID;
create.lpszClass = TEXT("BUTTON");
create.style = BS_PUSHBUTTON | BS_FLAT;
return Control::Create(create);
}
Exemplo das Amostras do Windows Classic no GitHub.
Constantes
| Constante | Descrição |
|---|---|
|
Cria um botão que é o mesmo que uma caixa de marcar, exceto que a caixa pode ser esmaeçada, bem como marcada ou desmarcada. Use o estado esmaecido para mostrar que o estado da caixa de marcar não está determinado. |
|
Cria um botão que é o mesmo que uma caixa de marcar de três estados, exceto que a caixa altera seu estado quando o usuário o seleciona. O estado percorre verificado, indeterminado e desmarcado. |
|
Cria um botão que é o mesmo que uma caixa de marcar, exceto que o estado marcar alterna automaticamente entre marcado e desmarcado sempre que o usuário marca a caixa de marcar. |
|
Cria um botão que é o mesmo que um botão de opção, exceto que quando o usuário o seleciona, o sistema define automaticamente o estado marcar do botão como verificado e define automaticamente o estado marcar para todos os outros botões no mesmo grupo a serem limpos. |
|
Especifica que o botão exiba um bitmap. Consulte a seção Comentários para obter sua interação com BS_ICON. |
|
Coloca o texto na parte inferior do retângulo do botão. |
|
Centraliza o texto horizontalmente no retângulo do botão. |
|
Cria uma caixa de marcar pequena e vazia com texto. Por padrão, o texto é exibido à direita da caixa marcar. Para exibir o texto à esquerda da caixa de marcar, combine esse sinalizador com o estilo BS_LEFTTEXT (ou com o estilo de BS_RIGHTBUTTON equivalente). |
|
Cria um botão de link de comando que se comporta como um botão de estilo BS_PUSHBUTTON, mas o botão de link de comando tem uma seta verde à esquerda apontando para o texto do botão. Uma legenda para o texto do botão pode ser definida enviando a mensagem BCM_SETNOTE para o botão. |
|
Cria um botão de link de comando que se comporta como um botão de estilo BS_PUSHBUTTON. Se o botão estiver em uma caixa de diálogo, o usuário poderá selecionar o botão de link de comando pressionando a tecla ENTER, mesmo quando o botão de link de comando não tiver o foco de entrada. Esse estilo é útil para permitir que o usuário selecione rapidamente a opção mais provável (padrão). |
|
Cria um botão de ação que se comporta como um botão de estilo BS_PUSHBUTTON, mas tem uma aparência distinta. Se o botão estiver em uma caixa de diálogo, o usuário poderá selecionar o botão pressionando a tecla ENTER, mesmo quando o botão não tiver o foco de entrada. Esse estilo é útil para permitir que o usuário selecione rapidamente a opção mais provável (padrão). |
|
Cria um botão de divisão que se comporta como um botão de estilo BS_PUSHBUTTON, mas também tem uma aparência distinta. Se o botão dividir estiver em uma caixa de diálogo, o usuário poderá selecionar o botão de divisão pressionando a tecla ENTER, mesmo quando o botão de divisão não tiver o foco de entrada. Esse estilo é útil para permitir que o usuário selecione rapidamente a opção mais provável (padrão). |
|
Cria um retângulo no qual outros controles podem ser agrupados. Qualquer texto associado a esse estilo é exibido no canto superior esquerdo do retângulo. |
|
Especifica que o botão exiba um ícone. Consulte a seção Comentários para obter sua interação com BS_BITMAP. |
|
Especifica que o botão é bidimensional; ele não usa o sombreamento padrão para criar uma imagem 3D. |
|
Justifica à esquerda o texto no retângulo do botão. No entanto, se o botão for uma caixa de marcar ou um botão de opção que não tenha o estilo BS_RIGHTBUTTON, o texto será deixado justificado no lado direito da caixa de marcar ou do botão de opção. |
|
Coloca o texto no lado esquerdo do botão de opção ou da caixa de marcar quando combinado com um botão de opção ou marcar estilo de caixa. O mesmo que o estilo de BS_RIGHTBUTTON. |
|
Encapsula o texto do botão em várias linhas se a cadeia de texto for muito longa para caber em uma única linha no retângulo do botão. |
|
Permite que um botão envie códigos de notificação BN_KILLFOCUS e BN_SETFOCUS para sua janela pai. Observe que os botões enviam o código de notificação BN_CLICKED independentemente de ele ter esse estilo. Para obter BN_DBLCLK códigos de notificação, o botão deve ter o estilo BS_RADIOBUTTON ou BS_OWNERDRAW. |
|
Cria um botão desenhado pelo proprietário. A janela proprietário recebe uma mensagem WM_DRAWITEM quando um aspecto visual do botão é alterado. Não combine o estilo BS_OWNERDRAW com outros estilos de botão. |
|
Cria um botão de push que posta uma mensagem WM_COMMAND na janela do proprietário quando o usuário seleciona o botão. |
|
Faz com que um botão (como uma caixa de marcar, caixa de marcar de três estados ou botão de opção) pareça e aja como um botão de ação. O botão fica acionado quando não é pressionado ou marcado e afundado quando é pressionado ou verificado. |
|
Cria um pequeno círculo com texto. Por padrão, o texto é exibido à direita do círculo. Para exibir o texto à esquerda do círculo, combine esse sinalizador com o estilo BS_LEFTTEXT (ou com o estilo de BS_RIGHTBUTTON equivalente). Use botões de opção para grupos de opções relacionadas, mas mutuamente exclusivas. |
|
Justifica o texto à direita no retângulo do botão. No entanto, se o botão for uma caixa de marcar ou um botão de opção que não tenha o estilo BS_RIGHTBUTTON, o texto será justificado à direita no lado direito da caixa de marcar ou do botão de opção. |
|
Posiciona o círculo de um botão de opção ou o quadrado de uma caixa de marcar no lado direito do retângulo do botão. O mesmo que o estilo de BS_LEFTTEXT. |
|
Cria um botão de divisão. Um botão de divisão tem uma seta suspensa. |
|
Especifica que o botão exiba texto. |
|
Coloca o texto na parte superior do retângulo do botão. |
|
Não use esse estilo. Um bit de estilo composto que resulta do uso do operador OR em bits de estilo BS_*. Ele pode ser usado para mascarar bits válidos BS_* de uma determinada máscara de bits. Observe que isso está desatualizado e não inclui corretamente todos os estilos válidos. Portanto, você não deve usar esse estilo. |
|
Obsoleto, mas fornecido para compatibilidade com versões de 16 bits do Windows. Em vez disso, os aplicativos devem usar BS_OWNERDRAW. |
|
Coloca o texto no meio (verticalmente) do retângulo do botão. |
Comentários
Para ilustrações dos estilos de botão principal, como BS_CHECKBOX e BS_GROUPBOX, consulte Tipos de botão.
A aparência do texto ou de um ícone ou ambos em um controle de botão depende dos estilos BS_ICON e BS_BITMAP e se a mensagem BM_SETIMAGE é enviada. Os resultados possíveis são os seguintes.
| BS_ICON ou conjunto de BS_BITMAP? | BM_SETIMAGE ligou? | Result |
|---|---|---|
| Sim | Sim | Mostrar somente ícone. |
| No | Sim | Mostrar ícone e texto. |
| Sim | No | Mostrar somente texto. |
| No | No | Mostrar somente texto |
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|