SPREAD for Windows Formsでは、スプレッドシートでの外部変数の作成と使用がサポートされます。

外部変数は、記号によって定義される論理セルです。外部変数の名前は、大文字と小文字が区別されます。外部変数はセルコンテキストを処理せず、通常のセルより明確に評価されます。

• 数式内で、外部変数への参照においてワークシートへの参照が欠落している場合は、この参照ではアクティブシートが参照されます。
• 外部変数を使用する式では、常に絶対参照を使用して評価されます。外部参照を使用する数式に相対参照を使用すると、この相対参照は、数式の評価時に絶対参照に変換されます。
• 外部変数を使用する数式の評価結果が、範囲参照となる場合があります。このような場合は、この外部変数を配列数式で使用できます。このような数式が単一セルに対して評価される場合は、結果がプリミティブ値となる必要があり、セル範囲の左上のセルの値がコンテキストセルとして使用されます。このセル値が、評価結果として返されます。
• 外部変数では、ExternalVariableから継承したクラスインスタンスを指定できます。これにより、アプリケーションにおいて、外部オブジェクトを計算エンジンにバインドするためのカスタムロジックを実装できます。ExternalVariableからの継承方法を示す詳しいサンプルコードについては、「外部変数のテキストボックスコントロールでの使用」を参照してください。

INamesインタフェースのAddExternalVariableメソッドを使用すると、外部変数をワークブックに追加できます。このメソッドを使用する場合は、外部変数の名前、およびこの変数の数式または値を指定する必要があります。

コードの使用

外部変数を定義するには、ワークブックのAddExternalVariableメソッドを使用します。

サンプルコード

次のサンプルコードは、2つの外部変数「x」、「y」を作成し、ワークブックの特定のワークシート内で定義された数式で使用します。

// ワークブックに新規シートを追加します。
FarPoint.Win.Spread.SheetView newsheet = new FarPoint.Win.Spread.SheetView();
fpSpread1.Sheets.Add(newsheet);
fpSpread1.AllowUserFormulas = true;

// アクティブシートのA1セルおよびA2セルに値を設定します。
fpSpread1.ActiveSheet.Cells[0, 0].Value = "Hello";
fpSpread1.ActiveSheet.Cells[1, 0].Value = "World!";

// ワークブックに、これらのセル値を参照する外部変数を追加します。
fpSpread1.AsWorkbook().Names.AddExternalVariable("x", "Sheet1!A1");
fpSpread1.AsWorkbook().Names.AddExternalVariable("y", "Sheet1!A2");

// この外部変数を別のセル内で使用します。
fpSpread1.AsWorkbook().Worksheets[1].Cells["B1"].Formula = "\"The concat name is \" & x & y";

' ワークブックに新規シートを追加します。
Dim newsheet As FarPoint.Win.Spread.SheetView = New FarPoint.Win.Spread.SheetView()
fpSpread1.Sheets.Add(newsheet)
fpSpread1.AllowUserFormulas = true

' アクティブシートのA1セルおよびA2セルに値を設定します。
fpSpread1.ActiveSheet.Cells(0, 0).Value = "Hello"
fpSpread1.ActiveSheet.Cells(1, 0).Value = "World!"

' ワークブックに、これらのセル値を参照する外部変数を追加します。
fpSpread1.AsWorkbook().Names.AddExternalVariable("x", "Sheet1!A1")
fpSpread1.AsWorkbook().Names.AddExternalVariable("y", "Sheet1!A2")

' この外部変数を別のセル内で使用します。
fpSpread1.AsWorkbook().Worksheets(1).Cells("B1").Formula = """The concat name is "" & x & y"

© MESCIUS inc. All rights reserved.