OLEUICHANGESOURCEA 结构 (oledlg.h)

  • 项目

包含用于初始化标准 “更改源 ”对话框的信息。 它允许用户修改链接的目标或源。 这可能只需要为链接选择不同的文件名，或者可能更改文件中的项目引用，例如，更改链接要指向的电子表格中单元格的目标区域。

语法

typedef struct tagOLEUICHANGESOURCEA {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCSTR                lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCSTR                lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEA         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERA lpOleUILinkContainer;
  DWORD                 dwLink;
  LPSTR                 lpszDisplayName;
  ULONG                 nFileLength;
  LPSTR                 lpszFrom;
  LPSTR                 lpszTo;
} OLEUICHANGESOURCEA, *POLEUICHANGESOURCEA, *LPOLEUICHANGESOURCEA;

成员

cbStruct

结构大小（以字节为单位）。

dwFlags

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

值 含义
CSF_SHOWHELP
 启用或显示“帮助”按钮。
CSF_VALIDSOURCE
 指示链接已验证。
CSF_ONLYGETSOURCE
 当用户按 “确定”时，禁用链接源的自动验证。 如果指定此标志，则应在对话框返回 “确定”时验证源。

hWndOwner

拥有对话框的窗口。

lpszCaption

指向要用作对话框标题的字符串的指针。 如果 为 NULL，则库使用 “更改源”。

lpfnHook

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

lCustData

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

hInstance

包含 由 lpszTemplate 成员指定的对话框模板的实例。 如果 lpszTemplate 成员为 NULL 或无效，则忽略此成员。

lpszTemplate

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

hResource

自定义对话框的资源句柄。 如果此成员为 NULL，则库使用标准“ 转换 ”对话框模板;如果有效，则使用 由 lpszTemplate 成员命名的模板。

lpOFN

指向 OPENFILENAME 结构的指针，该结构包含操作系统用来初始化系统定义的 “打开 ”或“ 另存为 ”对话框的信息。

dwReserved1[4]

此成员是保留的。

lpOleUILinkContainer

指向容器实现的 IOleUILinkContainer 接口的指针，该接口用于验证链接源。 “ 编辑链接 ”对话框使用此对话框允许容器操作其链接。

dwLink

用于验证链接源的容器定义的唯一链接标识符。 由 lpOleUILinkContainer 使用。

lpszDisplayName

指向完整源显示名称的指针。

nFileLength

lpszDisplayName 的文件名字对象部分。

lpszFrom

指向从中更改的源前缀的指针。

lpszTo

指向要更改为的源前缀的指针。

注解

注意

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

要求

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

另请参阅

IOleUILinkContainer

OleUIChangeSource