Shape.GetFormulasU 方法 (Visio)

返回许多单元格的公式。

语法

expression。 GetFormulasU( _SRCStream()_ , _formulaArray()_ )

表达 一个代表 Shape 对象的变量。

参数

名称	必需/可选	数据类型	说明
SRCStream ()	必需	Integer	用于标识要查询的单元格的流。
formulaArray ()	必需	Variant	out 参数。 接收被查询单元格的公式的数组。

返回值

Nothing

注解

GetFormulasU 方法与 Cell 对象的 FormulaU 属性相似，不同之处在于使用此方法可以一次获得许多单元格的公式，而不是一次只能获得一个单元格的公式。 GetFormulasU 方法是 GetResults 方法的一个特例，后者可用来获取单元格公式或结果。 设置对 GetFormulasU 方法的调用比设置 GetResults 方法涉及的工作量略少一些。

使用 GetFormulasU 方法可获取任意一组单元格的公式。

SRCStream() 是一个由 2 字节的整数组成的数组。 对于 Shape 对象，对于某些 n>= 1，SRCStream () 应为 3 n 个 2 字节整数的一维数组。 GetFormulasU 将流解释为：

{sectionIdx, rowIdx, cellIdx}n

其中 sectionIdx 是所需单元格的内容索引，rowIdx 是它的行索引，cellIdx 是它的单元格索引。

如果 GetFormulasU 方法成功，则 formulaArray() 返回索引为 0 到 n - 1 的 n 个变量的一维数组。 每个变量都将公式作为字符串返回。 formulaArray() 是由 GetFormulasU 方法分配的 out 参数，它将所有权传递回调用方。 最后，调用方应对返回的数组执行 SafeArrayDestroy 过程。 请注意，SafeArrayDestroy 过程具有副作用，它会清除由数组项引用的变量，从而释放 GetFormulas 方法返回的任何字符串。 (Microsoft Visual Basic 和 Visual Basic for Applications为你处理此问题。) 如果 formulaArray () 为 Null，GetFormulasU 方法将失败。

注意

从 Microsoft Visio 2000 开始，您可以使用本地名称和通用名称来引用 Visio 形状、主控形状、文档、页面、行、加载项、单元格、超链接、样式、字体、主控形状快捷方式、UI 对象和图层。 例如，当用户命名形状时，用户将指定一个本地名称。 从 Microsoft Office Visio 2003 开始，ShapeSheet 电子表格在单元格公式和值中只显示通用名称。 （在以前的版本中，通用名称在用户界面中不可见。

） 作为开发人员，如果您不希望每次本地化解决方案时都更改名称，可以在程序中使用通用名称。 使用本地语法时，使用 GetFormulas 方法获取多个公式。 使用通用语法时，则使用 GetFormulasU 方法获取多个公式。

支持和反馈

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