CMFCButton (Clase)CMFCButton Class

La CMFCButton clase agrega funcionalidad a la clase CButton, como alinear el texto del botón, combinar texto de botón y una imagen, seleccionar un cursor y especificar una información sobre herramientas.The CMFCButton class adds functionality to the CButton class such as aligning button text, combining button text and an image, selecting a cursor, and specifying a tool tip.

SintaxisSyntax

class CMFCButton : public CButton

MiembrosMembers

Constructores públicosPublic Constructors

NombreName DescripciónDescription
CMFCButton::CMFCButton Constructor predeterminado.Default constructor.
CMFCButton::~CMFCButton Destructor.Destructor.

Métodos públicosPublic Methods

NombreName DescripciónDescription
CMFCButton::CleanUpCMFCButton::CleanUp Restablece las variables internas y libera los recursos asignados, como imágenes, mapas de bits e iconos.Resets internal variables and frees allocated resources such as images, bitmaps, and icons.
CMFCButton::CreateObject Usado por el marco de trabajo para crear una instancia dinámica de este tipo de clase.Used by the framework to create a dynamic instance of this class type.
CMFCButton::DrawItem Llamado por el marco de trabajo cuando un aspecto visual de un botón dibujado por el propietario ha cambiado.Called by the framework when a visual aspect of an owner-drawn button has changed. (Reemplaza CButton::DrawItem.)(Overrides CButton::DrawItem.)
CMFCButton::EnableFullTextTooltipCMFCButton::EnableFullTextTooltip Especifica si se debe mostrar el texto completo de una información sobre herramientas en una ventana de información sobre herramientas grande o una versión truncada del texto en una pequeña ventana de información sobre herramientas.Specifies whether to display the full text of a tooltip in a large tooltip window or a truncated version of the text in a small tooltip window.
CMFCButton::EnableMenuFontCMFCButton::EnableMenuFont Especifica si la fuente de texto del botón es la misma que la fuente del menú de la aplicación.Specifies whether the button text font is the same as the application menu font.
CMFCButton::EnableWindowsThemingCMFCButton::EnableWindowsTheming Especifica si el estilo del borde del botón corresponde al tema actual de Windows.Specifies whether the style of the button border corresponds to the current Windows theme.
CMFCButton::GetThisClass Utilizado por el marco de trabajo para obtener un puntero a la CRuntimeClass objeto que está asociado a este tipo de clase.Used by the framework to obtain a pointer to the CRuntimeClass object that is associated with this class type.
CMFCButton::GetToolTipCtrlCMFCButton::GetToolTipCtrl Devuelve una referencia al control de información sobre herramientas subyacente.Returns a reference to the underlying tooltip control.
CMFCButton::IsAutoCheckCMFCButton::IsAutoCheck Indica si una casilla de verificación o un botón de opción es un botón automático.Indicates whether a check box or radio button is an automatic button.
CMFCButton::IsAutorepeatCommandModeCMFCButton::IsAutorepeatCommandMode Indica si un botón está configurado en modo de repetición automática.Indicates whether a button is set to auto-repeat mode.
CMFCButton::IsCheckBoxCMFCButton::IsCheckBox Indica si un botón es un botón de casilla de verificación.Indicates whether a button is a check box button.
CMFCButton::IsCheckedCMFCButton::IsChecked Indica si el botón actual está activado.Indicates whether the current button is checked.
CMFCButton::IsHighlightedCMFCButton::IsHighlighted Indica si un botón está resaltado.Indicates whether a button is highlighted.
CMFCButton::IsPressedCMFCButton::IsPressed Indica si un botón está presionado y resaltado.Indicates whether a button is pushed and highlighted.
CMFCButton::IsPushedCMFCButton::IsPushed Indica si se presiona un botón.Indicates whether a button is pushed.
CMFCButton::IsRadioButtonCMFCButton::IsRadioButton Indica si un botón es un botón de opción.Indicates whether a button is a radio button.
CMFCButton::IsWindowsThemingEnabledCMFCButton::IsWindowsThemingEnabled Indica si el estilo del borde del botón corresponde al tema actual de Windows.Indicates whether the style of the button border corresponds to the current Windows theme.
CMFCButton::OnDrawParentBackground Dibuja el fondo del elemento primario de un botón en el área especificada.Draws the background of a button's parent in the specified area. (Reemplaza AFX_GLOBAL_DATA::DrawParentBackground(Overrides AFX_GLOBAL_DATA::DrawParentBackground
CMFCButton::PreTranslateMessage Traduce los mensajes de ventana antes de que se distribuyan a las funciones de Windows TranslateMessage y DispatchMessage.Translates window messages before they are dispatched to the TranslateMessage and DispatchMessage Windows functions. (Invalida CWnd::PreTranslateMessage).(Overrides CWnd::PreTranslateMessage.)
CMFCButton::SetAutorepeatModeCMFCButton::SetAutorepeatMode Establece un botón en modo de repetición automática.Sets a button to auto-repeat mode.
CMFCButton::SetCheckedImageCMFCButton::SetCheckedImage Establece la imagen de un botón activado.Sets the image for a checked button.
CMFCButton::SetFaceColorCMFCButton::SetFaceColor Establece el color de fondo del texto del botón.Sets the background color for the button text.
CMFCButton::SetImageCMFCButton::SetImage Establece la imagen de un botón.Sets the image for a button.
CMFCButton::SetMouseCursorCMFCButton::SetMouseCursor Establece la imagen del cursor.Sets the cursor image.
CMFCButton::SetMouseCursorHandCMFCButton::SetMouseCursorHand Establece el cursor en la imagen de una mano.Sets the cursor to the image of a hand.
CMFCButton::SetStdImageCMFCButton::SetStdImage Utiliza CMenuImages un objeto para establecer la imagen del botón.Uses a CMenuImages object to set the button image.
CMFCButton::SetTextColorCMFCButton::SetTextColor Establece el color del texto del botón para un botón que no está seleccionado.Sets the color of the button text for a button that is not selected.
CMFCButton::SetTextHotColorCMFCButton::SetTextHotColor Establece el color del texto del botón para un botón seleccionado.Sets the color of the button text for a button that is selected.
CMFCButton::SetTooltipCMFCButton::SetTooltip Asocia una información sobre herramientas con un botón.Associates a tooltip with a button.
CMFCButton::SizeToContentCMFCButton::SizeToContent Cambia el tamaño de un botón para que contenga el texto y la imagen del botón.Resizes a button to contain its button text and image.

Métodos protegidosProtected Methods

NombreName DescripciónDescription
CMFCButton::OnDrawCMFCButton::OnDraw Llamado por el marco de trabajo para dibujar un botón.Called by the framework to draw a button.
CMFCButton::OnDrawBorderCMFCButton::OnDrawBorder Llamado por el marco de trabajo para dibujar el borde de un botón.Called by the framework to draw the border of a button.
CMFCButton::OnDrawFocusRectCMFCButton::OnDrawFocusRect Llamado por el marco de trabajo para dibujar el rectángulo de foco para un botón.Called by the framework to draw the focus rectangle for a button.
CMFCButton::OnDrawTextCMFCButton::OnDrawText Llamado por el marco de trabajo para dibujar el texto del botón.Called by the framework to draw the button text.
CMFCButton::OnFillBackgroundCMFCButton::OnFillBackground Llamado por el marco de trabajo para dibujar el fondo del texto del botón.Called by the framework to draw the background of the button text.
CMFCButton::SelectFontCMFCButton::SelectFont Recupera la fuente asociada al contexto de dispositivo especificado.Retrieves the font that is associated with the specified device context.

Miembros de datosData Members

NombreName DescripciónDescription
CMFCButton::m_nAlignStyleCMFCButton::m_nAlignStyle Especifica la alineación del texto del botón.Specifies the alignment of the button text.
CMFCButton::m_bDontUseWinXPThemeCMFCButton::m_bDontUseWinXPTheme Especifica si se deben utilizar temas de Windows XP.Specifies whether to use Windows XP themes.
CMFCButton::m_bDrawFocusCMFCButton::m_bDrawFocus Indica si se debe dibujar un rectángulo de foco alrededor de un botón.Indicates whether to draw a focus rectangle around a button.
CMFCButton::m_nFlatStyleCMFCButton::m_nFlatStyle Especifica el estilo del botón, como sin bordes, plano, semiplano o 3D.Specifies the style of the button, such as borderless, flat, semi-flat, or 3D.
CMFCButton::m_bGrayDisabledCMFCButton::m_bGrayDisabled Cuando TRUE, habilita un botón deshabilitado para dibujar se dibuja como atenuado.When TRUE, enables a disabled button to be drawn as grayed-out.
CMFCButton::m_bHighlightCheckedCMFCButton::m_bHighlightChecked Indica si se debe resaltar un botón de estilo BS_CHECKBOX cuando el cursor se desplaza sobre él.Indicates whether to highlight a BS_CHECKBOX-style button when the cursor hovers over it.
CMFCButton::m_bResponseOnButtonDownCMFCButton::m_bResponseOnButtonDown Indica si se debe responder a eventos de botón hacia abajo.Indicates whether to respond to button down events.
CMFCButton::m_bRightImageCMFCButton::m_bRightImage Indica si se debe mostrar una imagen en el lado derecho del botón.Indicates whether to display an image on the right side of the button.
CMFCButton::m_bTopImageCMFCButton::m_bTopImage Indica si la imagen está enlaparte del botón.Indicates whether the image is on top of the button.
CMFCButton::m_bTransparentCMFCButton::m_bTransparent Indica si el botón es transparente.Indicates whether the button is transparent.
CMFCButton::m_bWasDblClkCMFCButton::m_bWasDblClk Indica si el último evento de clic fue un doble clic.Indicates whether the last click event was a double-click.

ObservacionesRemarks

Otros tipos de botones CMFCButton se derivan de la clase, como la CMFCURLLinkButton clase, que admite hipervínculos y la CMFCColorButton clase, que admite un cuadro de diálogo selector de color.Other types of buttons are derived from the CMFCButton class, such as the CMFCURLLinkButton class, which supports hyperlinks, and the CMFCColorButton class, which supports a color picker dialog box.

El estilo CMFCButton de un objeto puede ser 3D, plano, semiplano o sin borde.The style of a CMFCButton object can be 3D, flat, semi-flat or no border. El texto del botón se puede alinear a la izquierda, la parte superior o el centro de un botón.Button text can be aligned at the left, top, or center of a button. En tiempo de ejecución, puede controlar si el botón muestra texto, una imagen o texto y una imagen.At run time, you can control whether the button displays text, an image, or text and an image. También puede especificar que se muestre una imagen de cursor determinada cuando el cursor se pase sobre un botón.You can also specify that a particular cursor image be displayed when the cursor hovers over a button.

Cree un control de botón directamente en el código o mediante la herramienta Asistente para clases MFC y una plantilla de cuadro de diálogo.Create a button control either directly in your code, or by using the MFC Class Wizard tool and a dialog box template. Si crea un control de CMFCButton botón directamente, agregue una Create variable a CMFCButton la aplicación y, a continuación, llame al constructor y los métodos del objeto.If you create a button control directly, add a CMFCButton variable to your application, and then call the constructor and Create methods of the CMFCButton object. Si utiliza el Asistente para clases MFC, agregue una CButton variable a CButton CMFCButtonla aplicación y, a continuación, cambie el tipo de la variable de a .If you use the MFC Class Wizard, add a CButton variable to your application, and then change the type of the variable from CButton to CMFCButton.

Para controlar los mensajes de notificación en una aplicación de cuadro de diálogo, agregue una entrada de mapa de mensajes y un controlador de eventos para cada notificación.To handle notification messages in a dialog box application, add a message map entry and an event handler for each notification. Las notificaciones enviadas por un CMFCButton objeto son CButton las mismas que las enviadas por un objeto.The notifications sent by a CMFCButton object are the same as those sent by a CButton object.

EjemploExample

En el ejemplo siguiente se muestra cómo configurar las propiedades CMFCButton del botón mediante varios métodos en la clase.The following example demonstrates how to configure the properties of the button by using various methods in the CMFCButton class. El ejemplo forma parte del ejemplo Nuevos controles.The example is part of the New Controls sample.

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

Jerarquía de herenciaInheritance Hierarchy

CObjectCObject

CCmdTargetCCmdTarget

CWndCWnd

CButtonCButton

CMFCButtonCMFCButton

RequisitosRequirements

Encabezado: afxbutton.hHeader: afxbutton.h

CMFCButton::CleanUpCMFCButton::CleanUp

Restablece las variables internas y libera los recursos asignados, como imágenes, mapas de bits e iconos.Resets internal variables and frees allocated resources such as images, bitmaps, and icons.

virtual void CleanUp();

CMFCButton::EnableFullTextTooltipCMFCButton::EnableFullTextTooltip

Especifica si se debe mostrar el texto completo de una información sobre herramientas en una ventana de información sobre herramientas grande o una versión truncada del texto en una pequeña ventana de información sobre herramientas.Specifies whether to display the full text of a tooltip in a large tooltip window or a truncated version of the text in a small tooltip window.

void EnableFullTextTooltip(BOOL bOn=TRUE);

ParámetrosParameters

BonbOn
[en] TRUE para mostrar todo el texto; FALSE para mostrar texto truncado.[in] TRUE to display all of the text; FALSE to display truncated text.

ObservacionesRemarks

CMFCButton::EnableMenuFontCMFCButton::EnableMenuFont

Especifica si la fuente de texto del botón es la misma que la fuente del menú de la aplicación.Specifies whether the button text font is the same as the application menu font.

void EnableMenuFont(
    BOOL bOn=TRUE,
    BOOL bRedraw=TRUE);

ParámetrosParameters

BonbOn
[en] TRUE para utilizar la fuente del menú de la aplicación como fuente de texto del botón; FALSE para utilizar la fuente del sistema.[in] TRUE to use the application menu font as the button text font; FALSE to use the system font. El valor predeterminado es TRUE.The default is TRUE.

bRedrawbRedraw
[en] TRUE para volver a dibujar inmediatamente la pantalla; de lo contrario, FALSE.[in] TRUE to immediately redraw the screen; otherwise, FALSE. El valor predeterminado es TRUE.The default is TRUE.

ObservacionesRemarks

Si no utiliza este método para especificar la fuente de texto del botón, puede especificar la fuente con el CWnd::SetFont método.If you do not use this method to specify the button text font, you can specify the font with the CWnd::SetFont method. Si no especifica una fuente en absoluto, el marco de trabajo establece una fuente predeterminada.If you do not specify a font at all, the framework sets a default font.

CMFCButton::EnableWindowsThemingCMFCButton::EnableWindowsTheming

Especifica si el estilo del borde del botón corresponde al tema actual de Windows.Specifies whether the style of the button border corresponds to the current Windows theme.

static void EnableWindowsTheming(BOOL bEnable = TRUE);

ParámetrosParameters

bHabilitarbEnable
[en] TRUE para usar el tema actual de Windows para dibujar bordes de botón; FALSE para no utilizar el tema de Windows.[in] TRUE to use the current Windows theme to draw button borders; FALSE to not use the Windows theme. El valor predeterminado es TRUE.The default is TRUE.

ObservacionesRemarks

Este método afecta a todos los botones CMFCButton de la aplicación que se derivan de la clase.This method affects all buttons in your application that are derived from the CMFCButton class.

CMFCButton::GetToolTipCtrlCMFCButton::GetToolTipCtrl

Devuelve una referencia al control de información sobre herramientas subyacente.Returns a reference to the underlying tooltip control.

CToolTipCtrl& GetToolTipCtrl();

Valor devueltoReturn Value

Una referencia al control de información sobre herramientas subyacente.A reference to the underlying tooltip control.

ObservacionesRemarks

CMFCButton::IsAutoCheckCMFCButton::IsAutoCheck

Indica si una casilla de verificación o un botón de opción es un botón automático.Indicates whether a check box or radio button is an automatic button.

BOOL IsAutoCheck() const;

Valor devueltoReturn Value

TRUESi el botón tiene BS_AUTOCHECKBOX de estilo o BS_AUTORADIOBUTTON; de lo contrario, FALSE.TRUE if the button has style BS_AUTOCHECKBOX or BS_AUTORADIOBUTTON; otherwise, FALSE.

ObservacionesRemarks

CMFCButton::IsAutorepeatCommandModeCMFCButton::IsAutorepeatCommandMode

Indica si un botón está configurado en modo de repetición automática.Indicates whether a button is set to auto-repeat mode.

BOOL IsAutorepeatCommandMode() const;

Valor devueltoReturn Value

TRUESi el botón está establecido en modo de repetición automática; de lo contrario, FALSE.TRUE if the button is set to auto-repeat mode; otherwise, FALSE.

ObservacionesRemarks

Utilice el método CMFCButton::SetAutorepeatMode para establecer un botón en modo de repetición automática.Use the CMFCButton::SetAutorepeatMode method to set a button to auto-repeat mode.

CMFCButton::IsCheckBoxCMFCButton::IsCheckBox

Indica si un botón es un botón de casilla de verificación.Indicates whether a button is a check box button.

BOOL IsCheckBox() const;

Valor devueltoReturn Value

TRUESi el botón tiene BS_CHECKBOX o BS_AUTOCHECKBOX estilo; de lo contrario, FALSE.TRUE if the button has either BS_CHECKBOX or BS_AUTOCHECKBOX style; otherwise, FALSE.

ObservacionesRemarks

CMFCButton::IsCheckedCMFCButton::IsChecked

Indica si el botón actual está activado.Indicates whether the current button is checked.

BOOL IsChecked() const;

Valor devueltoReturn Value

TRUESi se marca el botón actual; de lo contrario, FALSE.TRUE if the current button is checked; otherwise, FALSE.

ObservacionesRemarks

El marco de trabajo utiliza diferentes maneras de indicar que se comprueban diferentes tipos de botones.The framework uses different ways to indicate that different kinds of buttons are checked. Por ejemplo, un botón de opción se comprueba cuando contiene un punto; una casilla de verificación está marcada cuando contiene una X.For example, a radio button is checked when it contains a dot; a check box is checked when it contains an X.

CMFCButton::IsHighlightedCMFCButton::IsHighlighted

Indica si un botón está resaltado.Indicates whether a button is highlighted.

BOOL IsHighlighted() const;

Valor devueltoReturn Value

TRUESi se resalta el botón; de lo contrario, FALSE.TRUE if the button is highlighted; otherwise, FALSE.

ObservacionesRemarks

Un botón se resalta cuando el ratón pasa el ratón sobre el botón.A button becomes highlighted when the mouse hovers over the button.

CMFCButton::IsPressedCMFCButton::IsPressed

Indica si un botón está presionado y resaltado.Indicates whether a button is pushed and highlighted.

BOOL IsPressed() const;

Valor devueltoReturn Value

TRUESi se pulsa el botón; de lo contrario, FALSE.TRUE if the button is pressed; otherwise, FALSE.

ObservacionesRemarks

CMFCButton::IsPushedCMFCButton::IsPushed

Indica si se presiona un botón.Indicates whether a button is pushed.

BOOL IsPushed() const;

Valor devueltoReturn Value

TRUESi se presiona el botón; de lo contrario, FALSE.TRUE if the button is pushed; otherwise, FALSE.

ObservacionesRemarks

CMFCButton::IsRadioButtonCMFCButton::IsRadioButton

Indica si un botón es un botón de opción.Indicates whether a button is a radio button.

BOOL IsRadioButton() const;

Valor devueltoReturn Value

TRUESi el estilo de botón es BS_RADIOBUTTON o BS_AUTORADIOBUTTON; de lo contrario, FALSE.TRUE if the button style is BS_RADIOBUTTON or BS_AUTORADIOBUTTON; otherwise, FALSE.

ObservacionesRemarks

CMFCButton::IsWindowsThemingEnabledCMFCButton::IsWindowsThemingEnabled

Indica si el estilo del borde del botón corresponde al tema actual de Windows.Indicates whether the style of the button border corresponds to the current Windows theme.

static BOOL IsWindowsThemingEnabled();

Valor devueltoReturn Value

TRUESi el estilo del borde del botón corresponde al tema actual de Windows; de lo contrario, FALSE.TRUE if the style of the button border corresponds to the current Windows theme; otherwise, FALSE.

CMFCButton::m_bDontUseWinXPTheme CMFCButton::m_bDontUseWinXPTheme

Especifica si se deben utilizar temas de Windows XP al dibujar el botón.Specifies whether to use Windows XP themes when drawing the button.

BOOL m_bDontUseWinXPTheme;

CMFCButton::m_bDrawFocusCMFCButton::m_bDrawFocus

Indica si se debe dibujar un rectángulo de foco alrededor de un botón.Indicates whether to draw a focus rectangle around a button.

BOOL m_bDrawFocus;

ObservacionesRemarks

Establezca m_bDrawFocus el miembro en TRUE para especificar que el marco de trabajo dibujará un rectángulo de foco alrededor del texto y la imagen del botón si el botón recibe el foco.Set the m_bDrawFocus member to TRUE to specify that the framework will draw a focus rectangle around the button's text and image if the button receives focus.

El CMFCButton constructor inicializa este miembro en TRUE.The CMFCButton constructor initializes this member to TRUE.

CMFCButton::m_bGrayDisabledCMFCButton::m_bGrayDisabled

Cuando TRUE, habilita un botón deshabilitado para dibujar se dibuja como atenuado.When TRUE, enables a disabled button to be drawn as grayed-out.

BOOL m_bGrayDisabled;

CMFCButton::m_bHighlightCheckedCMFCButton::m_bHighlightChecked

Indica si se debe resaltar un botón de estilo BS_CHECKBOX cuando el cursor se desplaza sobre él.Indicates whether to highlight a BS_CHECKBOX-style button when the cursor hovers over it.

BOOL m_bHighlightChecked;

ObservacionesRemarks

Establezca m_bHighlightChecked el miembro en TRUE para especificar que el marco de trabajo resaltará un botón de estilo BS_CHECKBOX cuando el mouse se pase sobre él.Set the m_bHighlightChecked member to TRUE to specify that the framework will highlight a BS_CHECKBOX-style button when the mouse hovers over it.

CMFCButton::m_bResponseOnButtonDownCMFCButton::m_bResponseOnButtonDown

Indica si se debe responder a eventos de botón hacia abajo.Indicates whether to respond to button down events.

BOOL m_bResponseOnButtonDown;

CMFCButton::m_bRightImageCMFCButton::m_bRightImage

Indica si se debe mostrar una imagen en el lado derecho del botón.Indicates whether to display an image on the right side of the button.

BOOL m_bRightImage;

CMFCButton::m_bTopImage](#m_bTopImage)CMFCButton::m_bTopImage](#m_bTopImage)

Indica si la imagen está enlaparte del botón.Indicates whether the image is on top of the button.

BOOL m_bTopImage;

ObservacionesRemarks

Establezca m_bRightImage el miembro en TRUE para especificar que el marco de trabajo mostrará la imagen del botón a la derecha de la etiqueta de texto del botón.Set the m_bRightImage member to TRUE to specify that the framework will display the button's image to the right of the button's text label.

CMFCButton::m_bTransparentCMFCButton::m_bTransparent

Indica si el botón es transparente.Indicates whether the button is transparent.

BOOL m_bTransparent;

ObservacionesRemarks

Establezca m_bTransparent el miembro en TRUE para especificar que el marco de trabajo hará que el botón sea transparente.Set the m_bTransparent member to TRUE to specify that the framework will make the button transparent. El CMFCButton constructor inicializa este miembro en FALSE.The CMFCButton constructor initializes this member to FALSE.

CMFCButton::m_nAlignStyleCMFCButton::m_nAlignStyle

Especifica la alineación del texto del botón.Specifies the alignment of the button text.

AlignStyle m_nAlignStyle;

ObservacionesRemarks

Utilice uno de CMFCButton::AlignStyle los siguientes valores de enumeración para especificar la alineación del texto del botón:Use one of the following CMFCButton::AlignStyle enumeration values to specify the alignment of the button text:

ValueValue DescripciónDescription
ALIGN_CENTERALIGN_CENTER (Predeterminado) Alinea el texto del botón con el centro del botón.(Default) Aligns the button text to the center of the button.
ALIGN_LEFTALIGN_LEFT Alinea el texto del botón con el lado izquierdo del botón.Aligns the button text to the left side of the button.
ALIGN_RIGHTALIGN_RIGHT Alinea el texto del botón con el lado derecho del botón.Aligns the button text to the right side of the button.

El CMFCButton constructor inicializa este miembro en ALIGN_CENTER.The CMFCButton constructor initializes this member to ALIGN_CENTER.

CMFCButton::m_bWasDblClk](#m_bWasDblClk)CMFCButton::m_bWasDblClk](#m_bWasDblClk)|

Indica si el último evento de clic fue un doble clic.Indicates whether the last click event was a double-click.|

BOOL m_bWasDblClk;

CMFCButton::m_nFlatStyleCMFCButton::m_nFlatStyle

Especifica el estilo del botón, como sin bordes, plano, semiplano o 3D.Specifies the style of the button, such as borderless, flat, semi-flat, or 3D.

FlatStyle  m_nFlatStyle;

ObservacionesRemarks

En la tabla CMFCButton::m_nFlatStyle siguiente se enumeran los valores de enumeración que especifican la apariencia de un botón.The following table lists the CMFCButton::m_nFlatStyle enumeration values that specify the appearance of a button.

ValueValue DescripciónDescription
BUTTONSTYLE_3DBUTTONSTYLE_3D (Predeterminado) El botón parece tener lados altos y tridimensionales.(Default) The button appears to have high, three-dimensional sides. Cuando se hace clic en el botón, el botón parece ser presionado en una sangría profunda.When the button is clicked, the button appears to be pressed into a deep indentation.
BUTTONSTYLE_FLATBUTTONSTYLE_FLAT Cuando el ratón no se detiene sobre el botón, el botón parece ser bidimensional y no tiene lados elevados.When the mouse does not pause over the button, the button appears to be two-dimensional and does not have raised sides. Cuando el ratón se detiene sobre el botón, el botón parece tener lados bajos y tridimensionales.When the mouse pauses over the button, the button appears to have low, three-dimensional sides. Cuando se hace clic en el botón, el botón parece ser presionado en una sangría superficial.When the button is clicked, the button appears to be pressed into a shallow indentation.
BUTTONSTYLE_SEMIFLATBUTTONSTYLE_SEMIFLAT El botón parece tener lados bajos y tridimensionales.The button appears to have low, three-dimensional sides. Cuando se hace clic en el botón, el botón parece ser presionado en una sangría profunda.When the button is clicked, the button appears to be pressed into a deep indentation.
BUTTONSTYLE_NOBORDERSBUTTONSTYLE_NOBORDERS El botón no tiene lados elevados y siempre aparece bidimensional.The button does not have raised sides and always appears two-dimensional. El botón no parece estar presionado en una sangría cuando se hace clic en él.The button does not appear to be pressed into an indentation when it is clicked.

El CMFCButton constructor inicializa este miembro en BUTTONSTYLE_3D.The CMFCButton constructor initializes this member to BUTTONSTYLE_3D.

EjemploExample

En el ejemplo siguiente se muestra m_nFlatStyle cómo establecer CMFCButton los valores de la variable miembro en la clase.The following example demonstrates how to set the values of the m_nFlatStyle member variable in the CMFCButton class. Este ejemplo forma parte del ejemplo Nuevos controles.This example is part of the New Controls sample.

CMFCButton m_Button;
//int m_iBorderStyle
switch (m_iBorderStyle)
{
case 0:
   m_Button.m_nFlatStyle = CMFCButton::BUTTONSTYLE_FLAT;
   break;

case 1:
   m_Button.m_nFlatStyle = CMFCButton::BUTTONSTYLE_SEMIFLAT;
   break;

case 2:
   m_Button.m_nFlatStyle = CMFCButton::BUTTONSTYLE_3D;
}

CMFCButton::OnDrawCMFCButton::OnDraw

Llamado por el marco de trabajo para dibujar un botón.Called by the framework to draw a button.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    UINT uiState);

ParámetrosParameters

pDCpDC
[en] Puntero a un contexto de dispositivo.[in] A pointer to a device context.

Rectrect
[en] Una referencia a un rectángulo que limita el botón.[in] A reference to a rectangle that bounds the button.

uiStateuiState
[en] El estado actual del botón.[in] The current button state. Para obtener más itemState información, vea el miembro de la estructura DRAWITEMSTRUCT tema.For more information, see the itemState member of the DRAWITEMSTRUCT Structure topic.

ObservacionesRemarks

Invalide este método para usar su propio código para dibujar un botón.Override this method to use your own code to draw a button.

CMFCButton::OnDrawBorderCMFCButton::OnDrawBorder

Llamado por el marco de trabajo para dibujar el borde de un botón.Called by the framework to draw the border of a button.

virtual void OnDrawBorder(
    CDC* pDC,
    CRect& rectClient,
    UINT uiState);

ParámetrosParameters

pDCpDC
[en] Puntero a un contexto de dispositivo.[in] A pointer to a device context.

rectClientrectClient
[en] Una referencia a un rectángulo que limita el botón.[in] A reference to a rectangle that bounds the button.

uiStateuiState
[en] El estado actual del botón.[in] The current button state. Para obtener más itemState información, vea el miembro de la estructura DRAWITEMSTRUCT tema.For more information, see the itemState member of the DRAWITEMSTRUCT Structure topic.

ObservacionesRemarks

Invalide este método para usar su propio código para dibujar el borde.Override this method to use your own code to draw the border.

CMFCButton::OnDrawFocusRectCMFCButton::OnDrawFocusRect

Llamado por el marco de trabajo para dibujar el rectángulo de foco para un botón.Called by the framework to draw the focus rectangle for a button.

virtual void OnDrawFocusRect(
    CDC* pDC,
    const CRect& rectClient);

ParámetrosParameters

pDCpDC
[en] Puntero a un contexto de dispositivo.[in] A pointer to a device context.

rectClientrectClient
[en] Una referencia a un rectángulo que limita el botón.[in] A reference to a rectangle that bounds the button.

ObservacionesRemarks

Invalide este método para usar su propio código para dibujar el rectángulo de foco.Override this method to use your own code to draw the focus rectangle.

CMFCButton::OnDrawTextCMFCButton::OnDrawText

Llamado por el marco de trabajo para dibujar el texto del botón.Called by the framework to draw the button text.

virtual void OnDrawText(
    CDC* pDC,
    const CRect& rect,
    const CString& strText,
    UINT uiDTFlags,
    UINT uiState);

ParámetrosParameters

pDCpDC
[en] Puntero a un contexto de dispositivo.[in] A pointer to a device context.

Rectrect
[en] Una referencia a un rectángulo que limita el botón.[in] A reference to a rectangle that bounds the button.

strTextstrText
[en] El texto que se desea dibujar.[in] The text to draw.

uiDTFlagsuiDTFlags
[en] Indicadores que especifican cómo dar formato al texto.[in] Flags that specify how to format the text. Para obtener más información, vea el nFormat parámetro de la CDC::DrawText método.For more information, see the nFormat parameter of the CDC::DrawText method.

uiStateuiState
[in] Reservado.[in] Reserved.

ObservacionesRemarks

Invalide este método para usar su propio código para dibujar el texto del botón.Override this method to use your own code to draw the button text.

CMFCButton::OnFillBackgroundCMFCButton::OnFillBackground

Llamado por el marco de trabajo para dibujar el fondo del texto del botón.Called by the framework to draw the background of the button text.

virtual void OnFillBackground(
    CDC* pDC,
    const CRect& rectClient);

ParámetrosParameters

pDCpDC
[en] Puntero a un contexto de dispositivo.[in] A pointer to a device context.

rectClientrectClient
[en] Una referencia a un rectángulo que limita el botón.[in] A reference to a rectangle that bounds the button.

ObservacionesRemarks

Invalide este método para usar su propio código para dibujar el fondo de un botón.Override this method to use your own code to draw the background of a button.

CMFCButton::SelectFontCMFCButton::SelectFont

Recupera la fuente asociada al contexto de dispositivo especificado.Retrieves the font that is associated with the specified device context.

virtual CFont* SelectFont(CDC* pDC);

ParámetrosParameters

pDCpDC
[en] Puntero a un contexto de dispositivo.[in] A pointer to a device context.

Valor devueltoReturn Value

Invalide este método para usar su propio código para recuperar la fuente.Override this method to use your own code to retrieve the font.

ObservacionesRemarks

CMFCButton::SetAutorepeatModeCMFCButton::SetAutorepeatMode

Establece un botón en modo de repetición automática.Sets a button to auto-repeat mode.

void SetAutorepeatMode(int nTimeDelay=500);

ParámetrosParameters

nTimeDelaynTimeDelay
[en] Número no negativo que especifica el intervalo entre los mensajes que se envían a la ventana primaria.[in] A nonnegative number that specifies the interval between messages that are sent to the parent window. El intervalo se mide en milisegundos y su valor predeterminado es 500 milisegundos.The interval is measured in milliseconds and its default value is 500 milliseconds. Especifique cero para deshabilitar el modo de mensaje de repetición automática.Specify zero to disable auto-repeat message mode.

ObservacionesRemarks

Este método hace que el botón envíe constantemente mensajes de WM_COMMAND a la ventana primaria hasta que se libere el botón o el nTimeDelay parámetro se establece en cero.This method causes the button to constantly send WM_COMMAND messages to the parent window until the button is released, or the nTimeDelay parameter is set to zero.

CMFCButton::SetCheckedImageCMFCButton::SetCheckedImage

Establece la imagen de un botón activado.Sets the image for a checked button.

void SetCheckedImage(
    HICON hIcon,
    BOOL bAutoDestroy=TRUE,
    HICON hIconHot=NULL,
    HICON hIconDisabled=NULL,
    BOOL bAlphaBlend=FALSE);

void SetCheckedImage(
    HBITMAP hBitmap,
    BOOL bAutoDestroy=TRUE,
    HBITMAP hBitmapHot=NULL,
    BOOL bMap3dColors=TRUE,
    HBITMAP hBitmapDisabled=NULL);

void SetCheckedImage(
    UINT uiBmpResId,
    UINT uiBmpHotResId=0,
    UINT uiBmpDsblResID=0);

ParámetrosParameters

hIconhIcon
[en] Controle el icono que contiene el mapa de bits y la máscara de la nueva imagen.[in] Handle to the icon that contains the bitmap and mask for the new image.

bAutoDestroybAutoDestroy
[en] TRUE para especificar que los recursos de mapa de bits se destruyan automáticamente; de lo contrario, FALSE.[in] TRUE to specify that bitmap resources be destroyed automatically; otherwise, FALSE. El valor predeterminado es TRUE.The default is TRUE.

hIconHothIconHot
[en] Controle el icono que contiene la imagen para el estado seleccionado.[in] Handle to the icon that contains the image for the selected state.

hBitmaphBitmap
[en] Controle el mapa de bits que contiene la imagen para el estado no seleccionado.[in] Handle to the bitmap that contains the image for the non-selected state.

hBitmapHothBitmapHot
[en] Controle el mapa de bits que contiene la imagen para el estado seleccionado.[in] Handle to the bitmap that contains the image for the selected state.

bMap3dColorsbMap3dColors
[en] Especifica un color transparente para el fondo del botón; es decir, la cara del botón.[in] Specifies a transparent color for the button background; that is, the face of the button. TRUE para utilizar el valor de color RGB(192, 192, 192); FALSE para utilizar el AFX_GLOBAL_DATA::clrBtnFacevalor de color definido por .TRUE to use the color value RGB(192, 192, 192); FALSE to use the color value defined by AFX_GLOBAL_DATA::clrBtnFace.

uiBmpResIduiBmpResId
[en] Id. de recurso para la imagen no seleccionada.[in] Resource ID for the non-selected image.

uiBmpHotResIduiBmpHotResId
[en] ID de recurso para la imagen seleccionada.[in] Resource ID for the selected image.

hIconDisabledhIconDisabled
[en] Controle el icono de la imagen deshabilitada.[in] Handle to the icon for the disabled image.

hBitmapDisabledhBitmapDisabled
[en] Controle el mapa de bits que contiene la imagen deshabilitada.[in] Handle to the bitmap that contains the disabled image.

uiBmpDsblResIDuiBmpDsblResID
[en] ID de recurso del mapa de bits deshabilitado.[in] Resource ID of the disabled bitmap.

bAlphaBlendbAlphaBlend
[en] TRUE para utilizar solo imágenes de 32 bits que utilizan el canal alfa; FALSE, para no utilizar sólo imágenes de canal alfa.[in] TRUE to use only 32-bit images that use the alpha channel; FALSE, to not use only alpha channel images. El valor predeterminado es FALSE.The default is FALSE.

ObservacionesRemarks

CMFCButton::SetFaceColorCMFCButton::SetFaceColor

Establece el color de fondo del texto del botón.Sets the background color for the button text.

void SetFaceColor(
    COLORREF crFace,
    BOOL bRedraw=TRUE);

ParámetrosParameters

crFacecrFace
[en] Un valor de color RGB.[in] An RGB color value.

bRedrawbRedraw
[en] TRUE para volver a dibujar la pantalla inmediatamente; de lo contrario, FALSE.[in] TRUE to redraw the screen immediately; otherwise, FALSE.

ObservacionesRemarks

Utilice este método para definir un nuevo color de relleno para el fondo del botón (cara).Use this method to define a new fill color for the button background (face). Tenga en cuenta que el fondo no se rellena cuando el CMFCButton::m_bTransparent variable miembro es TRUE.Note that the background is not filled when the CMFCButton::m_bTransparent member variable is TRUE.

CMFCButton::SetImageCMFCButton::SetImage

Establece la imagen de un botón.Sets the image for a button.

void SetImage(
    HICON hIcon,
    BOOL bAutoDestroy=TRUE,
    HICON hIconHot=NULL,
    HICON hIconDisabled=NULL,
    BOOL bAlphaBlend=FALSE);

void SetImage(
    HBITMAP hBitmap,
    BOOL bAutoDestroy=TRUE,
    HBITMAP hBitmapHot=NULL,
    BOOL bMap3dColors=TRUE,
    HBITMAP hBitmapDisabled=NULL);

void SetImage(
    UINT uiBmpResId,
    UINT uiBmpHotResId=0,
    UINT uiBmpDsblResID=0);

ParámetrosParameters

hIconhIcon
[en] Controle el icono que contiene el mapa de bits y la máscara de la nueva imagen.[in] Handle to the icon that contains the bitmap and mask for the new image.

bAutoDestroybAutoDestroy
[en] TRUE para especificar que los recursos de mapa de bits se destruyan automáticamente; de lo contrario, FALSE.[in] TRUE to specify that bitmap resources be destroyed automatically; otherwise, FALSE. El valor predeterminado es TRUE.The default is TRUE.

hIconHothIconHot
[en] Controle el icono que contiene la imagen para el estado seleccionado.[in] Handle to the icon that contains the image for the selected state.

hBitmaphBitmap
[en] Controle el mapa de bits que contiene la imagen para el estado no seleccionado.[in] Handle to the bitmap that contains the image for the non-selected state.

hBitmapHothBitmapHot
[en] Controle el mapa de bits que contiene la imagen para el estado seleccionado.[in] Handle to the bitmap that contains the image for the selected state.

uiBmpResIduiBmpResId
[en] Id. de recurso para la imagen no seleccionada.[in] Resource ID for the non-selected image.

uiBmpHotResIduiBmpHotResId
[en] ID de recurso para la imagen seleccionada.[in] Resource ID for the selected image.

bMap3dColorsbMap3dColors
[en] Especifica un color transparente para el fondo del botón; es decir, la cara del botón.[in] Specifies a transparent color for the button background; that is, the face of the button. TRUE para utilizar el valor de color RGB(192, 192, 192); FALSE para utilizar el AFX_GLOBAL_DATA::clrBtnFacevalor de color definido por .TRUE to use the color value RGB(192, 192, 192); FALSE to use the color value defined by AFX_GLOBAL_DATA::clrBtnFace.

hIconDisabledhIconDisabled
[en] Controle el icono de la imagen deshabilitada.[in] Handle to the icon for the disabled image.

hBitmapDisabledhBitmapDisabled
[en] Controle el mapa de bits que contiene la imagen deshabilitada.[in] Handle to the bitmap that contains the disabled image.

uiBmpDsblResIDuiBmpDsblResID
[en] ID de recurso del mapa de bits deshabilitado.[in] Resource ID of the disabled bitmap.

bAlphaBlendbAlphaBlend
[en] TRUE para utilizar solo imágenes de 32 bits que utilizan el canal alfa; FALSE, para no utilizar sólo imágenes de canal alfa.[in] TRUE to use only 32-bit images that use the alpha channel; FALSE, to not use only alpha channel images. El valor predeterminado es FALSE.The default is FALSE.

ObservacionesRemarks

EjemploExample

En el ejemplo siguiente se muestra SetImage cómo utilizar CMFCButton varias versiones del método en la clase.The following example demonstrates how to use various versions of the SetImage method in the CMFCButton class. El ejemplo forma parte del ejemplo Nuevos controles.The example is part of the New Controls sample.

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);
}

CMFCButton::SetMouseCursorCMFCButton::SetMouseCursor

Establece la imagen del cursor.Sets the cursor image.

void SetMouseCursor(HCURSOR hcursor);

ParámetrosParameters

hcursorhcursor
[en] El identificador de un cursor.[in] The handle of a cursor.

ObservacionesRemarks

Utilice este método para asociar una imagen de cursor, como el cursor de la mano, con el botón.Use this method to associate a cursor image, such as the hand cursor, with the button. El cursor se carga desde los recursos de la aplicación.The cursor is loaded from the application resources.

EjemploExample

En el ejemplo siguiente se SetMouseCursor muestra CMFCButton cómo utilizar el método en la clase.The following example demonstrates how to use the SetMouseCursor method in the CMFCButton class. El ejemplo forma parte del código del ejemplo Nuevos controles.The example is part of the code in the New Controls sample.

CMFCButton m_Button;
// int m_iCursor
void CPage1::OnSetCursor()
{
   UpdateData();

   switch (m_iCursor)
   {
   case 0:
      m_Button.SetMouseCursor(NULL);
      break;

   case 1:
      m_Button.SetMouseCursorHand();
      break;

   case 2:
      m_Button.SetMouseCursor(AfxGetApp()->LoadCursor(IDC_CURSOR));
      break;
   }
}

CMFCButton::SetMouseCursorHandCMFCButton::SetMouseCursorHand

Establece el cursor en la imagen de una mano.Sets the cursor to the image of a hand.

void SetMouseCursorHand();

ObservacionesRemarks

Utilice este método para asociar la imagen del cursor de una mano con el botón.Use this method to associate the cursor image of a hand with the button. El cursor se carga desde los recursos de la aplicación.The cursor is loaded from the application resources.

CMFCButton::SetStdImageCMFCButton::SetStdImage

Utiliza CMenuImages un objeto para establecer la imagen del botón.Uses a CMenuImages object to set the button image.

void SetStdImage(
    CMenuImages::IMAGES_IDS id,
    CMenuImages::IMAGE_STATE state=CMenuImages::ImageBlack,
    CMenuImages::IMAGES_IDS idDisabled=(CMenuImages::IMAGES_IDS)0);

ParámetrosParameters

idid
[en] Uno de los identificadores de imagen CMenuImage::IMAGES_IDS de botón que se define en la enumeración.[in] One of the button image identifiers that is defined in the CMenuImage::IMAGES_IDS enumeration. Los valores de imagen especifican imágenes como flechas, pines y botones de opción.The image values specify images such as arrows, pins, and radio buttons.

statestate
[en] Uno de los identificadores de estado CMenuImages::IMAGE_STATE de imagen de botón que se define en la enumeración.[in] One of the button image state identifiers that is defined in the CMenuImages::IMAGE_STATE enumeration. Los estados de imagen especifican colores de botón como negro, gris, gris claro, blanco y gris oscuro.The image states specify button colors such as black, gray, light gray, white, and dark gray. El valor predeterminado es CMenuImages::ImageBlack.The default value is CMenuImages::ImageBlack.

idDisabledidDisabled
[en] Uno de los identificadores de imagen CMenuImage::IMAGES_IDS de botón que se define en la enumeración.[in] One of the button image identifiers that is defined in the CMenuImage::IMAGES_IDS enumeration. La imagen indica que el botón está deshabilitado.The image indicates that the button is disabled. El valor predeterminado es la CMenuImages::IdArrowDownprimera imagen de botón ( ).The default value is the first button image ( CMenuImages::IdArrowDown).

ObservacionesRemarks

CMFCButton::SetTextColorCMFCButton::SetTextColor

Establece el color del texto del botón para un botón que no está seleccionado.Sets the color of the button text for a button that is not selected.

void SetTextColor(COLORREF clrText);

ParámetrosParameters

clrTextclrText
[en] Un valor de color RGB.[in] An RGB color value.

ObservacionesRemarks

CMFCButton::SetTextHotColorCMFCButton::SetTextHotColor

Establece el color del texto del botón para un botón seleccionado.Sets the color of the button text for a button that is selected.

void SetTextHotColor(COLORREF clrTextHot);

ParámetrosParameters

clrTextHotclrTextHot
[en] Un valor de color RGB.[in] An RGB color value.

ObservacionesRemarks

CMFCButton::SetTooltipCMFCButton::SetTooltip

Asocia una información sobre herramientas con un botón.Associates a tooltip with a button.

void SetTooltip(LPCTSTR lpszToolTipText);

ParámetrosParameters

lpszToolTipTextlpszToolTipText
[en] Puntero al texto de la información sobre herramientas.[in] Pointer to the text for the tooltip. Especifique NULL para deshabilitar la información sobre herramientas.Specify NULL to disable the tooltip.

ObservacionesRemarks

CMFCButton::SizeToContentCMFCButton::SizeToContent

Cambia el tamaño de un botón para que contenga el texto y la imagen del botón.Resizes a button to contain its button text and image.

virtual CSize SizeToContent(BOOL bCalcOnly=FALSE);

ParámetrosParameters

bCalcOnlybCalcOnly
[en] TRUE para calcular, pero no cambiar, el nuevo tamaño del botón; FALSE para cambiar el tamaño del botón.[in] TRUE to calculate, but not change, the new size of the button; FALSE to change the size of the button. El valor predeterminado es FALSE.The default is FALSE.

Valor devueltoReturn Value

Objeto CSize que contiene el nuevo tamaño del botón.A CSize object that contains the new size of the button.

ObservacionesRemarks

De forma predeterminada, este método calcula un nuevo tamaño que incluye un margen horizontal de 10 píxeles y un margen vertical de 5 píxeles.By default, this method calculates a new size that includes a horizontal margin of 10 pixels and a vertical margin of 5 pixels.

Vea tambiénSee also

Gráfico de jerarquíasHierarchy Chart
ClasesClasses
CMFCLinkCtrl (clase)CMFCLinkCtrl Class
CMFCColorButton (Clase)CMFCColorButton Class
CMFCMenuButton (clase)CMFCMenuButton Class