1.数据成员
CColorDialog::m_cc
CHOOSECOLOR m_cc;
用于的结构自定义对话框的设置。
备注
示例
// The code below uses CColorDialog::m_cc data member to
// customize the settings of CColorDialog. The CColorDialog will
// be shown as full open and with red as the selected color.
CColorDialog dlg;
dlg.m_cc.Flags |= CC_FULLOPEN | CC_RGBINIT;
dlg.m_cc.rgbResult = RGB(255, 0, 0);
dlg.DoModal();
2.构造函数
CColorDialog::CColorDialog
CColorDialog( COLORREF
clrInit
= 0, DWORD
dwFlags
= 0, CWnd*
pParentWnd
= NULL );
构造 CColorDialog 对象。
参数
-
lrInit 默认颜色选择。 如果未指定任何值，则默认值为RGB (0,0,0) (黑色）。
-
dwFlags 自定义对话框的功能和外观的设置标志。 有关更多信息，请参见 Windows SDK的 CHOOSECOLOR 结构。
-
pParentWnd 指针到对话框的父级或所有者窗口。
示例
// Show the Color dialog with all the default settings.
CColorDialog dlg1;
dlg1.DoModal();
// Show the fully opened Color dialog with red as the selected color.
CColorDialog dlg2(RGB(255, 0, 0), CC_FULLOPEN);
dlg2.DoModal();
3.操作函数
1 、CColorDialog::DoModal
virtual int DoModal( );
显示颜色对话框以及允许用户进行选择。
返回值
IDOK
或
IDCANCEL。 如果
IDCANCEL
返回，则调用Windows
CommDlgExtendedError
函数确定是否发生了错误。
IDOK
和
IDCANCEL
是指示的常数用户是否选择了"或"取消"按钮。
备注
如果要通过设置 m_cc 结构的成员初始化各种颜色对话框选项，则应在调用
DoModal
之前执行此操作，但在对话框中，构造对象之后。
2、CColorDialog::GetColor
COLORREF GetColor( ) const;
返回包含选定颜色的值
COLORREF
结构。
返回值
示例
/ Get the selected color from the CColorDialog.
CColorDialog dlg;
if (dlg.DoModal() == IDOK)
{
COLORREF color = dlg.GetColor();
TRACE(_T("RGB value of the selected color - red = %u, ")
_T("green = %u, blue = %u\n"),
GetRValue(color), GetGValue(color), GetBValue(color));
}
3、CColorDialog::GetSavedCustomColors
static COLORREF * GetSavedCustomColors( );
检索用户创建的自定义颜色。
返回值
若要存储自定义颜色的指针16个RGB颜色值由用户创建的。
备注
在返回的数组的16个RGB每个值都初始化为RGB (255,255,255) (白色）。 用户选择的自定义颜色仅保存在应用程序中的对话框调用之间。 如果希望保存在应用程序调用之间的这两种颜色，必须将它们以某种其他方式，例如初始化(.INI)文件。
示例
// Get a pointer to an array of 16 RGB color values that stores
// custom colors created by the user from CColorDialog.
CColorDialog dlg;
if (dlg.DoModal() == IDOK)
{
COLORREF* ccolor = dlg.GetSavedCustomColors();
for (int i=0; i < 16; i++)
{
TRACE(_T("RGB value of the selected color - red = %u, ")
_T("green = %u, blue = %u\n"),
GetRValue(ccolor[i]),
GetGValue(ccolor[i]),
GetBValue(ccolor[i]));
}
}
4、CColorDialog::SetCurrentColor
void SetCurrentColor( COLORREF
clr
);
强制当前颜色选择到指定的颜色。
参数
-
clr RGB颜色值。
备注
此功能称为从消息处理程序或 OnColorOK的内部。 对话框将自动更新基于 clr 参数值的用户的选择。
4.属性
CColorDialog::OnColorOK
virtual BOOL OnColorOK( );
验证颜色的重写联接对话框。
返回值
非零，如果对话框不应关闭;否则接受输入颜色为0。
备注
重写此函数，只有在要为用户提供在颜色对话框中选择颜色的自定义验证。
用户可以通过以下两种方法之一选择颜色:
- 单击颜色调色板上，选定颜色
- 在编辑框中输入RGB值
通常，不需要使用此功能，因为框架提供颜色的默认验证并显示消息框，如果一个无效的颜色进行编码。
可以调用 SetCurrentColor 从
OnColorOK
强制颜色选择。 在
OnColorOK
会激发时(即用户单击接受颜色更改的 好 )，则可以调用
GetColor
获取新颜色的RGB值。
示例
// Override OnColorOK to validate the color entered to the
// Red, Green, and Blue edit controls. If the color
// is BLACK (i.e. RGB(0, 0,0)), then force the current color
// selection to be the color initially selected when the
// dialog box is created. The color dialog won't close so
// user can enter a new color.
BOOL CMyColorDlg::OnColorOK()
{
// Value in Red edit control.
COLORREF clrref = GetColor();
if (RGB(0, 0, 0) == clrref)
{
AfxMessageBox(_T("BLACK is not an acceptable color. ")
_T("Please enter a color again"));
// GetColor() returns initially selected color.
SetCurrentColor(GetColor());
// Won't dismiss color dialog.
return TRUE;
}
// OK to dismiss color dialog.
return FALSE;
}
5.备注
CColorDialog
对象是具有用于显示系统定义颜色的列表的对话框。 当对话框退出时，用户可以从列表中选择或创建特殊颜色，然后报告回应用程序。
构造一个CColorDialog对象可以使用类中的
构造函数，也可以从类CColorDialog派生一个子类，然后定义自己的构造函数。
在构造了CColorDialog对象后，可以设置或者修改m_cc结构中的任一个值以初始化对话框控件的值。m_cc是一个CHOOSECOLOR类型的结构。
初始化对话框控件之后，就可以调用成员函数DoModal来显示对话框并允许用户选择颜色了。DoModal返回用户对按钮OK或Cancel的选择（返回值依次为IDOK，IDCANCEL）。
如果DoModal返回了IDOK，则可以调用CColorDialog的一个成员函数来检索用户选择的颜色信息。
可以使用Windows函数CommDlgExtendedError来检测对话框初始化时是否发生了错误，并取得错误的相关信息。
类CColorDialog需要使用Windows3.1或更高版本提供的COMMDLG.DLL文件。
定制对话框，可以从CColorDialog派生一个子类，提供一个定制的对话框模板，并增加一个消息映射来处理扩展的控件发来的通知。所有悬挂的消息将被送到
基类。
不需要定制
钩子函数。
注意：
在某些版本中，如果在
框架中使其它的CDialog对象变灰色，CColorDialog对象将不会以灰色背景显示。
所需头文件：#include <afxdlgs.h>
[