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 を起点とする番号になります。

conditionalFormats

範囲と交差する ConditionalFormats のコレクション。

dataValidation

dataValidation オブジェクトを返します。

format

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

formulas

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

formulasLocal

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

formulasR1C1

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

hidden

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

hyperlink

現在の範囲のハイパーリンクを表します。

isEntireColumn

現在の範囲が列全体であるかどうかを表します。

isEntireRow

現在の範囲が行全体であるかどうかを表します。

numberFormat

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

numberFormatLocal

ユーザーの言語設定に基づいた、指定された範囲に対する Excel の数値書式コードを表します。 Excel は、 numberFormatLocal プロパティを取得または設定するときに、いかなる言語または形式の強制も実行しません。 返されるすべてのテキストは、システム設定で指定された言語に基づいて、ローカルで書式設定された文字列を使用します。

rowCount

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

rowHidden

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

rowIndex

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

style

現在の範囲のスタイルを表します。 セルのスタイルに一貫性がない場合は、 null が返されます。 カスタム スタイルの場合は、スタイル名が返されます。 組み込みスタイルの場合は、 BuiltInStyle 列挙型の値を表す文字列が返されます。

text

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

values

指定した範囲の Raw 値を表します。 返されるデータは、文字列、数値、またはブール値を指定できます。 エラーが含まれているセルは、エラー文字列を返します。 返された値がプラス ("+")、マイナス ("-")、または等号 ("=") で始まる場合、Excel はこの値を数式として解釈します。 ロケール形式の文字列 (たとえば、nl-NL または fr-FR の日付 "19-8-2025"、形式 DD-MM-YYYY) は、日付としてではなくテキストとして保存されます。 日付が日付として格納されるようにするには、 formulasLocal などのロケール対応 API を使用するか、ISO (YYYY-MM-DD) または数値日付シリアルなどのロケールに依存しない形式を使用します。

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

conditionalFormats

範囲と交差する ConditionalFormats のコレクション。

conditionalFormats?: Excel.Interfaces.ConditionalFormatData[];

プロパティ値

注釈

API セット: ExcelApi 1.6

dataValidation

dataValidation オブジェクトを返します。

dataValidation?: Excel.Interfaces.DataValidationData;

プロパティ値

注釈

API セット: ExcelApi 1.8

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

現在の範囲のハイパーリンクを表します。

hyperlink?: Excel.RangeHyperlink;

プロパティ値

注釈

API セット: ExcelApi 1.7

isEntireColumn

現在の範囲が列全体であるかどうかを表します。

isEntireColumn?: boolean;

プロパティ値

boolean

注釈

API セット: ExcelApi 1.7

isEntireRow

現在の範囲が行全体であるかどうかを表します。

isEntireRow?: boolean;

プロパティ値

boolean

注釈

API セット: ExcelApi 1.7

numberFormat

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

numberFormat?: any[][];

プロパティ値

any[][]

注釈

API セット: ExcelApi 1.1

numberFormatLocal

ユーザーの言語設定に基づいた、指定された範囲に対する Excel の数値書式コードを表します。 Excel は、 numberFormatLocal プロパティを取得または設定するときに、いかなる言語または形式の強制も実行しません。 返されるすべてのテキストは、システム設定で指定された言語に基づいて、ローカルで書式設定された文字列を使用します。

numberFormatLocal?: any[][];

プロパティ値

any[][]

注釈

API セット: ExcelApi 1.7

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

style

現在の範囲のスタイルを表します。 セルのスタイルに一貫性がない場合は、 null が返されます。 カスタム スタイルの場合は、スタイル名が返されます。 組み込みスタイルの場合は、 BuiltInStyle 列挙型の値を表す文字列が返されます。

style?: string;

プロパティ値

string

注釈

API セット: ExcelApi 1.7

text

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

text?: string[][];

プロパティ値

string[][]

注釈

API セット: ExcelApi 1.1

values

指定した範囲の Raw 値を表します。 返されるデータは、文字列、数値、またはブール値を指定できます。 エラーが含まれているセルは、エラー文字列を返します。 返された値がプラス ("+")、マイナス ("-")、または等号 ("=") で始まる場合、Excel はこの値を数式として解釈します。 ロケール形式の文字列 (たとえば、nl-NL または fr-FR の日付 "19-8-2025"、形式 DD-MM-YYYY) は、日付としてではなくテキストとして保存されます。 日付が日付として格納されるようにするには、 formulasLocal などのロケール対応 API を使用するか、ISO (YYYY-MM-DD) または数値日付シリアルなどのロケールに依存しない形式を使用します。

values?: any[][];

プロパティ値

any[][]

注釈

API セット: ExcelApi 1.1

valueTypes

各セルのデータ型を指定します。

valueTypes?: Excel.RangeValueType[][];

プロパティ値

注釈

API セット: ExcelApi 1.1