CMFCPropertyGridColorProperty (clase)

La clase CMFCPropertyGridColorProperty admite un elemento de control de la lista de propiedades que abre un cuadro de diálogo de selección de color.

Sintaxis

class CMFCPropertyGridColorProperty : public CMFCPropertyGridProperty

Miembros

Constructores públicos

Nombre	Descripción
CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty	Construye un objeto CMFCPropertyGridColorProperty.
CMFCPropertyGridColorProperty::~CMFCPropertyGridColorProperty	Destructor.

Métodos públicos

Nombre	Descripción
CMFCPropertyGridColorProperty::EnableAutomaticButton	Habilita el botón automático en el cuadro de diálogo de selección de color. (El botón automático estándar tiene la etiqueta Automático).
CMFCPropertyGridColorProperty::EnableOtherButton	Habilita el botón otros en el cuadro de diálogo de selección de color. (El botón estándar “Otros” tiene la etiqueta Más colores).
CMFCPropertyGridColorProperty::FormatProperty	Da formato a la representación de texto de un valor de propiedad. (Invalida CMFCPropertyGridProperty::FormatProperty).
CMFCPropertyGridColorProperty::GetColor	Obtiene el color actual de la propiedad.
CMFCPropertyGridColorProperty::GetThisClass	Lo usa el marco para obtener un puntero al objeto CRuntimeClass asociado a este tipo de clase.
CMFCPropertyGridColorProperty::OnClickButton	Lo llama el marco cuando el usuario hace clic en un botón que se encuentra en una propiedad. (Invalida CMFCPropertyGridProperty::OnClickButton.)
CMFCPropertyGridColorProperty::OnDrawValue	Lo llama el marco para mostrar el valor de la propiedad. (Invalida CMFCPropertyGridProperty::OnDrawValue.)
CMFCPropertyGridColorProperty::OnEdit	Lo llama el marco cuando el usuario está a punto de modificar un valor de propiedad. (Invalida CMFCPropertyGridProperty::OnEdit.)
CMFCPropertyGridColorProperty::OnUpdateValue	Lo llama el marco cuando el valor de una propiedad editable ha cambiado. (Invalida CMFCPropertyGridProperty::OnUpdateValue.)
CMFCPropertyGridColorProperty::SetColor	Establece un nuevo color para la propiedad.
CMFCPropertyGridColorProperty::SetColumnsNumber	Especifica el número de columnas de la cuadrícula de propiedades de color actual.
CMFCPropertyGridColorProperty::SetOriginalValue	Establece el valor original de una propiedad editable.

Comentarios

La clase CMFCPropertyGridColorProperty admite una propiedad de color que puede agregarse a un control de lista de propiedades. Para obtener más información, consulte CMFCPropertyGridCtrl (clase).

Ejemplo

En el ejemplo siguiente se muestra cómo construir un objeto de la clase CMFCPropertyGridColorProperty y configurarlo con varios métodos de la clase CMFCPropertyGridColorProperty. El código explica cómo habilitar los botones automáticos y otros botones, y cómo establecer el color y el número de columnas. Este ejemplo forma parte del ejemplo de controles nuevos.

CMFCPropertyGridColorProperty *pColorProp = new CMFCPropertyGridColorProperty(_T("Window Color"), RGB(210, 192, 254), NULL, _T("Specifies the default dialog color"));
pColorProp->EnableOtherButton(_T("Other..."));
pColorProp->EnableAutomaticButton(_T("Default"), ::GetSysColor(COLOR_3DFACE));
pColorProp->SetColor(RGB(255, 0, 0));
pColorProp->SetColumnsNumber(3);

Jerarquía de herencia

CObject

CMFCPropertyGridPropertyProperty

CMFCPropertyGridColorProperty

Requisitos

Encabezado: afxpropertygridctrl.h

CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty

Construye un objeto CMFCPropertyGridColorProperty.

CMFCPropertyGridColorProperty(
    const CString& strName,
    const COLORREF& color,
    CPalette* pPalette = NULL,
    LPCTSTR lpszDescr = NULL,
    DWORD_PTR dwData = 0);

Parámetros

strName
[in] Nombre de la propiedad.

color
[in] Valor de color de la propiedad .

pPalette
[in] Puntero a una paleta de colores. El valor predeterminado es NULL.

lpszDescr
[in] Descripción de la propiedad. El valor predeterminado es NULL.

dwData
[in] Datos específicos de la aplicación, como un entero o un puntero a otros datos asociados a la propiedad. El valor predeterminado es 0.

CMFCPropertyGridColorProperty::EnableAutomaticButton

Habilita el botón automático en el cuadro de diálogo de selección de color. (El botón automático estándar tiene la etiqueta Automático).

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

Parámetros

lpszLabel
[in] Texto de etiqueta del botón automático.

colorAutomatic
[in] Valor de color RGB del color automático (predeterminado).

bEnable
[in] TRUE para habilitar el botón automático; de lo contrario, FALSE. El valor predeterminado es TRUE.

Comentarios

CMFCPropertyGridColorProperty::EnableOtherButton

Habilita el botón otros en el cuadro de diálogo de selección de color. (El botón estándar “Otros” tiene la etiqueta Más colores).

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg = TRUE,
    BOOL bEnable = TRUE);

Parámetros

lpszLabel
[in] Texto de etiqueta del botón “Otros”.

bAltColorDlg
[in] TRUE para mostrar el cuadro de diálogo CMFCColorDialog; FALSE para mostrar el cuadro de diálogo de selección de color estándar. El valor predeterminado es TRUE.

bEnable
[in] TRUE para que aparezca el botón "Otros"; de lo contrario, FALSE. El valor predeterminado es TRUE.

Comentarios

CMFCPropertyGridColorProperty::GetColor

Obtiene el color actual de la propiedad.

COLORREF GetColor() const;

Valor devuelto

Un valor de color RGB.

Comentarios

CMFCPropertyGridColorProperty::SetColor

Establece un nuevo color para la propiedad.

void SetColor(COLORREF color);

Parámetros

color
[in] Valor de color RGB.

Comentarios

CMFCPropertyGridColorProperty::SetColumnsNumber

Especifica el número de columnas de la cuadrícula de propiedades de color actual.

void SetColumnsNumber(int nColumnsNumber);

Parámetros

nColumnsNumber
[in] Número preferido de columnas en la cuadrícula de propiedades de color.

Comentarios

Este método establece el valor del miembro de datos protegido m_nColumnsNumber.

CMFCPropertyGridColorProperty::SetOriginalValue

Establece el valor original de una propiedad editable.

virtual void SetOriginalValue(const COleVariant& varValue);

Parámetros

varValue
[in] Un valor.

Comentarios

Use el método CMFCPropertyGridProperty::ResetOriginalValue para restablecer el valor original de una propiedad editada.

Consulte también

Gráfico de jerarquías
Clases
CMFCPropertyGridCtrl (clase)
CMFCPropertyGridProperty (clase)