OLEUICONVERTA 结构 (oledlg.h)

项目
03/01/2024

包含 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，则库使用 Convert。

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 在输入时DVASPECT_ICON，则选中“ 显示为图标 ”框并显示对象的图标。此成员在输入和输出上设置。有关详细信息，请参阅 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

通过

OLEUICONVERTA 结构 (oledlg.h)

语法

成员

注解

要求

另请参阅

反馈

其他资源