Classe CButton

Artigo
06/10/2015

Fornece a funcionalidade dos controles de botão do windows.

class CButton : public CWnd

Membros

Construtores public

Nome	Descrição
CButton::CButton	Constrói um objeto de CButton .

Métodos públicos

Nome	Descrição
CButton::Create	Cria as janelas um controle e os anexa ele para o objeto de CButton .
CButton::DrawItem	Substituição para desenhar um objeto proprietário desenhado de CButton .
CButton::GetBitmap	Recupera a alça de bitmap anteriormente definido com SetBitmap.
CButton::GetButtonStyle	Recupera informações sobre o estilo de controle button.
CButton::GetCheck	Recupera o estado de verificação de um controle de botão.
CButton::GetCursor	Recupera o identificador de imagem do cursor definida anteriormente com SetCursor.
CButton::GetIcon	Recupera a alça de ícone anteriormente definido com SetIcon.
CButton::GetIdealSize	Retorna o tamanho ideal de controle button.
CButton::GetImageList	Recupera a lista de imagem de controle button.
CButton::GetNote	Recupera o componente de nota de controle de link de comando atual.
CButton::GetNoteLength	Retorna o tamanho do texto do nó para o controle de link de comando atual.
CButton::GetSplitGlyph	Recupera o glifo associado ao controle de botão split atual.
CButton::GetSplitImageList	Recupera a lista de imagem para o controle de botão split atual.
CButton::GetSplitInfo	Recupera informações que define o controle de botão split atual.
CButton::GetSplitSize	Recupera o retângulo delimitador do componente lista suspensa do controle de botão split atual.
CButton::GetSplitStyle	Recupera os estilos de botão split que definem o controle de botão split atual.
CButton::GetState	Recupera o estado de verificação, o estado de realce, e o estado de foco de um controle de botão.
CButton::GetTextMargin	Recupera a margem do texto do controle de botão.
CButton::SetBitmap	Especifica um bitmap a ser exibido no botão.
CButton::SetButtonStyle	Altera o estilo de um botão.
CButton::SetCheck	Define o estado de verificação de um controle de botão.
CButton::SetCursor	Especifica uma imagem do cursor a ser exibida no botão.
CButton::SetDropDownState	Define o estado da lista suspensa do controle de botão split atual.
CButton::SetIcon	Especifica um ícone a ser exibido no botão.
CButton::SetImageList	Define a lista de imagem de controle button.
CButton::SetNote	Define a observação no controle de link de comando atual.
CButton::SetSplitGlyph	Associa um glifo especificado com o controle de botão split atual.
CButton::SetSplitImageList	Associa uma lista de imagem com o controle de botão split atual.
CButton::SetSplitInfo	Especifica a informação que define o controle de botão split atual.
CButton::SetSplitSize	Define o retângulo delimitador do componente lista suspensa do controle de botão split atual.
CButton::SetSplitStyle	Defina o estilo de controle de botão split atual.
CButton::SetState	Define o estado para realçar de um controle de botão.
CButton::SetTextMargin	Define a margem do texto do controle de botão.

Comentários

Um controle de botão é uma janela filho, pequena retangular que pode ser clicado sobre e desativado. Os botões podem ser usados apenas ou em grupos e podem ser rotuladas ou aparecido sem texto. Normalmente um botão altera a aparência quando o usuário clica em ele.

Os botões são típicos a caixa de seleção, o botão de opção, e a tecla. Um objeto de CButton pode se tornar qualquer pessoa, de acordo com estilo de botão especificado na inicialização pela função de membro de Criar .

Além de isso, a classe de CBitmapButton derivada de criação de suporte de CButton dos controles de botão rotulados com imagens bitmap em vez de texto. CBitmapButton pode ter bitmaps separados para um botão para cima, para baixo, focalizado, e estados desativados.

Você pode criar um controle de botão de um modelo na caixa de diálogo ou diretamente no seu código. Em ambos os casos, primeiro chamar o construtor CButton para construir o objeto de CButton ; chame a função de membro de Criar para criar o controle de botão do windows para e anexá-la ao objeto de CButton .

A compilação pode ser um processo de uma etapa em uma classe derivada de CButton. Escreva um construtor para a classe derivada e chamar Criar de dentro do construtor.

Se você desejar manipular as notificações do windows enviadas por um controle de botão ao seu pai (geralmente uma classe derivada de CDialog), adicionar uma função de membro de entrada e de mensagem- manipulador de mensagem- mapa para a classe pai para cada mensagem.

Cada entrada de mapa mensagem- tem a seguinte forma:

Notificação**(iddeON_, memberFxn)**

onde id especifica a identificação da janela filho do controle que envia a notificação e são memberFxn o nome da função de membro que você escreveu pai para trate a notificação.

O protótipo de função do pai é o seguinte:

afx_msgvoidmemberFxn**( );**

As possíveis entradas de mapa mensagem- são:

Entrada de mapa	Enviado ao pai quando…
ON_BN_CLICKED	O usuário clica em um botão.
ON_BN_DOUBLECLICKED	O usuário clica duas vezes em um botão.

Se você criar um objeto de CButton de um recurso da caixa de diálogo, o objeto de CButton é destruído automaticamente quando o usuário fecha a caixa de diálogo.

Se você criar um objeto de CButton em uma janela, você pode precisar destrui-la. Se você criar o objeto de CButton no heap usando a função de new , você deve chamar delete no objeto para destrui-lo quando o usuário fecha o botão o controle. Se você criar o objeto de CButton na pilha, ou é inserida no objeto pai da caixa de diálogo, é automaticamente destruída.