通过

OLEUIINSERTOBJECTW 结构 （oledlg.h）

  • 项目

包含 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

包含标志性方面的图元文件Pict 结构（如果未放置在对象的缓存中）。

言论

注意

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

要求

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

另请参阅

OleUIInsertObject