Visio) (Shape.GetFormulasU 方法

會傳回很多儲存格的公式。

語法

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

expression 一個用於表示 Shape 物件的變數。

參數

名稱 必要/選用 資料類型 描述
SRCStream () 必要 整數 會識別要查詢之儲存格的資料流。
formulaArray () 必要 Variant 輸出參數。 會接收查詢儲存格公式的陣列。

傳回值

無

註解

GetFormulasU 方法就像 Cell 物件的 FormulaU 屬性,但您可以使用這個方法一次取得很多儲存格的公式,而不是一次取得一個儲存格的公式。 GetFormulasU 方法是 GetResults 方法的特殊化,可以用來取得儲存格公式或結果。 設定呼叫 GetFormulasU 方法所涉及的工作比設定 GetResults 方法所涉及的工作稍微少一些。

使用 GetFormulasU 方法獲取任意儲存格集的公式。

SRCStream () 是 2 位元組整數的陣列。 針對 Shape 物件,對於某些 n>= 1,SRCStream () 應該是 3 個 2 位元組整數的一維陣列。 GetFormulasU 會將串流解譯為:

{sectionIdx, rowIdx, cellIdx}n

其中 sectionIdx 是所要儲存格的區段索引,rowIdx 是它的資料列索引,而 cellIdx 則是它的儲存格索引。

如果 GetFormulasU 方法成功, formulaArray () 會傳回 n 個變體的一維陣列,並編製從 0 到 n - 1 的索引。 每個變體都會以字串的形式傳回公式。 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 支援與意見反應。