CMFCPropertyGridColorProperty 类

项目
10/16/2023

CMFCPropertyGridColorProperty 类支持用于打开颜色选择对话框的属性列表控件项。

语法

class CMFCPropertyGridColorProperty : public CMFCPropertyGridProperty

成员

公共构造函数

名称	描述
CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty	构造 `CMFCPropertyGridColorProperty` 对象。
`CMFCPropertyGridColorProperty::~CMFCPropertyGridColorProperty`	析构函数。

公共方法

名称	描述
CMFCPropertyGridColorProperty::EnableAutomaticButton	启用颜色选择对话框上的“自动”按钮。（标准的“自动”按钮标记为“自动”。）
CMFCPropertyGridColorProperty::EnableOtherButton	启用颜色选择对话框上的“其他”按钮。（标准的“其他”按钮标记为“更多颜色”。）
`CMFCPropertyGridColorProperty::FormatProperty`	设置属性值的文本表示形式的格式。（替代 CMFCPropertyGridProperty::FormatProperty。）
CMFCPropertyGridColorProperty::GetColor	获取属性的当前颜色。
`CMFCPropertyGridColorProperty::GetThisClass`	由框架用于获取指向与此类类型关联的 CRuntimeClass 对象的指针。
`CMFCPropertyGridColorProperty::OnClickButton`	当用户单击属性中包含的按钮时，由框架调用。（替代 CMFCPropertyGridProperty::OnClickButton。）
`CMFCPropertyGridColorProperty::OnDrawValue`	由框架调用以显示属性值。（替代 CMFCPropertyGridProperty::OnDrawValue。）
`CMFCPropertyGridColorProperty::OnEdit`	当用户要修改属性值时由框架调用。（替代 CMFCPropertyGridProperty::OnEdit。）
`CMFCPropertyGridColorProperty::OnUpdateValue`	当可编辑属性值已更改时由框架调用。（替代 CMFCPropertyGridProperty::OnUpdateValue。）
CMFCPropertyGridColorProperty::SetColor	设置属性的新颜色。
CMFCPropertyGridColorProperty::SetColumnsNumber	指定当前颜色属性网格中的列数。
CMFCPropertyGridColorProperty::SetOriginalValue	设置可编辑属性的原始值。

备注

CMFCPropertyGridColorProperty 类支持可添加到属性列表控件的颜色属性。有关详细信息，请参阅 CMFCPropertyGridCtrl 类。

示例

下面的示例演示如何构造 CMFCPropertyGridColorProperty 类的对象，以及如何使用 CMFCPropertyGridColorProperty 类的各种方法来配置此对象。下面的代码介绍如何启用“自动”按钮和“其他”按钮，以及如何设置颜色和列数。本示例是新控件示例的一部分。

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);

继承层次结构

CObject

CMFCPropertyGridProperty

CMFCPropertyGridColorProperty

要求

标头：afxpropertygridctrl.h

CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty

构造 CMFCPropertyGridColorProperty 对象。

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

参数

strName
[in] 属性的名称。

color
[in] 属性的颜色值。

pPalette
[in] 指向调色板的指针。默认值为 NULL。

lpszDescr
[in] 属性说明。默认值为 NULL。

dwData
[in] 特定于应用程序的数据，例如整数或指向与属性关联的其他数据的指针。默认值为 0。

CMFCPropertyGridColorProperty::EnableAutomaticButton

启用颜色选择对话框上的“自动”按钮。（标准的“自动”按钮标记为“自动”。）

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

参数

lpszLabel
[in]“自动”按钮的标签文本。

colorAutomatic
[in] 自动（默认）颜色的 RGB 颜色值。

bEnable
[in] 若要启用“自动”按钮，则为 TRUE；否则为 FALSE。默认值为 TRUE。

注解

CMFCPropertyGridColorProperty::EnableOtherButton

启用颜色选择对话框上的“其他”按钮。（标准的“其他”按钮标记为“更多颜色”。）

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

参数

lpszLabel
[in]“其他”按钮的标签文本。

bAltColorDlg
[in] 若要显示 CMFCColorDialog 对话框，则为 TRUE；若要显示标准颜色选择对话框，则为 FALSE。默认值为 TRUE。

bEnable
[in] 若要显示“其他”按钮，则为 TRUE；否则为 FALSE。默认值为 TRUE。

注解

CMFCPropertyGridColorProperty::GetColor

获取属性的当前颜色。

COLORREF GetColor() const;

返回值

RGB 颜色值。

注解

CMFCPropertyGridColorProperty::SetColor

设置属性的新颜色。

void SetColor(COLORREF color);

参数

color
[in] RGB 颜色值。

注解

CMFCPropertyGridColorProperty::SetColumnsNumber

指定当前颜色属性网格中的列数。

void SetColumnsNumber(int nColumnsNumber);

参数

nColumnsNumber
[in] 颜色属性网格中的首选列数。

注解

此方法会设置受保护的 m_nColumnsNumber 数据成员的值。

CMFCPropertyGridColorProperty::SetOriginalValue

设置可编辑属性的原始值。

virtual void SetOriginalValue(const COleVariant& varValue);

参数

varValue
[in] 一个值。

备注

使用 CMFCPropertyGridProperty::ResetOriginalValue 方法来重置已编辑属性的原始值。

另请参阅

层次结构图
 类
 CMFCPropertyGridCtrl 类
 CMFCPropertyGridProperty 类

通过