CMFCButton Class

Artículo
06/10/2015

La clase de CMFCButton agrega funcionalidad a la clase de CButton como texto del botón que alinea, combinando el texto del botón y una imagen, seleccionando el cursor, y especificar una información sobre herramientas.

class CMFCButton : public CButton

Members

Constructores públicos

Name	Descripción
CMFCButton::CMFCButton	Constructor predeterminado.
CMFCButton::~CMFCButton	Un destructor.

Métodos públicos

Name	Descripción
CMFCButton::CleanUp	Restablece variables internas y libera los recursos asignados como imágenes, mapas de bits, e iconos.
CMFCButton::CreateObject	Utiliza el marco para crear una instancia dinámica de este tipo de clase.
CMFCButton::DrawItem	Llamado por el marco cuando un aspecto visual de un botón propietario- dibujado ha cambiado. (Reemplaza CButton::DrawItem.)
CMFCButton::EnableFullTextTooltip	Especifica si mostrar el texto completo de una información sobre herramientas en una ventana grande de información sobre herramientas o una versión truncada de texto en una pequeña ventana de información sobre herramientas.
CMFCButton::EnableMenuFont	Especifica si la fuente del texto del botón es igual que la fuente del menú de la aplicación.
CMFCButton::EnableWindowsTheming	Especifica si el estilo del borde del botón corresponde a Windows el tema actual.
CMFCButton::GetThisClass	Utiliza el marco para obtener un puntero al objeto de Recursos que está asociado a este tipo de clase.
CMFCButton::GetToolTipCtrl	Devuelve una referencia al control subyacente de información sobre herramientas.
CMFCButton::IsAutoCheck	Indica si una casilla o un botón de radio es un botón automático.
CMFCButton::IsAutorepeatCommandMode	Indica si un botón está establecido en el modo de repetición automática.
CMFCButton::IsCheckBox	Indica si un botón es un botón de la casilla.
CMFCButton::IsChecked	Indica si el botón actual está activado.
CMFCButton::IsHighlighted	Indica si un botón es resaltado.
CMFCButton::IsPressed	Indica si un botón se inserta y resaltado.
CMFCButton::IsPushed	Indica si un botón se inserta.
CMFCButton::IsRadioButton	indica si un botón es un botón de opción.
CMFCButton::IsWindowsThemingEnabled	Indica si el estilo del borde del botón corresponde a Windows el tema actual.
CMFCButton::OnDrawParentBackground	Dibuja el fondo del elemento primario de un botón en el área especificada. (Reemplaza AFX_GLOBAL_DATA::DrawParentBackground.)
CMFCButton::PreTranslateMessage	Traduce mensajes de ventana antes de que se envíen a las funciones de TranslateMessage y de DispatchMessage Windows. (Reemplaza CWnd::PreTranslateMessage.)
CMFCButton::SetAutorepeatMode	Establece un botón al modo de repetición automática.
CMFCButton::SetCheckedImage	Establece la imagen de un botón comprobado.
CMFCButton::SetFaceColor	Establece el color de fondo del texto del botón.
CMFCButton::SetImage	Establece la imagen de un botón.
CMFCButton::SetMouseCursor	Establece la imagen del cursor.
CMFCButton::SetMouseCursorHand	Establece el cursor a la imagen de una mano.
CMFCButton::SetStdImage	Usa un objeto de CMenuImages para establecer la imagen del botón.
CMFCButton::SetTextColor	Establece el color del texto del botón para un botón que no se ha seleccionado.
CMFCButton::SetTextHotColor	Establece el color del texto del botón para un botón seleccionado que.
CMFCButton::SetTooltip	asocia una información sobre herramientas a un botón.
CMFCButton::SizeToContent	Cambia el tamaño de un botón para contener el texto del botón e imagen.

Métodos protegidos

Name	Descripción
CMFCButton::OnDraw	Llamado por el marco para dibujar un botón.
CMFCButton::OnDrawBorder	Llamado por el marco para dibujar el borde de un botón.
CMFCButton::OnDrawFocusRect	Llamado por el marco para dibujar el rectángulo de foco para un botón.
CMFCButton::OnDrawText	Llamado por el marco para dibujar el texto del botón.
CMFCButton::OnFillBackground	Llamado por el marco para dibujar el fondo del texto del botón.
CMFCButton::SelectFont	Recuperar la fuente que está asociado con el contexto especificado del dispositivo.

miembros de datos

Name	Descripción
CMFCButton::m_bDrawFocus	Indica si dibujar un rectángulo de foco alrededor de un botón.
CMFCButton::m_bHighlightChecked	Indica si resaltar un botón de BS_CHECKBOX-style cuando el puntero del mouse del cursor sobre ella.
CMFCButton::m_bRightImage	Indica si mostrar una imagen a la derecha del botón.
CMFCButton::m_bTransparent	indica si el botón es transparente.
CMFCButton::m_nAlignStyle	Especifica la alineación del texto del botón.
CMFCButton::m_nFlatStyle	Especifica el estilo de botón, como sin extremos, plano, semi-plano, o 3D.

Comentarios

Derivan a otros tipos de botones de la clase de CMFCButton , como la clase de CMFCURLLinkButton , que admite los hipervínculos, y la clase de CMFCColorButton , que admite un cuadro de diálogo Selector de colores.

El estilo de un objeto de CMFCButton puede ser 3D, plano, semi- plano o ningún borde. El texto del botón se puede clasificar en el izquierdo, superior, o centro de un botón. En tiempo de ejecución, puede controlar si el botón texto, una imagen, o texto y una imagen. También puede especificar una imagen particular del cursor se mostrará cuando el puntero del mouse del cursor sobre un botón.

Crear un control de botón directamente en el código, o mediante la herramienta de Asistente para clases MFC y una plantilla de cuadro de diálogo. Si crea un control de botón directamente, agregue una variable de CMFCButton a la aplicación, y llame al constructor y los métodos de Create de CMFCButton se oponen. Si utiliza Asistente para clases MFC, agregue una variable de CButton a la aplicación, y después cambie el tipo de la variable de CButton a CMFCButton.

Para controlar los mensajes de notificación en una aplicación de cuadro de diálogo, agregue una entrada del mapa de mensajes y un controlador de eventos para cada notificación. Las notificaciones enviadas por un objeto de CMFCButton son iguales que las enviadas por un objeto de CButton .

Ejemplo

El ejemplo siguiente muestra cómo configurar las propiedades del botón mediante varios métodos en la clase de CMFCButton . El ejemplo forma parte de nuevo ejemplo 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!"));