CColorDialog选件类

项目
03/01/2013

允许将颜色选择对话框向应用程序中。

class CColorDialog : public CCommonDialog

成员

公共构造函数

名称	说明
CColorDialog::CColorDialog	构造 CColorDialog 对象。

公共方法

名称	说明
CColorDialog::DoModal	显示颜色对话框以及允许用户进行选择。
CColorDialog::GetColor	返回包含选定颜色的值 COLORREF 结构。
CColorDialog::GetSavedCustomColors	检索用户创建的自定义颜色。
CColorDialog::SetCurrentColor	强制当前颜色选择到指定的颜色。

受保护的方法

名称	说明
CColorDialog::OnColorOK	验证颜色的重写联接对话框。

公共数据成员

名称	说明
CColorDialog::m_cc	用于的结构自定义对话框的设置。

备注

CColorDialog 对象是具有用于显示系统定义颜色的列表的对话框。用户可以从列表中选择或创建特殊颜色，然后报告回应用程序，当对话框退出时。

构造 CColorDialog 对象，使用提供的构造函数或派生新选件类和使用自定义构造函数。

一旦对话框构造的，则可以设置或修改在m_cc 结构中的所有值初始化对话框的控件的值。m_cc 机制是类型 CHOOSECOLOR。

在初始化对话框的控件之后，调用 DoModal 成员函数显示对话框并让用户选择颜色。DoModal 返回好的对话框(IDOK)或cancel (IDCANCEL)按钮的用户的选择。

如果 DoModal 返回 IDOK，您可以使用一个CColorDialog的成员函数由用户检索信息输入。

可以使用Windows CommDlgExtendedError 函数确定错误是否在对话框的初始化时生成并了解有关该错误。

CColorDialog 依赖于随Windows 3.1版和更高版本的COMMDLG.DLL文件。

若要自定义对话框，从 CColorDialog派生选件类，提供了一个自定义对话框模板，并将消息映射处理从扩展控件的通知消息。应通过任何未处理的消息路由到基类。

挂钩函数不需要自定义。

说明
在这些安装，如果使用框架进行其他 CDialog 对象灰色，CColorDialog 对象不会显示与具有灰色背景。

有关使用 CColorDialog的更多信息，请参见用于通用对话框选件类

继承层次结构

CColorDialog

要求

Header: afxdlgs.h

请参见

参考

CCommonDialog选件类

层次结构图

概念

MFC示例DRAWCLI