Clase de CMFCColorButton

Artículo
04/10/2013

CMFCColorButton y las clases de Clase de CMFCColorBar se utilizan conjuntamente para implementar un control de selector de color.

class CMFCColorButton : public CMFCButton

Members

Constructores públicos

Name	Descripción
CMFCColorButton::CMFCColorButton	Crea un nuevo objeto CMFCColorButton.

Métodos públicos

Name	Descripción
CMFCColorButton::EnableAutomaticButton	Habilita y deshabilita un botón “automático” que se coloque sobre los botones de color regulares.(El botón automático de sistema estándar se etiqueta Automático.)
CMFCColorButton::EnableOtherButton	Habilita y deshabilita “other” botón que se coloque debajo de los botones de color regulares.(El sistema estándar de El “other” botón se etiqueta más colores….)
CMFCColorButton::GetAutomaticColor	Recupera el color automático actual.
CMFCColorButton::GetColor	Recupera el color de un botón.
CMFCColorButton::SetColor	Establece el color de un botón.
CMFCColorButton::SetColorName	Establece un nombre de color.
CMFCColorButton::SetColumnsNumber	Establece el número de columnas del cuadro de diálogo selector de colores.
CMFCColorButton::SetDocumentColors	Especifica una lista de colores documento-específicos que aparecen en el cuadro de diálogo selector de colores.
CMFCColorButton::SetPalette	Especifica una paleta colores estándar de la pantalla.
CMFCColorButton::SizeToContent	Cambia el tamaño del control de botón, dependiendo de su texto y tamaño de la imagen.

Métodos protegidos

Name	Descripción
CMFCColorButton::IsDrawXPTheme	Indica si el botón de color actual se muestra en el estilo visual de Windows XP.
CMFCColorButton::OnDraw	Llamado por el marco para mostrar una imagen del botón.
CMFCColorButton::OnDrawBorder	Llamado por el marco para mostrar el borde del botón.
CMFCColorButton::OnDrawFocusRect	Llamado por el marco para mostrar un rectángulo de foco cuando el botón tiene el foco.
CMFCColorButton::OnShowColorPopup	Llamado por el marco cuando el cuadro de diálogo selector de colores se va a mostrar.
CMFCColorButton::RebuildPalette	Inicializa el miembro de datos protegido m_pPalette a la tabla especificada o a la paleta predeterminada del sistema.
CMFCColorButton::UpdateColor	Llamado por el marco cuando el usuario seleccione un color de la paleta del cuadro de diálogo selector de colores.

miembros de datos

Name	Descripción
m_bAltColorDlg	Valor booleano.Si TRUE, el marco muestra el cuadro de diálogo color de CMFCColorDialog cuando se hace clic en otro botón, o si FALSE, el cuadro de diálogo del color del sistema.El valor predeterminado es TRUE.Para obtener más información, vea CMFCColorButton::EnableOtherButton.
m_bAutoSetFocus	Valor booleano.Si TRUE, el marco establece el foco en el menú de color cuando se muestra el menú, o si FALSE, no cambia el foco.El valor predeterminado es TRUE.
CMFCColorButton::m_bEnabledInCustomizeMode	Indica si se habilita el modo de personalización para el botón de color.
m_Color	un valor de COLORREF .Contiene el color seleccionado actualmente.
m_ColorAutomatic	un valor de COLORREF .Contiene el color predeterminado actualmente seleccionado.
m_Colors	CArray de los valores de COLORREF .Contiene los colores disponibles actualmente.
m_lstDocColors	CList de los valores de COLORREF .Contiene los colores del documento actual.
m_nColumns	Entero.Contiene el número de columnas para mostrar en la cuadrícula de colores en un menú de selección de color.
m_pPalette	un puntero a CPalette.Contiene los colores disponibles en el menú de selección actual en color.
m_pPopup	un puntero a un objeto de Clase de CMFCColorPopupMenu .El menú de selección de color se muestra al hacer clic en el botón de color.
m_strAutoColorText	Una cadena.La etiqueta del botón “automático” en un menú de selección de color.
m_strDocColorsText	Una cadena.La etiqueta del botón en un menú de selección de color que muestra los colores del documento.
m_strOtherText	Una cadena.La etiqueta de “other” en un menú de selección de color.

Comentarios

De forma predeterminada, la clase de CMFCColorButton se comporta como un botón de comando que abre un cuadro de diálogo selector de colores.El cuadro de diálogo selector de colores contiene una matriz de pequeños botones de color y “other” botón que muestra un selector de colores personalizados.(El sistema estándar de El “other” botón se etiqueta más colores….) Cuando un usuario selecciona un color nuevo, el objeto de CMFCColorButton refleja el cambio y muestra el color seleccionado.

Cree un control de botón en color directamente en el código, o mediante la herramienta de ClassWizard y una plantilla de cuadro de diálogo.Si crea un control de botón en color directamente, agregue una variable de CMFCColorButton a la aplicación, y llame al constructor y los métodos de Create del objeto de CMFCColorButton .Si utiliza ClassWizard, agregue una variable de CButton a la aplicación, y después cambie el tipo de la variable de CButton a CMFCColorButton.

El cuadro de diálogo selector de colores (Clase de CMFCColorBar) se muestra mediante el método de CMFCColorButton::OnShowColorPopup cuando el marco de trabajo llama al controlador de eventos de OnLButtonDown .El método de CMFCColorButton::OnShowColorPopup se puede invalidar para admitir la selección de colores personalizada.

El objeto de CMFCColorButton notifica a su elemento primario que color cambia enviándole una notificación de WM_COMMAND | BN_CLICKED .El elemento primario usa el método de CMFCColorButton::GetColor para recuperar el color actual.

Ejemplo

El ejemplo siguiente muestra cómo configurar un botón en color mediante varios métodos en la clase de CMFCColorButton .Los métodos establecen el color del botón de color y del número de columnas, y permiten los botones automáticos y otros.Este ejemplo forma parte de Ejemplo de demostración de la barra de estado.

    CMFCColorButton m_wndTextColor;


...


    m_wndTextColor.EnableAutomaticButton (_T("Default"), afxGlobalData.clrBtnText);
    m_wndTextColor.EnableOtherButton (_T("Other..."));
    m_wndTextColor.SetColor ((COLORREF)-1);
    m_wndTextColor.SetColorName((COLORREF)-1, "Default Color");
    m_wndTextColor.SetColumnsNumber(3);