OLEUICONVERTA 结构 (oledlg.h)

包含 OLE 用户界面库用来初始化 转换 对话框的信息,以及库在关闭对话框时返回信息的空间。

语法

typedef struct tagOLEUICONVERTA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPSTR         lpszUserType;
  BOOL          fObjectsIconChanged;
  LPSTR         lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTA, *POLEUICONVERTA, *LPOLEUICONVERTA;

成员

cbStruct

结构的大小(以字节为单位)。 必须在输入中填充此成员。

dwFlags

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

价值 意义
CF_SHOWHELPBUTTON
对话框将显示“帮助”按钮 。 此标志在输入上设置。
CF_SETCONVERTDEFAULT
clSID 由 clsidConvertDefault 指定的类将用作默认选择。 选中 转换为 单选按钮时,此选择将显示在类列表框中。 此标志在输入上设置。
CF_SETACTIVATEDEFAULT
clsid 由 clsidActivateDefault 指定的类将用作默认选择。 选中 激活 为单选按钮时,此选择将显示在类列表框中。 此标志在输入上设置。
CF_SELECTCONVERTTO
在输入时,此标志指定 转换为 将最初选择(默认行为)。 如果用户关闭对话框时选择了 转换为,则会在输出上设置此标志。
CF_SELECTACTIVATEAS
在输入时,此标志指定将最初选择“激活为 ”。 如果用户关闭对话框时选择了“激活为,则会在输出上设置此标志。
CF_DISABLEDISPLAYASICON
初始化时将禁用 显示为图标 按钮。
CF_DISABLEACTIVATEAS
初始化时将禁用 激活为 单选按钮。
CF_HIDECHANGEICON
更改图标 按钮将在 “转换”对话框中隐藏。
CF_CONVERTONLY
“转换”对话框中将禁用 激活为 单选按钮。

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

另请参阅

OleUIChangeIcon

OleUIConvert