Classe CMFCButton

Artigo
06/10/2015

A classe de CMFCButton adicionar funcionalidade à classe de CButton como alinhar o texto do botão, a combinação de texto do botão e de uma imagem, selecione um cursor, e especificar uma dica de ferramenta.

class CMFCButton : public CButton

Membros

Construtores public

Nome	Descrição
CMFCButton::CMFCButton	Construtor padrão.
CMFCButton::~CMFCButton	Destruidor.

Métodos públicos

Nome	Descrição
CMFCButton::CleanUp	Reinicializa variáveis internas e libera recursos designados como imagens, ícones bitmaps, e.
CMFCButton::CreateObject	Usado pela estrutura dinâmica para criar uma instância de esse tipo da classe.
CMFCButton::DrawItem	Chamado pela estrutura quando uma aparência visual de um botão proprietário desenhado alterar. Overrides ( CButton::DrawItem.)
CMFCButton::EnableFullTextTooltip	Especifica se exibir texto completo de um tooltip em uma grande janela de tooltip ou truncado uma versão do texto em uma pequena janela de tooltip.
CMFCButton::EnableMenuFont	Especifica se a fonte do texto do botão é a mesma que a fonte do menu do aplicativo.
CMFCButton::EnableWindowsTheming	Especifica se o estilo de borda do botão corresponde ao tema atual do windows.
CMFCButton::GetThisClass	Usado pela estrutura para obter um ponteiro para o objeto de CRuntimeClass que está associado com esse tipo da classe.
CMFCButton::GetToolTipCtrl	Retorna uma referência ao controle subjacente de tooltip.
CMFCButton::IsAutoCheck	Indica se uma caixa de seleção ou um botão de opção são um botão automático.
CMFCButton::IsAutorepeatCommandMode	Indica se um botão é definido para automático de repetição.
CMFCButton::IsCheckBox	Indica se um botão é um botão da caixa de seleção.
CMFCButton::IsChecked	Indica se o botão atual é verificado.
CMFCButton::IsHighlighted	Indica se um botão é realçado.
CMFCButton::IsPressed	Indica se um botão é empurrado e realçado.
CMFCButton::IsPushed	Indica se um botão é empurrado.
CMFCButton::IsRadioButton	Indica se um botão é um botão de opção.
CMFCButton::IsWindowsThemingEnabled	Indica se o estilo de borda do botão corresponde ao tema atual do windows.
CMFCButton::OnDrawParentBackground	Desenha o plano de fundo do pai de um botão na área especificada. Overrides ( AFX_GLOBAL_DATA::DrawParentBackground.)
CMFCButton::PreTranslateMessage	Converte mensagens de janela antes que são distribuídos funções do windows de TranslateMessage e de DispatchMessage . Overrides ( CWnd::PreTranslateMessage.)
CMFCButton::SetAutorepeatMode	Define um modo automático de repetição do botão.
CMFCButton::SetCheckedImage	Define a imagem para um botão selecionado.
CMFCButton::SetFaceColor	Define a cor do plano de fundo para o texto do botão.
CMFCButton::SetImage	Define a imagem de um botão.
CMFCButton::SetMouseCursor	Define a imagem do cursor.
CMFCButton::SetMouseCursorHand	Define o cursor para a imagem de uma mão.
CMFCButton::SetStdImage	Usa um objeto de CMenuImages para definir a imagem do botão.
CMFCButton::SetTextColor	Define a cor do texto do botão para um botão que não está selecionado.
CMFCButton::SetTextHotColor	Define a cor do texto do botão para um botão que está selecionado.
CMFCButton::SetTooltip	Associa um tooltip com um botão.
CMFCButton::SizeToContent	Redimensiona um botão para conter os imagem e texto do botão.

Métodos protegidos

Nome	Descrição
CMFCButton::OnDraw	Chamado pela estrutura para desenhar um botão.
CMFCButton::OnDrawBorder	Chamado pela estrutura para desenhar a borda de um botão.
CMFCButton::OnDrawFocusRect	Chamado pela estrutura para desenhar o retângulo de foco de um botão.
CMFCButton::OnDrawText	Chamado pela estrutura para desenhar o texto do botão.
CMFCButton::OnFillBackground	Chamado pela estrutura para desenhar o plano de fundo do botão texto.
CMFCButton::SelectFont	Recupera a fonte que está associada com o contexto específico de dispositivo.

Membros de dados

Nome	Descrição
CMFCButton::m_bDrawFocus	Indica se desenhar um retângulo de foco em torno de um botão.
CMFCButton::m_bHighlightChecked	Indica se realçar um BS_CHECKBOX-style botão quando o cursor passa sobre ele.
CMFCButton::m_bRightImage	Indica se exibir uma imagem no lado direito do botão.
CMFCButton::m_bTransparent	Indica se o botão é transparente.
CMFCButton::m_nAlignStyle	Especifica o alinhamento de texto do botão.
CMFCButton::m_nFlatStyle	Especifica o estilo do botão, como sem fronteira, suave, o semi- plano, ou o 3D.

Comentários

Outros tipos de botões são derivados da classe de CMFCButton , como a classe de CMFCURLLinkButton , que suporta hiperlinks, e a classe de CMFCColorButton , que suporta uma caixa de diálogo seletor de cor.

O estilo de um objeto de CMFCButton pode ser 3D, plano, semi- fundo ou nenhuma borda. O texto do botão pode ser alinhado na esquerda, cobre, ou centro de um botão. Em tempo de execução, você pode controlar se o botão exibe o texto, uma imagem, ou texto e uma imagem. Você também pode especificar que uma imagem específica do cursor seja exibida quando o cursor focaliza um botão.

Crie um controle de botão diretamente em seu código, ou usando a ferramenta de Assistente de Classe MFC e um modelo da caixa de diálogo. Se você criar um controle de botão diretamente, adicione uma variável de CMFCButton ao seu aplicativo, e então chame o construtor e métodos de Create de CMFCButton objeto. Se você usar Assistente de Classe MFC, adicione uma variável de CButton para seu aplicativo em seguida, altere o tipo da variável de CButton a CMFCButton.

Para manipular notificações em um aplicativo da caixa de diálogo, adicione uma entrada de mapa de mensagem e um manipulador de eventos para cada notificação. As notificações enviadas por um objeto de CMFCButton são as mesmas que aquelas fornecidas por um objeto de CButton .

Exemplo

O exemplo a seguir demonstra como configurar as propriedades do botão usando vários métodos na classe de CMFCButton . o exemplo é parte de novo exemplo de controles.

    CMFCButton m_Button;


...


    // int m_iImage 
    // IDB_BTN1_32, IDB_BTN1_HOT_32, IDB_BTN1, IDB_BTN1_HOT are int macros that are #define. 
    if (m_iImage == 1) 
    {
        m_Button.SetImage((HBITMAP) NULL);
    }
    else
    {
        m_Button.SetImage(IDB_BTN1_32, IDB_BTN1_HOT_32);
    }


...


    // int m_iImage 
    if (m_iImage == 0)
    {
        m_Button.SetWindowText(_T(""));
    }
    else
    {
        m_Button.SetWindowText(_T("Button"));
    }


...


    // Resize the button.
    m_Button.SizeToContent();
    m_Button.EnableFullTextTooltip(true);
    // Use the application menu font at the button text font.
    m_Button.EnableMenuFont();
    // Use the current Windows theme to draw the button borders.
    m_Button.EnableWindowsTheming(true);
    // Set the button to auto-repeat mode.
    m_Button.SetAutorepeatMode();
    // Set the background color for the button text.
    m_Button.SetFaceColor(RGB(255,0,0),true);
    m_Button.SetTextColor(RGB(0,0,255));
    // Set the tooltip of the button.
    m_Button.SetTooltip(_T("this is a button!"));