Share via


Excel.Interfaces.RangeData interface

を呼び出 range.toJSON()して返されるデータを記述するインターフェイス。

プロパティ

address

範囲参照を A1 スタイルで指定します。 アドレス値にはシート参照が含まれます (例: "Sheet1!A1:B4")。

addressLocal

ユーザーの言語で指定した範囲の範囲参照を表します。

cellCount

範囲内のセルの数を指定します。 セルの数が 2^31-1 (2,147,483,647) を超えると、この API は -1 を返します。

columnCount

範囲内の列の合計数を指定します。

columnHidden

現在の範囲内のすべての列が非表示の場合にを表します。 値は、 true 範囲内のすべての列が非表示の場合です。 値は、 false 範囲内の列が非表示でない場合です。 値は、 null 範囲内の一部の列が非表示であり、同じ範囲内の他の列が非表示でない場合です。

columnIndex

範囲内の最初のセルの列番号を指定します。 0 を起点とする番号になります。

format

Format オブジェクト (範囲のフォント、塗りつぶし、罫線、配置などのプロパティをカプセル化するオブジェクト) を返します。

formulas

A1 スタイル表記の数式を表します。 セルに数式がない場合は、代わりに値が返されます。

formulasLocal

ユーザーの言語と数値書式ロケールで、A1 スタイル表記の数式を表します。 たとえば、英語の数式 "=SUM(A1, 1.5)" は、ドイツ語では "=SUMME(A1; 1,5)" になります。 セルに数式がない場合は、代わりに値が返されます。

formulasR1C1

R1C1 スタイル表記の数式を表します。 セルに数式がない場合は、代わりに値が返されます。

hidden

現在の範囲内のすべてのセルが非表示かどうかを表します。 値は、 true 範囲内のすべてのセルが非表示の場合です。 値は、 false 範囲内のセルが非表示でない場合です。 値は、 null 範囲内の一部のセルが非表示で、同じ範囲内の他のセルが非表示にならない場合です。

numberFormat

指定した範囲の Excel の数値書式コードを表します。 Excel の数値書式の詳細については、「数値書式 コード」を参照してください。

rowCount

範囲に含まれる行の合計数を返します。

rowHidden

現在の範囲内のすべての行が非表示の場合にを表します。 値は、 true 範囲内のすべての行が非表示の場合です。 値は、 false 範囲内の行が非表示の場合です。 値は、 null 範囲内の一部の行が非表示で、同じ範囲内の他の行が非表示にならない場合です。

rowIndex

範囲に含まれる最初のセルの行番号を返します。 0 を起点とする番号になります。

text

指定した範囲のテキスト値。 テキスト値は、セルの幅には依存しません。 Excel UI で発生する数値記号 (#) の置換は、API によって返されるテキスト値には影響しません。

values

指定した範囲の Raw 値を表します。 返されるデータは、文字列、数値、またはブール値のいずれかです。 エラーが含まれているセルは、エラー文字列を返します。 返される値が正符号 ("+")、マイナス ("-")、または等号 ("=") で始まる場合、Excel はこの値を数式として解釈します。

valueTypes

各セル内のデータの種類を指定します。

プロパティの詳細

address

範囲参照を A1 スタイルで指定します。 アドレス値にはシート参照が含まれます (例: "Sheet1!A1:B4")。

address?: string;

プロパティ値

string

注釈

[ API セット: ExcelApi 1.1 ]

addressLocal

ユーザーの言語で指定した範囲の範囲参照を表します。

addressLocal?: string;

プロパティ値

string

注釈

[ API セット: ExcelApi 1.1 ]

cellCount

範囲内のセルの数を指定します。 セルの数が 2^31-1 (2,147,483,647) を超えると、この API は -1 を返します。

cellCount?: number;

プロパティ値

number

注釈

[ API セット: ExcelApi 1.1 ]

columnCount

範囲内の列の合計数を指定します。

columnCount?: number;

プロパティ値

number

注釈

[ API セット: ExcelApi 1.1 ]

columnHidden

現在の範囲内のすべての列が非表示の場合にを表します。 値は、 true 範囲内のすべての列が非表示の場合です。 値は、 false 範囲内の列が非表示でない場合です。 値は、 null 範囲内の一部の列が非表示であり、同じ範囲内の他の列が非表示でない場合です。

columnHidden?: boolean;

プロパティ値

boolean

注釈

[ API セット: ExcelApi 1.2 ]

columnIndex

範囲内の最初のセルの列番号を指定します。 0 を起点とする番号になります。

columnIndex?: number;

プロパティ値

number

注釈

[ API セット: ExcelApi 1.1 ]

format

Format オブジェクト (範囲のフォント、塗りつぶし、罫線、配置などのプロパティをカプセル化するオブジェクト) を返します。

format?: Excel.Interfaces.RangeFormatData;

プロパティ値

注釈

[ API セット: ExcelApi 1.1 ]

formulas

A1 スタイル表記の数式を表します。 セルに数式がない場合は、代わりに値が返されます。

formulas?: any[][];

プロパティ値

any[][]

注釈

[ API セット: ExcelApi 1.1 ]

formulasLocal

ユーザーの言語と数値書式ロケールで、A1 スタイル表記の数式を表します。 たとえば、英語の数式 "=SUM(A1, 1.5)" は、ドイツ語では "=SUMME(A1; 1,5)" になります。 セルに数式がない場合は、代わりに値が返されます。

formulasLocal?: any[][];

プロパティ値

any[][]

注釈

[ API セット: ExcelApi 1.1 ]

formulasR1C1

R1C1 スタイル表記の数式を表します。 セルに数式がない場合は、代わりに値が返されます。

formulasR1C1?: any[][];

プロパティ値

any[][]

注釈

[ API セット: ExcelApi 1.2 ]

hidden

現在の範囲内のすべてのセルが非表示かどうかを表します。 値は、 true 範囲内のすべてのセルが非表示の場合です。 値は、 false 範囲内のセルが非表示でない場合です。 値は、 null 範囲内の一部のセルが非表示で、同じ範囲内の他のセルが非表示にならない場合です。

hidden?: boolean;

プロパティ値

boolean

注釈

[ API セット: ExcelApi 1.2 ]

numberFormat

指定した範囲の Excel の数値書式コードを表します。 Excel の数値書式の詳細については、「数値書式 コード」を参照してください。

numberFormat?: any[][];

プロパティ値

any[][]

注釈

[ API セット: ExcelApi 1.1 ]

rowCount

範囲に含まれる行の合計数を返します。

rowCount?: number;

プロパティ値

number

注釈

[ API セット: ExcelApi 1.1 ]

rowHidden

現在の範囲内のすべての行が非表示の場合にを表します。 値は、 true 範囲内のすべての行が非表示の場合です。 値は、 false 範囲内の行が非表示の場合です。 値は、 null 範囲内の一部の行が非表示で、同じ範囲内の他の行が非表示にならない場合です。

rowHidden?: boolean;

プロパティ値

boolean

注釈

[ API セット: ExcelApi 1.2 ]

rowIndex

範囲に含まれる最初のセルの行番号を返します。 0 を起点とする番号になります。

rowIndex?: number;

プロパティ値

number

注釈

[ API セット: ExcelApi 1.1 ]

text

指定した範囲のテキスト値。 テキスト値は、セルの幅には依存しません。 Excel UI で発生する数値記号 (#) の置換は、API によって返されるテキスト値には影響しません。

text?: string[][];

プロパティ値

string[][]

注釈

[ API セット: ExcelApi 1.1 ]

values

指定した範囲の Raw 値を表します。 返されるデータは、文字列、数値、またはブール値のいずれかです。 エラーが含まれているセルは、エラー文字列を返します。 返される値が正符号 ("+")、マイナス ("-")、または等号 ("=") で始まる場合、Excel はこの値を数式として解釈します。

values?: any[][];

プロパティ値

any[][]

注釈

[ API セット: ExcelApi 1.1 ]

valueTypes

各セル内のデータの種類を指定します。

valueTypes?: Excel.RangeValueType[][];

プロパティ値

注釈

[ API セット: ExcelApi 1.1 ]