Classe CMFCButton

Artigo
08/25/2010

The CMFCButton classe adiciona funcionalidade a CButton classe, sistema autônomo alinhamento de texto do botão, a combinação de texto do botão e uma imagem, selecionando um cursor e especificando uma dica de ferramenta.

class CMFCButton : public CButton

Membros

Construtores públicos

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

Métodos públicos

Nome	Descrição
CMFCButton::CleanUp	Redefine variáveis internas e libera recursos alocados, sistema autônomo imagens, bitmaps e ícones.
CMFCButton::CreateObject	Usados pela estrutura para criar uma instância desse tipo de classe dinâmica.
CMFCButton::DrawItem	Chamado pela estrutura quando um aspecto visual de um botão de desenho proprietário é alterado.(Substitui CButton::DrawItem.)
CMFCButton::EnableFullTextTooltip	Especifica se exibe o texto completo de uma dica de ferramenta em uma janela de dica de ferramenta grandes ou uma versão truncada do texto em uma janela pequena dica de ferramenta.
CMFCButton::EnableMenuFont	Especifica se a fonte de texto do botão é o mesmo que a fonte do menu de aplicativo.
CMFCButton::EnableWindowsTheming	Especifica se o estilo da borda do botão corresponde ao tema corrente do Windows.
CMFCButton::GetThisClass	Usado pela estrutura para obter um ponteiro para o CRuntimeClass objeto que está associado a este tipo de classe.
CMFCButton::GetToolTipCtrl	Retorna uma referência ao controle de dica de ferramenta base.
CMFCButton::IsAutoCheck	Indica se uma caixa de seleção ou botão de opção é um botão automático.
CMFCButton::IsAutorepeatCommandMode	Indica se um botão é definido para o modo de Repetir automática.
CMFCButton::IsCheckBox	Indica se um botão é um botão de caixa de seleção.
CMFCButton::IsChecked	Indica se o botão corrente está selecionado.
CMFCButton::IsHighlighted	Indica se um botão é realçado.
CMFCButton::IsPressed	Indica se um botão é pressionado e realçado.
CMFCButton::IsPushed	Indica se um botão é enviado.
CMFCButton::IsRadioButton	Indica se um botão é um botão de opção.
CMFCButton::IsWindowsThemingEnabled	Indica se o estilo da borda do botão corresponde ao tema corrente do Windows.
CMFCButton::OnDrawParentBackground	Desenha o plano de fundo do pai do botão na área especificada.(Substitui AFX_GLOBAL_DATA::DrawParentBackground.)
CMFCButton::PreTranslateMessage	Converte mensagens de janela antes que eles são expedidos para o TranslateMessage and DispatchMessage Funções do Windows.(Substitui CWnd::PreTranslateMessage.)
CMFCButton::SetAutorepeatMode	Define um botão Modo de Repetir automática.
CMFCButton::SetCheckedImage	Configura a imagem de um botão marcado.
CMFCButton::SetFaceColor	Define a cor do plano de fundo para o texto do botão.
CMFCButton::SetImage	Configura a imagem de um botão.
CMFCButton::SetMouseCursor	Configura a imagem do cursor.
CMFCButton::SetMouseCursorHand	Define o cursor para a imagem de uma mão.
CMFCButton::SetStdImage	Usa um CMenuImages objeto para conjunto a imagem do botão.
CMFCButton::SetTextColor	Define a cor do texto de botão de um botão que não esteja selecionado.
CMFCButton::SetTextHotColor	Define a cor do texto de botão de um botão que está selecionado.
CMFCButton::SetTooltip	Associa uma dica de ferramenta com um botão.
CMFCButton::SizeToContent	Redimensiona um botão para conter o texto do botão e imagem.

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 para 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 texto do botão.
CMFCButton::SelectFont	Recupera a fonte que está associada com o contexto de dispositivo especificado.

Membros de dados

Nome	Descrição
CMFCButton::m_bDrawFocus	Indica se é necessário desenhar um retângulo de foco em torno de um botão.
CMFCButton::m_bHighlightChecked	Indica se um botão Estilo BS_CHECKBOX o realce quando o cursor focaliza.
CMFCButton::m_bRightImage	Indica se deve exibir uma imagem à direita do botão.
CMFCButton::m_bTransparent	Indica se o botão é transparente.
CMFCButton::m_nAlignStyle	Especifica o alinhamento do texto do botão.
CMFCButton::m_nFlatStyle	Especifica o estilo do botão, sistema autônomo semi-flat sem borda, plano, ou 3D.

Comentários

Outros tipos de botões são obtidos com o CMFCButton classe, sistema autônomo o CMFCURLLinkButton classe, que oferece suporte a hiperlinks e o CMFCColorButton classe, que oferece suporte a uma caixa de diálogo Seletor de cores.

O estilo de um CMFCButton o objeto pode ser 3D, simples, semi-Flat or nenhuma borda.Texto do botão pode ser alinhado na esquerda, superior ou no centralizar de um botão.Em time de execução, você pode controlar se o botão exibe o texto, uma imagem ou texto e imagem.Você também pode especificar que uma imagem do cursor específico ser exibido quando o cursor passar sobre um botão.

Criar um controle de botão diretamente no seu código ou usando o MFC classe assistente ferramenta e um modelo de caixa de diálogo.Se você criar diretamente um controle de botão, adicione um CMFCButton variável seu aplicativo e, em seguida, telefonar de construtor e Create métodos para o CMFCButton objeto. Se você usar o Assistente de classes do MFC, add a CButton variável para seu aplicativo e, em seguida, altere o tipo da variável de CButton para CMFCButton.

Para lidar com mensagens de notificação em um aplicativo de caixa de diálogo, adicione uma entrada de MAP da mensagem e um manipulador de eventos para cada notificação.sistema autônomo notificações enviadas por um CMFCButton objeto são sistema autônomo mesmas que aquelas enviadas por um CButton objeto.

Exemplo

O exemplo a seguir demonstra como configurar as propriedades do botão usando vários métodos no CMFCButton classe. O exemplo faz parte o Exemplo do NewControls: Aplicativo de demonstração de controles MFC.

    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
    {
        if (afxGlobalData.bIsOSAlphaBlendingSupport)
        {
            m_Button.SetImage(IDB_BTN1_32, IDB_BTN1_HOT_32);
        }
        else
        {
            m_Button.SetImage(IDB_BTN1, IDB_BTN1_HOT);
        }
    }


...


    // 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!"));