Clase de CMFCButton

Artículo
02/19/2013

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