Visio) (DataRecordset.LinkReplaceBehavior 属性

获取或设置在调用将形状链接到数据的方法时处理形状和数据行之间的现有链接的方式。 读/写。

注意

此 Visio 对象或成员仅供 Visio Professional 2013 的授权用户使用。

语法

表达式。LinkReplaceBehavior

表达式 返回 DataRecordset 对象的表达式。

返回值

VisLinkReplaceBehavior

备注

以下链接替换行为常量由 VisLinkReplaceBehavior 中的 Visio 类型库声明:

常量 值 说明
visLinkReplaceAlways 1 在链接到具有现有链接的形状时始终替换链接
visLinkReplaceNever 0 在链接到具有现有链接的形状时从不替换链接
visLinkReplacePrompt 2 当用户尝试在 Visio 用户界面 (UI) 中创建链接时,替换链接之前提示用户。

这些选项对应于与“外部数据”窗口中的数据记录集相对应的选项卡的“属性”对话框中可用的选项。 (在“ 外部数据” 窗口中,在数据记录集的选项卡上,右键单击,指向“ 数据源”,然后单击“ 属性”。)

受此属性设置影响的方法包括 Selection.LinkToData、 Shape.LinkToData 和 Selection.AutomaticLink。

在 UI 中,当用户试图链接到具有现有数据链接的数据形状且设置是 visLinkReplacePrompt 时,Visio 会以打开一个对话框的方式进行响应,以通知用户:他们的操作将断开现有链接,并询问他们是否继续。 由于打开对话框不是对方法调用的正确响应,因此,当您通过调用这些方法中的任何一个来链接形状时,Visio 会将 visLinkReplacePrompt 设置视为 visLinkReplaceAlways。 也就是说,这两种设置的不同之处在于它们影响 UI 中的行为,但不同于编程行为。 默认情况下,在以编程方式执行链接时,始终会替换现有链接,但在 UI 中执行链接时,则会进行提示。

将 LinkReplaceBehavior 设置为 visLinkReplaceNever 时,会同时禁用 LinkToData 方法,对它们的调用将失败。

LinkReplaceBehavior 设置还会影响 Visio UI 中“自动链接”向导的第二个屏幕上“替换现有检查链接”框的默认设置, (在“数据”选项卡上,单击“自动链接) ”。 如果将 LinkReplaceBehavior 设置为 visLinkReplaceAlways 或 visLinkReplacePrompt,则默认情况下选中此框。 如果将 LinkReplaceBehavior 属性设置为 visLinkReplaceNever,则默认情况下清除该复选框。 用户可以通过选中或清除检查框来更改向导的默认行为。

此外, LinkReplaceBehavior 设置确定 Selection.AutomaticLink 方法的工作方式。 与 LinkToData 方法一样,当 LinkReplaceBehavior 设置为 visLinkReplaceAlways 或 visLinkReplacePrompt 时, AutomaticLink 将替换现有链接。 而当 LinkReplaceBehavior 设置为 visLinkReplaceNever 时, AutomaticLink 不会替换现有链接。

不过,LinkToData 方法和 AutomaticLink 方法之间的差异在于,对于 AutomaticLink,您可以覆盖 LinkReplaceBehavior 设置,方法是将 visAutoLinkReplaceExistingLinks 或 visAutoLinkDontReplaceExistingLinks 常量作为 AutoLinkBehavior 参数从 VisAutoLinkBehaviors 枚举传递到方法。

因此,假如将 LinkReplaceBehavior 设置为 visLinkReplaceNever,则可以指定 AutomaticLink 仍会替换现有的链接(通过将 visAutoLinkReplaceExistingLinks 传递到它)。

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。