Compartir a través de

CMFCPropertyGridColorProperty (clase)

Nota:

La biblioteca Microsoft Foundation Classes (MFC) sigue siendo compatible. Sin embargo, ya no estamos agregando características ni actualizando la documentación.

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)

  • Last updated on