OLEUICHANGEICONW 结构 （oledlg.h）

包含 OLE 用户界面库用于初始化 更改图标 对话框的信息，并且它包含库在关闭对话框时返回信息的空间。

语法

typedef struct tagOLEUICHANGEICONW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  WCHAR         szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONW, *POLEUICHANGEICONW, *LPOLEUICHANGEICONW;

成员

cbStruct

结构的大小（以字节为单位）。 必须在输入中填充此字段。

dwFlags

在输入时，指定初始化和创建标志。 退出时，它指定用户的选择。 它可以是以下标志的组合。

价值	意义
CIF_SHOWHELP	对话框将显示“帮助”按钮 。
CIF_SELECTCURRENT	在输入时，选择初始化时 当前 单选按钮。 退出时，指定用户选择 当前。
CIF_SELECTDEFAULT	在输入时，选择初始化时 默认 单选按钮。 退出时，指定用户选择 默认。
CIF_SELECTFROMFILE	在输入时，选择初始化时从文件 单选按钮 。 退出时，指定用户从文件中选择了 。
CIF_USEICONEXE	仅输入。 从 szIconExe 成员中指定的可执行文件中提取图标，而不是从类中检索它。 这对于 OLE 嵌入或链接到非 OLE 文件非常有用。

hWndOwner

拥有对话框的窗口。 此成员不应 NULL。

lpszCaption

指向要用作对话框标题的字符串的指针。 如果 NULL，则库将使用 更改图标。

lpfnHook

指向处理用于对话框的消息的挂钩函数的指针。 挂钩函数必须返回零，才能将未处理的消息传递回库中的对话框过程。 挂钩函数必须返回非零值，以防止库的对话框过程处理已处理的消息。

lCustData

库传递给由 lpfnHook 成员指向的挂钩函数的应用程序定义数据。 该库在 WM_INITDIALOG 消息的 lParam 参数中传递指向 OLEUICHANGEICON 结构的指针;此指针可用于检索 lCustData 成员。

hInstance

包含由 lpTemplateName 成员指定的对话框模板的实例。

lpszTemplate

指向以 null 结尾的字符串的指针，该字符串指定要替换为库的 更改图标 对话框模板的资源文件的名称。

hResource

自定义模板句柄。

hMetaPict

当前图像和最终图像。 图标的源嵌入在图元文件本身中。

clsid

仅输入。 用于获取 默认 图标的类。

szIconExe[MAX_PATH]

仅输入。 指向要从中提取默认图标的可执行文件的指针。 除非 dwFlags 成员中包含CIF_USEICONEXE，并且尝试从指定的 CLSID 检索类图标失败，否则将忽略此成员。

cchIconExe

仅输入。 szIconExe中的字符数。 除非 dwFlags 成员中包含CIF_USEICONEXE，否则将忽略此成员。

言论

注意

oledlg.h 标头将 OLEUICHANGEICON 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求	价值
最低支持的客户端	Windows 10 内部版本 20348
支持的最低服务器	Windows 10 内部版本 20348
标头	oledlg.h