ig.excel.NamedReference

ワークブックで定義された名前付き参照を表します。

備考

名前付き参照によって、名前は複雑な数式またはセル参照の代わりに数式で使用されます。 たとえば、数値 =SUM(E1:E20) を使用する代わりに、'Sales' の名前がある名前付き参照を E1:E20 の範囲にポイントするために定義できます (名前付き参照の数式は以下のように定義されます: =Sheet1!$E$1:$E$20)。次にオリジナルの数式は =SUM(Sales) と表現できます。

それぞれの名前付き参照は関連付けられた範囲を持ち、これは名前付き参照が属する NamedReference.workbook またはワークブックの Worksheet インスタンスのひとつである場合があります。この範囲は、名前が異なるセルの数式でどのように参照される必要があるかを決定します。ワークブックの範囲は、名前付き参照が名前だけで指定したワークブックのセルで数式によってアクセスする必要があることを意味します。 ワークブックの範囲は、他のワークシートで使用される数式が =SUM( Sheet2!Sales ) などのワークシート範囲を最初に指定することで名前を参照する必要があることを意味します。数式が名前付き参照の範囲として同じワークシートにある場合、この数式はワークシート名付きまたはワークシート名なしの名前を参照できます。

外部ワークブックからの名前付き参照は常に、最初に範囲で参照する必要があります。名前付き参照の範囲が外部ワークブックである場合、以下の数式で名前に続くワークブック ファイル名を指定することで名前にアクセスされます: ='C:\ExternalWorkbook.xls'!SalesTax。名前付き参照がワークブックのワークシートの範囲を持つ場合、以下のようにファイル名、ワークシート、および名前を指定することで参照されます: ='C:\[ExternalWorkbook.xls]Sheet1'!SalesTax。

異なる範囲を持つ名前付き参照は同じ名前を持つことができますが、2 つの名前付き参照が同じ範囲を持つ場合、大文字と小文字を区別しない一意の名前を持つ必要があります。

依存関係

jquery-1.4.4.js
infragistics.util.js
infragistics.ext_core.js
infragistics.ext_collections.js
infragistics.ext_collectionsExtended.js
infragistics.ext_io.js
infragistics.ext_text.js
infragistics.documents.core_core.js
infragistics.ext_ui.js
このコントロールにオプションはありません。
このコントロールにイベントはありません。

  • comment
    継承

    .comment( );
    返却型:
    string
    返却型の説明:
    名前付き参照またはテーブルに関連付けられたコメント。

    名前付き参照またはテーブルに関連付けられたコメントを取得します。

    例外

    例外 説明
    ig.ArgumentException 指定した値は 255 文字より長いです。

  • comment
    継承

    .comment( value:string );
    返却型:
    string
    返却型の説明:
    名前付き参照またはテーブルに関連付けられたコメント。

    名前付き参照またはテーブルに関連付けられたコメントを取得します。

    • value
    • タイプ:string

    例外

    例外 説明
    ig.ArgumentException 指定した値は 255 文字より長いです。

  • formula

    .formula( );
    返却型:
    string
    返却型の説明:
    名前付き参照を定義する数式。

    名前付き参照を定義する数式を取得します。

    関連項目

  • isSimpleReferenceFormula

    .isSimpleReferenceFormula( );

    NamedReference.formula が単一のセル、単一の領域、または名前付きの参照と同じワークブックにある複数の領域へ参照する簡易な数式であるかどうかを示す値を取得します。

    備考

    参照がカッコまたは空白に含まれているか、名前付き参照が複雑な数式を持つ場合、false を返します。

  • name
    継承

    .name( );
    返却型:
    string
    返却型の説明:
    参照の名前です。

    参照の名前を取得します。

    例外

    例外 説明
    ig.ArgumentNullException 割り当てた値が null または空です。
    ig.ArgumentException 割り当てた値の長さが 255 文字を超えています。
    ig.ArgumentException 割り当てた値の長さが 255 文字を超えています。
    ig.InvalidOperationException 指定した値は、同じスコープでの他の名前付き参照の名前です。 名前は大文字と小文字を区別せずに比較されます。

    備考

    名前付け参照を数式内の名前で検索する方法については、NamedReferenceBase.scope の概要を参照してください。

  • name
    継承

    .name( value:string );
    返却型:
    string
    返却型の説明:
    参照の名前です。

    参照の名前を取得します。

    • value
    • タイプ:string

    例外

    例外 説明
    ig.ArgumentNullException 割り当てた値が null または空です。
    ig.ArgumentException 割り当てた値の長さが 255 文字を超えています。
    ig.ArgumentException 割り当てた値の長さが 255 文字を超えています。
    ig.InvalidOperationException 指定した値は、同じスコープでの他の名前付き参照の名前です。 名前は大文字と小文字を区別せずに比較されます。

    備考

    名前付け参照を数式内の名前で検索する方法については、NamedReferenceBase.scope の概要を参照してください。

  • referencedCell

    .referencedCell( );
    返却型:
    ig.excel.WorksheetCell
    返却型の説明:
    WorksheetCell を返します。

    NamedReference.formula によって参照される WorksheetCell を取得します。

    備考

    名前付き参照が 1 つ以上の領域への参照の場合、null を返します。

    関連項目

  • referencedRegion

    .referencedRegion( );
    返却型:
    ig.excel.WorksheetRegion
    返却型の説明:
    WorksheetRegion を返します。

    NamedReference.formula によって参照される WorksheetRegion を取得します。

    備考

    名前付き参照が単一のセルまたは複数の領域への参照の場合、null を返します。

    関連項目

  • referencedRegions

    .referencedRegions( );

    NamedReference.formula によって参照された WorksheetRegion インスタンスの配列を取得します。

    備考

    名前付き参照が単一のセルまたは単一の領域への参照の場合、null を返します。

    関連項目

  • scope
    継承

    .scope( );
    返却型:
    object
    返却型の説明:
    名前付き参照の範囲。

    名前付き参照の範囲を取得します。

    備考

    これは名前付き参照が属するワークブックか、ワークブックのワークシートの 1 つである可能性があります。

    範囲は、名前付き参照を使用するために数式を名前の前に配置する必要があるかどうかを決定します。

    この範囲がワークブックの場合、ワークブックのセルの数式は、ワークブックのファイル名、エクスクラメーション ポイント、および以下の名前を指定することによって名前付き参照を参照できます。 =MyWorkbookName ='C:\MyWorkbook.xls'!MyWorkbookName 他のワークブックのセルが名前付き参照を参照したい場合、ワークブックの範囲の名前付き参照が存在する場合にファイル名を最初に指定することで 2 番目の書式を使用する必要があります。

    範囲がワークシートである場合、ワークシートのセルの数式は、名前だけを指定して名前付き参照を参照できます。さらに、ワークシートの名前で名前付き参照を完全に修飾したり、オプションでワークブック ファイル名を修飾できます。 =MyWorksheetName =Sheet1!MyWorksheetName ='C:\[MyWorkbook.xls]Sheet1'!MyWorksheetName 同じワークブックの他のワークシートのセルの数式は名前付き参照でも使用できますが、ワークシート名を指定する必要があり、オプションでワークブック ファイル名が必要です。 =Sheet2!OtherWorksheetName ='C:\[MyWorkbook.xls]Sheet2'!OtherWorksheetName 他のブックにあるセル内の数式でも、名前付き参照を使用できますが、ブックのファイル名、ワークシート名、および名前付き参照名を指定する必要があります。

  • setFormula

    .setFormula( formula:string );

    名前付き参照の数式を設定します。

    • formula
    • タイプ:string
    • 数式値を含む文字列。

    例外

    例外 説明
    ig.ArgumentNullException formula は null または空です。
    ig.ArgumentException formula は有効な数式ではありません。内部例外には、数式が有効でなかった理由を説明する FormulaParseException が含まれます。

    備考

    この数式は、NamedReference が適用される NamedReference.workbook の CellReferenceMode を使用して解析されます。NamedReference がコレクションから削除された場合、A1 参照モードは数式を解析するために使用されます。

    関連項目

  • setFormula

    .setFormula( formula:string, cellReferenceMode:ig.excel.CellReferenceMode );

    名前付き参照の数式を設定します。

    • formula
    • タイプ:string
    • 数式値を含む文字列。
    • cellReferenceMode
    • タイプ:ig.excel.CellReferenceMode
    • 数式のセル参照を解釈するために使用されるモード。

    例外

    例外 説明
    ig.ArgumentNullException formula は null または空です。
    ig.excel.InvalidEnumArgumentException cellReferenceMode が CellReferenceMode 列挙体で定義されていないです。
    ig.ArgumentException formula は有効な数式ではありません。内部例外には、数式が有効でなかった理由を説明する FormulaParseException が含まれます。

    関連項目

  • setFormula

    .setFormula( formula:string, cellReferenceMode:ig.excel.CellReferenceMode, culture:string );

    名前付き参照の数式を設定します。

    • formula
    • タイプ:string
    • 数式値を含む文字列。
    • cellReferenceMode
    • タイプ:ig.excel.CellReferenceMode
    • 数式のセル参照を解釈するために使用されるモード。
    • culture
    • タイプ:string
    • 数式を解析するために使用されるカルチャー。

    例外

    例外 説明
    ig.ArgumentNullException formula は null または空です。
    ig.excel.InvalidEnumArgumentException cellReferenceMode が CellReferenceMode 列挙体で定義されていないです。
    ig.ArgumentException formula は有効な数式ではありません。内部例外には、数式が有効でなかった理由を説明する FormulaParseException が含まれます。

    関連項目

  • toString

    .toString( );
    返却型:
    string
    返却型の説明:
    名前付き参照の文字列表現。

    名前付き参照の文字列表現を取得します。

Copyright © 1996 - 2024 Infragistics, Inc. All rights reserved.