COleUpdateDialog 类
用于 OLE“编辑链接”对话框的特例,当你只需要更新文档中现有的链接对象或嵌入对象时才可使用。
语法
class COleUpdateDialog : public COleLinksDialog
成员
公共构造函数
名称 | 描述 |
---|---|
COleUpdateDialog::COleUpdateDialog | 构造 COleUpdateDialog 对象。 |
公共方法
名称 | 描述 |
---|---|
COleUpdateDialog::DoModal | 在更新模式下显示“编辑链接”对话框。 |
备注
有关特定于 OLE 对话框的详细信息,请参阅文章 OLE 中的对话框。
继承层次结构
COleUpdateDialog
要求
标头:afxodlgs.h
COleUpdateDialog::COleUpdateDialog
构造 COleUpdateDialog
对象。
explicit COleUpdateDialog(
COleDocument* pDoc,
BOOL bUpdateLinks = TRUE,
BOOL bUpdateEmbeddings = FALSE,
CWnd* pParentWnd = NULL);
参数
pDoc
指向包含可能需要更新的链接的文档。
bUpdateLinks
确定是否要更新链接对象的标志。
bUpdateEmbeddings
确定是否要更新嵌入对象的标志。
pParentWnd
指向对话框对象所属的父窗口对象或所有者窗口对象(CWnd
类型)。 如果为 NULL,对话框的父窗口将设置为主应用程序窗口。
备注
此函数仅构造一个 COleUpdateDialog
对象。 要显示对话框,请调用 DoModal。 只想更新现有的链接项或嵌入项时,应使用此类而不是 COleLinksDialog
。
COleUpdateDialog::DoModal
在更新模式下显示“编辑链接”对话框。
virtual INT_PTR DoModal();
返回值
对话框的完成状态。 以下值之一:
IDOK(如果对话框已返回成功)。
IDCANCEL(如果当前文档中没有链接或嵌入的项需要更新)。
如果发生错误,为 IDABORT。 如果返回 IDABORT,请调用 COleDialog::GetLastError 成员函数以获取有关所发生错误类型的详细信息。 有关可能的错误列表,请参阅 Windows SDK 中的 OleUIEditLinks 函数。
备注
除非用户选择“取消”按钮,否则将更新所有链接和/或嵌入。