Compartir por

Clase CMFCColorDialog

  • Artigo

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

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

CMFCColorDialog

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.

Comentarios

Consulte también

Gráfico de jerarquías
Clases
CMFCColorPickerCtrl (clase)