Clase CMFCColorDialog
La clase CMFCColorDialog representa un cuadro de diálogo de selección de color.
Sintaxis
class CMFCColorDialog : public CDialogEx
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CMFCColorDialog::CMFCColorDialog | Construye un objeto CMFCColorDialog. |
CMFCColorDialog::~CMFCColorDialog |
Destructor. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CMFCColorDialog::GetColor | Devuelve el color actualmente seleccionado. |
| CMFCColorDialog::GetPalette | Devuelve la paleta de colores. |
CMFCColorDialog::PreTranslateMessage |
Traduce los mensajes de ventana antes de enviarlos a las funciones de Windows TranslateMessage y DispatchMessage. Para obtener más información y la sintaxis, consulte CWnd::PreTranslateMessage. (Invalida CDialogEx::PreTranslateMessage). |
| CMFCColorDialog::RebuildPalette | Deriva una paleta de la paleta del sistema. |
| CMFCColorDialog::SetCurrentColor | Establece el color actualmente seleccionado. |
| CMFCColorDialog::SetNewColor | Establece el color más equivalente a un valor RGB especificado. |
| CMFCColorDialog::SetPageOne | Selecciona un valor RGB para la primera página de propiedades. |
| CMFCColorDialog::SetPageTwo | Selecciona un valor RGB para la segunda página de propiedades. |
Miembros de datos protegidos
| Nombre | Descripción |
|---|---|
m_bIsMyPalette |
TRUE si el cuadro de diálogo de selección de colores usa su propia paleta de colores o FALSE si usa una paleta especificada en el constructor CMFCColorDialog. |
m_bPickerMode |
TRUE mientras el usuario selecciona un color en el cuadro de diálogo de selección; de lo contrario, FALSE. |
m_btnColorSelect |
Botón de color que el usuario ha seleccionado. |
m_CurrentColor |
Color seleccionado actualmente. |
m_hcurPicker |
Cursor que se usa para elegir un color. |
m_NewColor |
Posible color seleccionado que se puede seleccionar permanentemente o revertir al color original. |
m_pColourSheetOne |
Puntero a la primera página de propiedades de la hoja de propiedades de selección de color. |
m_pColourSheetTwo |
Puntero a la segunda página de propiedades de la hoja de propiedades de selección de color. |
m_pPalette |
Paleta lógica actual. |
m_pPropSheet |
Puntero a la hoja de propiedades del cuadro de diálogo de selección de color. |
m_wndColors |
Objeto de control del selector de colores. |
m_wndStaticPlaceHolder |
Control estático que es un marcador de posición de la hoja de propiedades del selector de colores. |
Comentarios
El cuadro de diálogo de selección de color se muestra como una hoja de propiedades con dos páginas. En la primera página, puede seleccionar un color estándar en la paleta del sistema; en la segunda un color personalizado.
Puede construir un objeto CMFCColorDialog en la pila y, a continuación, llamar a DoModal, pasando el color inicial como parámetro al constructor CMFCColorDialog. A continuación, el cuadro de diálogo de selección de color crea varios objetos CMFCColorPickerCtrl Class para controlar cada paleta de colores.
Jerarquía de herencia
Ejemplo
En el ejemplo siguiente, se muestra cómo configurar un cuadro de diálogo de colores mediante varios métodos de la clase CMFCColorDialog. En el ejemplo se muestra cómo establecer los colores actuales y nuevos del cuadro de diálogo y cómo establecer los componentes rojo, verde y azul de un color seleccionado en las dos páginas de propiedades del cuadro de diálogo de color. Este ejemplo forma parte del ejemplo de controles nuevos.
// COLORREF m_Color
CMFCColorDialog dlg(m_Color, 0, this);
dlg.SetCurrentColor(RGB(0, 255, 0));
dlg.SetNewColor(RGB(0, 0, 255));
// set the red, green, and blue components of a selected
// color on the two property pages of the color dialog
dlg.SetPageOne(255, 0, 0);
dlg.SetPageTwo(0, 255, 0);
Requisitos
Encabezado: afxcolordialog.h
CMFCColorDialog::CMFCColorDialog
Construye un objeto CMFCColorDialog.
CMFCColorDialog(
COLORREF clrInit=0,
DWORD dwFlags=0,
CWnd* pParentWnd=NULL,
HPALETTE hPal=NULL);
Parámetros
clrInit
[in] Selección de color predeterminada. Si no se especifica ningún valor, el valor predeterminado es RGB(0,0,0) (negro).
dwFlags
[in] Reservado.
pParentWnd
[in] Puntero a la ventana principal o propietaria del cuadro de diálogo.
hPal
[in] Identificador de una paleta de colores.
Valor devuelto
Comentarios
CMFCColorDialog::GetColor
Recupera el color que el usuario selecciona en el cuadro de diálogo de colores.
COLORREF GetColor() const;
Valor devuelto
Valor COLORREF que contiene la información RGB del color seleccionado en el cuadro de diálogo de color.
Comentarios
Llame a esta función después de llamar al método DoModal.
CMFCColorDialog::GetPalette
Recupera la paleta de colores que está disponible en el cuadro de diálogo de colores actual.
CPalette* GetPalette() const;
Valor devuelto
Puntero al objeto CPalette especificado en el constructor CMFCColorDialog.
Comentarios
La paleta de colores especifica los colores que el usuario puede elegir.
CMFCColorDialog::RebuildPalette
Deriva una paleta de la paleta del sistema.
void RebuildPalette();
CMFCColorDialog::SetCurrentColor
Establece el color actual del cuadro de diálogo.
void SetCurrentColor(COLORREF rgb);
Parámetros
rgb
[in] Valor de color RGB
Comentarios
CMFCColorDialog::SetNewColor
Establece el color actual en el color de la paleta actual que es más parecido.
void SetNewColor(COLORREF rgb);
Parámetros
rgb
[in] COLORREF que especifica un color RGB.
Comentarios
CMFCColorDialog::SetPageOne
Especifica explícitamente los componentes rojo, verde y azul de un color seleccionado en la primera página de propiedades de un cuadro de diálogo de colores.
void SetPageOne(
BYTE R,
BYTE G,
BYTE B);
Parámetros
R
[in] Especifica el componente rojo del valor RGB.
G
[in] Especifica el componente verde del valor RGB.
B
[in] Especifica el componente azul del valor RGB.
Comentarios
CMFCColorDialog::SetPageTwo
Especifica explícitamente los componentes rojo, verde y azul de un color seleccionado en la segunda página de propiedades de un cuadro de diálogo de colores.
void SetPageTwo(
BYTE R,
BYTE G,
BYTE B);
Parámetros
R
[in] Especifica un componente rojo del valor RGB.
G
[in] Especifica un componente verde del valor RGB.
B
[in] Especifica un componente azul del valor RGB.