CMFCColorButton Class
CMFCColorButton y las clases de CMFCColorBar Class se utilizan conjuntamente para implementar un control de selector de color.
class CMFCColorButton : public CMFCButton
Members
Constructores públicos
Name |
Descripción |
---|---|
Crea un nuevo objeto CMFCColorButton. |
Métodos públicos
Name |
Descripción |
---|---|
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.) |
|
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….) |
|
Recupera el color automático actual. |
|
Recupera el color de un botón. |
|
Establece el color de un botón. |
|
Establece un nombre de color. |
|
Establece el número de columnas del cuadro de diálogo selector de colores. |
|
Especifica una lista de colores documento-específicos que aparecen en el cuadro de diálogo selector de colores. |
|
Especifica una paleta colores estándar de la pantalla. |
|
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 |
---|---|
Indica si el botón de color actual se muestra en el estilo visual de Windows XP. |
|
Llamado por el marco para mostrar una imagen del botón. |
|
Llamado por el marco para mostrar el borde del botón. |
|
Llamado por el marco para mostrar un rectángulo de foco cuando el botón tiene el foco. |
|
Llamado por el marco cuando el cuadro de diálogo selector de colores se va a mostrar. |
|
Inicializa el miembro de datos protegido m_pPalette a la tabla especificada o a la paleta predeterminada del sistema. |
|
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. |
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 CMFCColorPopupMenu Class . 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 (CMFCColorBar Class) 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);
Requisitos
encabezado: afxcolorbutton.h
Vea también
Referencia
CMFCColorButton::OnShowColorPopup