OLEUIINSERTOBJECTW 结构 (oledlg.h)

项目
08/25/2023

包含 OLE 用户界面库用于初始化“ 插入对象 ”对话框的信息，以及关闭对话框时库返回信息的空间。

语法

typedef struct tagOLEUIINSERTOBJECTW {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCWSTR         lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCWSTR         lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPWSTR          lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTW, *POLEUIINSERTOBJECTW, *LPOLEUIINSERTOBJECTW;

成员

cbStruct

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

dwFlags

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

值	含义
IOF_SHOWHELP	对话框将显示“ 帮助” 按钮。
IOF_SELECTCREATENEW	最初将选中“ 新建” 单选按钮。这不能与 IOF_SELECTCREATEFROMFILE 一起使用。
IOF_SELECTCREATEFROMFILE	最初将选中“ 从文件创建 ”单选按钮。这不能与IOF_SELECTCREATENEW一起使用。
IOF_CHECKLINK	最初将选中“链接检查”框。
IOF_CHECKDISPLAYASICON	最初将选中“显示为图标检查”框，显示当前图标，并启用“更改图标”按钮。
IOF_CREATENEWOBJECT	当用户选择 “确定” 以关闭对话框并选中“ 新建” 单选按钮时，应创建一个新对象。
IOF_CREATEFILEOBJECT	当用户选择 “确定” 以关闭对话框并选中“ 从文件创建 ”单选按钮时，应从指定文件创建新对象。
IOF_CREATELINKOBJECT	当用户选择“确定”以关闭对话框，并且用户选中“链接检查”框时，应创建新的链接对象。
IOF_DISABLELINK	初始化时将禁用“链接检查”框。
IOF_VERIFYSERVERSEXIST	对话框应通过确保注册数据库中指定的服务器存在来验证它添加到列表框的类。这是一个重要的性能因素。
IOF_DISABLEDISPLAYASICON	初始化时将禁用“显示为图标检查框。
IOF_HIDECHANGEICON	“ 更改图标 ”按钮将隐藏在“ 插入对象 ”对话框中。
IOF_SHOWINSERTCONTROL	显示“ 插入控件” 单选按钮。
IOF_SELECTCREATECONTROL	显示“ 创建控件” 单选按钮。

hWndOwner

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

lpszCaption

指向要用作对话框标题的字符串的指针。如果 为 NULL，则库使用 Insert 对象。

lpfnHook

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

lCustData

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

hInstance

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

lpszTemplate

指向以 null 结尾的字符串的指针，该字符串指定要替换库的 “插入对象 ”对话框模板的对话框模板的资源文件的名称。

hResource

自定义模板句柄。

clsid

要插入的对象的类的 CLSID。输出时填充。

lpszFile

指向要链接或嵌入的文件的名称的指针。输出时填充。

cchFile

lpszFile 缓冲区的大小;不会超过 MAX_PATH。

cClsidExclude

lpClsidExclude 列表中包含的 CLSID 数。输入时填充。

lpClsidExclude

指向要从列表中排除的 CLSID 列表的指针。

iid

所请求接口的标识符。如果 OleUIInsertObject 创建对象，则它将返回指向此接口的指针。如果 OleUIInsertObject 不创建对象，则忽略此参数。

oleRender

呈现选项。如果 OleUIInsertObject 创建对象，则会在创建对象时选择呈现选项。如果 OleUIInsertObject 不创建对象，则忽略此参数。

lpFormatEtc

所需格式。如果 OleUIInsertObject 创建对象，则会在创建对象时选择格式。如果 OleUIInsertObject 不创建对象，则忽略此参数。

lpIOleClientSite

指向要用于对象的客户端站点的指针。如果 OleUIInsertObject 不创建对象，则忽略此参数。

lpIStorage

指向要用于对象的存储的指针。如果 OleUIInsertObject 不创建对象，则忽略此参数。

ppvObj

包含所插入对象的接口指针的输出指针变量的地址。如果 OleUIInsertObject 不创建对象，则忽略此参数。

sc

创建调用的结果。如果 OleUIInsertObject 不创建对象，则忽略此参数。

hMetaPict

包含图标方面的 MetafilePict 结构（如果它未放置在对象的缓存中）。

注解

注意

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

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	oledlg.h

另请参阅

OleUIInsertObject

通过

OLEUIINSERTOBJECTW 结构 (oledlg.h)

语法

成员

注解

要求

另请参阅

反馈

其他资源