GetFormulasU メソッド (Visio)Shape.GetFormulasU method (Visio)

複数のセルの数式を返します。Returns the formulas of many cells.

構文Syntax

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

Shape オブジェクトを表す変数を取得します。expression A variable that represents a Shape object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
SRCStream ()SRCStream() 必須Required 整数型 (Integer)Integer 問い合わせるセルを識別するストリームです。A stream identifying cells to be queried.
formulaArray ()formulaArray() 必須Required VariantVariant 出力パラメーターです。Out parameter. 問い合わせたセルの数式を受け取る配列です。An array that receives formulas of queried cells.

戻り値Return value

なしNothing

解説Remarks

GetFormulasUメソッドは、 CellオブジェクトのFormulaUプロパティに似ていますが、一度に1つのセルではなく、複数のセルの数式を取得するために使用することができます。The GetFormulasU method is like the FormulaU property of a Cell object, except you can use it to obtain the formulas of many cells at once rather than one cell at a time. GetFormulasU メソッドは、GetResults メソッドの特殊な形式であり、セルの数式または結果を取得する場合に使用します。The GetFormulasU method is a specialization of the GetResults method, which can be used to obtain cell formulas or results. GetFormulasU メソッドの呼び出しの設定は、GetResults メソッドの設定よりも手順が若干少なくなっています。Setting up a call to the GetFormulasU method involves slightly less work than setting up the GetResults method.

GetFormulasUメソッドを使用すると、任意のセル集合の数式を取得できます。You can use the GetFormulasU method to get formulas of any set of cells.

SRCStream() は 2 バイトの整数で構成される配列です。SRCStream() is an array of 2-byte integers. Shapeオブジェクトの場合、 srcstream () は、 n >= 1 の 3 n 2 バイト整数の1次元配列である必要があります。For Shape objects, SRCStream() should be a one-dimensional array of 3 n 2-byte integers for some n >= 1. GetFormulasU はストリームを次のように解釈します。GetFormulasU interprets the stream as:

{sectionIdx, rowIdx, cellIdx}n

_Sectionidx_は目的セルのセクションインデックス、 _rowIdx_は行インデックス、 _cellidx_はセルのインデックスです。where sectionIdx is the section index of the desired cell, rowIdx is its row index and cellIdx is its cell index.

GetFormulasUメソッドが成功した場合、 formulaArray () は、0から_n_ -1 のインデックスが付けられた_n 個_のバリアントの1次元配列を返します。If the GetFormulasU method succeeds, formulaArray() returns a one-dimensional array of n variants indexed from 0 to n - 1. 各バリアント値は数式を文字列として返します。Each variant returns a formula as a string. formulaArray() は、GetFormulasU メソッドによって割り当てられる出力パラメーターであり、呼び出し側に所有権が戻されます。formulaArray() is an out parameter that is allocated by the GetFormulasU method, which passes ownership back to the caller. 最終的には、呼び出し側は、返された配列に対して SafeArrayDestroy プロシージャを実行する必要があります。The caller should eventually perform the SafeArrayDestroy procedure on the returned array. SafeArrayDestroyプロシージャには、配列のエントリによって参照されるバリアントをクリアするという副作用があるため、 GetFormulasメソッドから返される文字列は解放されます。Note that the SafeArrayDestroy procedure has the side effect of clearing the variants referenced by the array's entries, hence deallocating any strings the GetFormulas method returns. (Microsoft Visual Basic と Visual Basic for Applications では、このことを考慮してください)。FormulaArray ()Nullの場合、 GetFormulasUメソッドは失敗します。(Microsoft Visual Basic and Visual Basic for Applications take care of this for you.) The GetFormulasU method fails if formulaArray() is Null.

注意

Microsoft Visio 2000 以降では、ローカル名と汎用名の両方を使用して、Visio 図形、マスターシェイプ、ドキュメント、ページ、行、アドオン、セル、ハイパーリンク、スタイル、フォント、マスターショートカット、UI オブジェクト、およびレイヤーを参照することができます。Beginning with Microsoft Visio 2000, you can use both local and universal names to refer to Visio shapes, masters, documents, pages, rows, add-ons, cells, hyperlinks, styles, fonts, master shortcuts, UI objects, and layers. ユーザーが図形に名前を指定した場合 (たとえば、ユーザーがローカル名を指定している場合など)。When a user names a shape, for example, the user is specifying a local name. Microsoft Office Visio 2003 以降、シェイプシートでは、セルの数式と値に汎用名だけが表示されます。Beginning with Microsoft Office Visio 2003, the ShapeSheet spreadsheet displays only universal names in cell formulas and values. (以前のバージョンでは、ユーザーインターフェイスに汎用名が表示されていませんでした)。(In prior versions, universal names were not visible in the user interface.)

汎用名をプログラム内で使用すると、ソリューションをローカライズするたびに名前を変更する必要がなくなります。As a developer, you can use universal names in a program when you don't want to change a name each time a solution is localized. ローカル構文を使用しているときに複数の数式を取得するには、 GetFormulasメソッドを使用します。Use the GetFormulas method to get more than one formula when you are using local syntax. 汎用構文を使用して図形を識別する場合に複数の図形を取得するには GetFormulasU メソッドを使用します。Use the GetFormulasU method to get more than one formula when you are using universal syntax.

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.