Estilos de botão

Este tópico descreve os estilos e tipos de botão.

Tipos de botão

A tabela a seguir lista os tipos de botão.Opcionalmente, você pode escolher um dos seguintes.Se você não especificar um tipo de botão, o padrão é BS_PUSHBUTTON.

Tipo

Descrição

BS_3STATE

Cria um botão de caixa de seleção com três estados: BST_CHECKED, BST_INDETERMINATE, e BST_UNCHECKED.Clicando no botão envia uma BN_CLICKED notificação para a janela do proprietário, mas não alterar o estado do botão.Por padrão, o texto associado é exibido à direita da caixa de seleção.Para exibir o texto à esquerda da caixa de seleção, use o BS_LEFTTEXT ou BS_RIGHTBUTTON estilo.

BS_AUTO3STATE

Cria um botão de caixa de seleção com três estados: BST_CHECKED, BST_INDETERMINATE, e BST_UNCHECKED.Clicando no botão envia uma BN_CLICKED notificação para a janela do proprietário e altera o estado do botão.Estados de botão ciclo na ordem de BST_CHECKED, BST_INDETERMINATE, e BST_UNCHECKED.Por padrão, o texto associado é exibido à direita da caixa de seleção.Para exibir o texto à esquerda da caixa de seleção, use o BS_LEFTTEXT ou BS_RIGHTBUTTON estilo.

BS_AUTOCHECKBOX

Cria um botão de caixa de seleção com dois estados: BST_CHECKED e BST_UNCHECKED.Clicando no botão envia uma BN_CLICKED notificação para a janela do proprietário e altera o estado do botão.Por padrão, o texto associado é exibido à direita da caixa de seleção.Para exibir o texto à esquerda da caixa de seleção, use o BS_LEFTTEXT ou BS_RIGHTBUTTON estilo.

BS_AUTORADIOBUTTON

Cria um botão de rádio com dois estados: BST_CHECKED e BST_UNCHECKED.Botões de opção são geralmente usados em grupos, cada grupo com um máximo de uma opção marcada por vez.Clicando no botão envia uma BN_CLICKED notificação para a janela do proprietário, define o estado do botão clicado para BST_CHECKEDe define os estados de todos os outros botões de opção no grupo de botões para BST_UNCHECKED.Por padrão, o texto associado é exibido à direita do botão.Para exibir o texto à esquerda do botão de opção, use o BS_LEFTTEXT ou BS_RIGHTBUTTON estilo.

BS_CHECKBOX

Cria um botão de caixa de seleção com dois estados: BST_CHECKED e BST_UNCHECKED.Clicando no botão envia uma BN_CLICKED notificação para a janela do proprietário, mas não alterar o estado do botão.Por padrão, o texto associado é exibido à direita da caixa de seleção.Para exibir o texto à esquerda da caixa de seleção, use o BS_LEFTTEXT ou BS_RIGHTBUTTON estilo.

BS_COMMANDLINK

Cria um botão de link de comando.Um botão de link de comando é um botão de comando específico para Windows Vista que exibe uma seta verde à esquerda do texto principal e uma nota abaixo do texto principal.Você pode definir o texto de anotação usando CButton::SetNote.

BS_DEFCOMMANDLINK

Cria um botão de link de comando.Um botão de link de comando é um botão de comando específico para Windows Vista que exibe uma seta verde à esquerda do texto principal e uma nota abaixo do texto principal.Você pode definir o texto de anotação usando CButton::SetNote.Se o botão estiver em uma caixa de diálogo, pressionando ENTER chave envia um BN_CLICKED notificação para a caixa de diálogo, mesmo quando o botão não tem o foco de entrada.

BS_DEFPUSHBUTTON

Cria um botão de comando tem uma borda preta densa.Se o botão estiver em uma caixa de diálogo, pressionando ENTER chave envia um BN_CLICKED notificação para a caixa de diálogo, mesmo quando o botão não tem o foco de entrada.

BS_DEFSPLITBUTTON

Cria um botão de divisão.Um botão de divisão é específico para um botão de comando Windows Vista que contém um botão adjacente a uma seta suspensa.Quando você clicar no botão, o comando padrão é executado.Quando você clica na seta suspensa, aparecerá um menu de comandos adicionais.Se o botão de divisão estiver em uma caixa de diálogo, pressionando ENTER chave envia um BN_CLICKED notificação para a caixa de diálogo, mesmo quando o botão não tem o foco de entrada

BS_GROUPBOX

Cria um retângulo no qual os outros botões podem ser agrupados.Associado com esse estilo de texto é exibido no canto de superior esquerdo do retângulo.

BS_OWNERDRAW

Cria um botão de desenho proprietário.O framework chama o DrawItem método quando um aspecto visual do botão foi alterado.Esse estilo deve ser definido ao usar o CBitmapButton classe.

BS_PUSHBUTTON

Cria um botão de comando envia um BN_CLICKED notificação para a janela do proprietário quando o usuário clica no botão.

BS_RADIOBUTTON

Cria um botão de rádio com dois estados: BST_CHECKED e BST_UNCHECKED.Botões de opção são geralmente usados em grupos, cada grupo com um máximo de uma opção marcada por vez.Clicando no botão envia uma BN_CLICKED notificação para a janela do proprietário, mas não altera automaticamente o estado de qualquer botão no grupo.Por padrão, o texto associado é exibido à direita do botão.Para exibir o texto à esquerda do botão de opção, use o BS_LEFTTEXT ou BS_RIGHTBUTTON estilo.

BS_SPLITBUTTON

Cria um botão de divisão.Um botão de divisão é específico para um botão de comando Windows Vista que contém um botão adjacente a uma seta suspensa.Quando você clicar no botão, o comando padrão é executado.Quando você clica na seta suspensa, aparecerá um menu de comandos adicionais.

BS_USERBUTTON

Obsoletos, mas fornecida para compatibilidade com versões de 16 bits do Windows.Aplicativos baseados em Win32 devem usar BS_OWNERDRAW em vez disso.

Botão de opção e caixa de seleção estilos

A tabela a seguir lista os estilos que são específicos para caixas de seleção e botões de opção.Esses estilos são ignorados em todos os outros tipos de botão.Opcionalmente, você pode escolher um ou mais dos procedimentos a seguir.

Style

Descrição

BS_LEFTTEXT

Quando combinado com um estilo de caixa de seleção ou botão de rádio, o texto aparece no lado esquerdo da caixa de seleção ou botão de opção.

BS_RIGHTBUTTON

Quando combinado com um estilo de caixa de seleção ou botão de rádio, o texto aparece no lado esquerdo da caixa de seleção ou botão de opção.Este estilo é idêntico do BS_LEFTTEXT estilo.

BS_PUSHLIKE

Faz uma caixa de seleção ou botão de opção aparência e se comportam como um botão de comando.O botão aparece pressionado quando o estado é BST_CHECKED, pressionado e esmaecido quando o estado é BST_INDETERMINATEe liberado quando o estado é BST_UNCHECKED.

Estilos de alinhamento de texto

A tabela a seguir lista as opções de alinhamento de texto horizontal e vertical.Opcionalmente, você pode escolher um dos seguintes.

Style

Descrição

BS_LEFT

Esquerda alinha o texto no retângulo de botão.No entanto, se o botão é uma caixa de seleção ou botão de rádio que não tem o BS_RIGHTBUTTON estilo, o texto fica alinhado à direita da caixa de seleção ou botão de opção.

BS_RIGHT

Direita alinha o texto no retângulo de botão.No entanto, se o botão é uma caixa de seleção ou botão de rádio que não tem o BS_RIGHTBUTTON de estilo, o texto é direita alinhado à direita da caixa de seleção ou botão de opção.

BS_CENTER

Centraliza o texto horizontalmente no retângulo de botão.

BS_TOP

Coloca o texto na parte superior do retângulo de botão.

BS_BOTTOM

Coloca o texto na parte inferior do retângulo de botão.

BS_VCENTER

Centraliza o texto verticalmente no retângulo de botão.

Botão Opções de conteúdo

A tabela a seguir lista as opções que indicam o que é exibido no botão.Tipos de botões que exibem texto apenas ignoram esses estilos.Opcionalmente, você pode escolher um dos seguintes.

Style

Descrição

BS_BITMAP

Especifica que o botão exibe um bitmap.

BS_ICON

Especifica que o botão exibe um ícone.

BS_TEXT

Especifica que o botão exibe o texto.

Outras opções

A tabela a seguir lista as opções adicionais que você pode usar com qualquer tipo de botão.Opcionalmente, você pode escolher um ou mais dos procedimentos a seguir.

Style

Descrição

BS_FLAT

Especifica que o botão é bidimensional e que não é desenhado com sombreado padrão para criar uma imagem tridimensional.

BS_MULTILINE

Quebra o texto do botão para várias linhas se a seqüência de texto é muito longa para caber em uma única linha no retângulo de botão.

BS_NOTIFY

Permite que um botão para enviar BN_DBLCLK, BN_KILLFOCUS, e BN_SETFOCUS mensagens de notificação para sua janela pai.Observe que os botões Enviar o BN_CLICKED notificação independentemente se esse estilo é especificado.

Consulte também

Referência

CButton::Create

Estilos de botão

BN_CLICKED Notification

Outros recursos

Estilos usados pelo MFC