OLEUICONVERTW 结构 (oledlg.h)
包含 OLE 用户界面库用来初始化 转换 对话框的信息,以及库在关闭对话框时返回信息的空间。
语法
typedef struct tagOLEUICONVERTW {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCWSTR lpszTemplate;
HRSRC hResource;
CLSID clsid;
CLSID clsidConvertDefault;
CLSID clsidActivateDefault;
CLSID clsidNew;
DWORD dvAspect;
WORD wFormat;
BOOL fIsLinkedObject;
HGLOBAL hMetaPict;
LPWSTR lpszUserType;
BOOL fObjectsIconChanged;
LPWSTR lpszDefLabel;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
} OLEUICONVERTW, *POLEUICONVERTW, *LPOLEUICONVERTW;
成员
cbStruct
结构的大小(以字节为单位)。 必须在输入中填充此成员。
dwFlags
在输入时,此字段指定初始化和创建标志。 退出时,它指定用户的选择。 它可能是以下标志的组合。
hWndOwner
拥有对话框的窗口。 此成员不应 NULL。
lpszCaption
指向要用作对话框标题的字符串的指针。 如果 NULL,则库将使用 转换。
lpfnHook
指向处理用于对话框的消息的挂钩函数的指针。 挂钩函数必须返回零,才能将未处理的消息传递回库中的对话框过程。 挂钩函数必须返回非零值,以防止库的对话框过程处理已处理的消息。
lCustData
库传递给由 lpfnHook 成员指向的挂钩函数的应用程序定义数据。 该库在WM_INITDIALOG消息的 lParam 参数中传递指向 OLEUICONVERT 结构的指针;此指针可用于检索 lCustData 成员。
hInstance
包含由 lpszTemplate 成员指定的对话框模板的实例。 如果 lpszTemplate 成员 NULL 或无效,则忽略此成员。
lpszTemplate
指向以 null 结尾的字符串的指针,该字符串指定要替换为库 转换 对话框模板的对话框模板的资源文件的名称。
hResource
自定义对话框的资源句柄。 如果此成员 NULL,则库将使用标准 转换 对话框模板,或者如果该模板有效,则由 lpszTemplate 成员命名的模板。
clsid
要转换或激活的对象 CLSID。 此成员是在输入上设置的。
clsidConvertDefault
选中 转换为 时用作默认类的 CLSID。 如果 dwFlags 成员不包含CF_SETCONVERTDEFAULT,则忽略此成员。 此成员是在输入上设置的。
clsidActivateDefault
选中 激活为 时用作默认类的 CLSID。 如果 dwFlags 成员不包含CF_SETACTIVATEDEFAULT,则忽略此成员。 此成员是在输入上设置的。
clsidNew
所选类的 CLSID。 此成员在输出上设置。
dvAspect
对象的方面。 这必须是DVASPECT_CONTENT或DVASPECT_ICON。 如果在输入时DVASPECT_ICON dvAspect,则选中 显示为图标 框,并显示对象的图标。 此成员在输入和输出上设置。 有关详细信息,请参阅 DVASPECT。
wFormat
要转换或激活的对象的数据格式。
fIsLinkedObject
如果对象已链接,则 TRUE。 此成员是在输入上设置的。
hMetaPict
METAFILEPICT 包含标志性方面。 此成员在输入和输出上设置。
lpszUserType
指向要转换或激活的对象的用户类型名称的指针。 如果此值 NULL,则对话框将从注册表中检索用户类型名称。 此字符串在退出时释放。
fObjectsIconChanged
如果对象的图标更改,TRUE。 (即,如果 OleUIChangeIcon 被调用且未取消)。 此成员在输出上设置。
lpszDefLabel
指向用于图标的默认标签的指针。 如果 NULL,将使用短用户类型名称。 如果对象是链接,则调用方应传递链接源的显示名称。 这在退出时释放。
cClsidExclude
lpClsidExclude中的 CLSID 数。
lpClsidExclude
指向要从列表中排除的 CLSID 列表的指针。
言论
注意
oledlg.h 标头将 OLEUICONVERT 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
标头 | oledlg.h |