通过

OLEUICHANGESOURCEW 结构 （oledlg.h）

  • 项目

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

语法

typedef struct tagOLEUICHANGESOURCEW {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCWSTR               lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCWSTR               lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEW         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERW lpOleUILinkContainer;
  DWORD                 dwLink;
  LPWSTR                lpszDisplayName;
  ULONG                 nFileLength;
  LPWSTR                lpszFrom;
  LPWSTR                lpszTo;
} OLEUICHANGESOURCEW, *POLEUICHANGESOURCEW, *LPOLEUICHANGESOURCEW;

成员

cbStruct

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

dwFlags

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

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

hWndOwner

拥有对话框的窗口。

lpszCaption

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

lpfnHook

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

lCustData

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

hInstance

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

lpszTemplate

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

hResource

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

lpOFN

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

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