COleChangeIconDialog 类
用于 OLE“更改图标”对话框。
语法
class COleChangeIconDialog : public COleDialog
成员
公共构造函数
| 名称 | 描述 |
|---|---|
| COleChangeIconDialog::COleChangeIconDialog | 构造 COleChangeIconDialog 对象。 |
公共方法
| 名称 | 描述 |
|---|---|
| COleChangeIconDialog::DoChangeIcon | 执行对话框中指定的更改。 |
| COleChangeIconDialog::DoModal | 显示 OLE 2 更改图标对话框。 |
| COleChangeIconDialog::GetIconicMetafile | 获取与此项的图标形式关联的图元文件的句柄。 |
公共数据成员
| “属性” | 描述 |
|---|---|
| COleChangeIconDialog::m_ci | 控制对话框行为的结构。 |
备注
要调用此对话框时，请创建类 COleChangeIconDialog 的对象。 构造 COleChangeIconDialog 对象后，可以使用 m_ci 结构来初始化对话框中控件的值或状态。 m_ci 结构的类型为 OLEUICHANGEICON。 有关使用此对话框类的详细信息，请参阅 DoModal 成员函数。
有关详细信息，请参阅 Windows SDK 中的 OLEUICHANGEICON 结构。
有关特定于 OLE 对话框的详细信息，请参阅文章 OLE 中的对话框。
继承层次结构
COleChangeIconDialog
要求
标头：afxodlgs.h
COleChangeIconDialog::COleChangeIconDialog
此函数仅构造一个 COleChangeIconDialog 对象。
explicit COleChangeIconDialog(
COleClientItem* pItem,
DWORD dwFlags = CIF_SELECTCURRENT,
CWnd* pParentWnd = NULL);
参数
pItem
指向要转换的项。
dwFlags
创建标志，它包含使用“按位或”运算符组合的以下任意数量的值：
CIF_SELECTCURRENT 指定在调用对话框时，最开始将选择“当前”单选按钮。 这是默认情况。
CIF_SELECTDEFAULT 指定在调用对话框时，最开始将选择“默认”单选按钮。
CIF_SELECTFROMFILE 指定在调用对话框时，最开始将选择“从文件”单选按钮。
CIF_SHOWHELP 指定在调用对话框时，将显示“帮助”按钮。
CIF_USEICONEXE 指定应从 m_ci 的
szIconExe字段中指定的可执行文件中提取图标，而不是从类型中检索图标。 这对于嵌入或链接到非 OLE 文件很有用。
pParentWnd
指向对话框对象所属的父窗口对象或所有者窗口对象（CWnd 类型）。 如果为 NULL，对话框的父窗口将设置为主应用程序窗口。
备注
要显示对话框，请调用 DoModal 函数。
有关详细信息，请参阅 Windows SDK 中的 OLEUICHANGEICON 结构。
COleChangeIconDialog::DoChangeIcon
在 DoModal 返回 IDOK 后，调用此函数可将表示项的图标更改为对话框中选定的图标。
BOOL DoChangeIcon(COleClientItem* pItem);
参数
pItem
指向其图标正在更改的项。
返回值
如果更改成功，则为非零；否则为 0。
COleChangeIconDialog::DoModal
调用此函数以显示 OLE 更改图标对话框。
virtual INT_PTR DoModal();
返回值
对话框的完成状态。 以下值之一：
如果对话框成功显示，为 IDOK。
如果用户取消了对话框，为 IDCANCEL。
如果发生错误，为 IDABORT。 如果返回 IDABORT，请调用
COleDialog::GetLastError成员函数以获取有关所发生错误类型的详细信息。 有关可能错误的列表，请参阅 Windows SDK 中的 OleUIChangeIcon 函数。
备注
如果要通过设置 m_ci 结构的成员来初始化各种对话框控件，则应在调用 DoModal 之前但在构造对话框对象之后执行此操作。
如果 DoModal 返回 IDOK，可以调用其他成员函数来检索用户在对话框中输入的设置或信息。
COleChangeIconDialog::GetIconicMetafile
调用此函数以获取包含所选项的图像方面内容的图元文件的句柄。
HGLOBAL GetIconicMetafile() const;
返回值
包含新图标图像方面内容的图元文件的句柄（如果通过选择“确定”关闭对话框）；否则，显示对话框前的图标。
COleChangeIconDialog::m_ci
用于控制“更改图标”对话框的行为的 OLEUICHANGEICON 类型的结构。
OLEUICHANGEICON m_ci;
备注
此结构的成员可以直接修改，也可以通过成员函数修改。
有关详细信息，请参阅 Windows SDK 中的 OLEUICHANGEICON 结构。