ExcelScript.RangeAreas interface

パッケージ:

ExcelScript

RangeAreas は、同じワークシート内の 1 つ以上の四角形の範囲のコレクションを表します。

注釈

例

/**
 * This script clears all the cells in the current worksheet that are displaying errors.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the used range on the current sheet.
  const currentSheet = workbook.getActiveWorksheet();
  const usedRange = currentSheet.getUsedRange();

  // Get the RangeAreas object for each cell with a formula error.
  const errorCells = usedRange.getSpecialCells(ExcelScript.SpecialCellType.formulas, ExcelScript.SpecialCellValueType.errors);

  // If there are any error cells, clear them.
  if (errorCells) {
    errorCells.clear();
  }
}

メソッド

addConditionalFormat(type)	コレクションに新しい条件付き書式を最初または最優先事項で追加します。
calculate()	内のすべてのセルを計算します RangeAreas。
clear(applyTo)	この RangeAreas オブジェクトを構成する各領域の値、書式、塗りつぶし、罫線、およびその他のプロパティをクリアします。
clearAllConditionalFormats()	現在指定している範囲でアクティブなすべての条件付き書式をクリアする。
convertDataTypeToText()	データ型を持つ 内のすべてのセルを RangeAreas テキストに変換します。
copyFrom(sourceRange, copyType, skipBlanks, transpose)	セル データまたは書式設定をソース範囲または RangeAreas 現在 RangeAreasの にコピーします。 変換先 RangeAreas のサイズは、ソース範囲または RangeAreasとは異なる場合があります。 コピー先がソースより小さい場合は、自動的に展開されます。
getAddress()	RangeAreas A1 スタイルの参照を返します。 アドレス値には、セルの四角形の各ブロックのワークシート名が含まれます (例: "Sheet1!A1:B4、Sheet1!D1:D4")。
getAddressLocal()	ユーザー ロケールの RangeAreas 参照を返します。
getAreaCount()	この RangeAreas オブジェクトを構成する四角形の範囲の数を返します。
getAreas()	この RangeAreas オブジェクトを構成する四角形の範囲のコレクションを返します。
getCellCount()	オブジェクト内のセルの数を返し RangeAreas 、個々のすべての四角形の範囲のセル数を合計します。 セル数が 2^31-1 (2,147,483,647) を超える場合、-1 を返します。
getConditionalFormat(id)	ID で識別される条件付き形式を返します。 条件付き書式オブジェクトが存在しない場合、このメソッドは を返します undefined。
getConditionalFormats()	この RangeAreas オブジェクト内の任意のセルと交差する条件付き形式のコレクションを返します。
getDataValidation()	内のすべての範囲のデータ検証オブジェクトを返します RangeAreas。
getEntireColumn()	のRangeAreas列全体をRangeAreas表すオブジェクトを返します (たとえば、現在のRangeAreasがセル "B4:E11, H2" を表している場合、列 "B:E, H:H" を表す をRangeAreas返します)。
getEntireRow()	の行全体をRangeAreas表す オブジェクトを返します (たとえば、現在RangeAreasのRangeAreasがセル "B4:E11" を表している場合は、行 "4:11" を表す をRangeAreas返します)。
getFormat()	オブジェクト内 RangeFormat のすべての範囲のフォント、塗りつぶし、罫線、配置、およびその他のプロパティをカプセル化して、オブジェクトを RangeAreas 返します。
getIntersection(anotherRange)	指定した RangeAreas 範囲または RangeAreasの積集合を表す オブジェクトを返します。 積集合が見つからない場合、このメソッドは を返します undefined。
getIsEntireColumn()	この RangeAreas オブジェクトのすべての範囲が列全体を表すかどうかを指定します (例: "A:C, Q:Z")。
getIsEntireRow()	この RangeAreas オブジェクトのすべての範囲が行全体を表すかどうかを指定します (例: "1:3, 5:7")。
getOffsetRangeAreas(rowOffset, columnOffset)	特定の RangeAreas 行と列のオフセットによってシフトされるオブジェクトを返します。 返される RangeAreas の次元は、元のオブジェクトと一致します。 結果 RangeAreas がワークシート グリッドの範囲外に強制されると、エラーがスローされます。
getPredefinedCellStyle()	この RangeAreas オブジェクト内のすべての範囲のスタイルを表します。 セルのスタイルに一貫性がない場合は、 null が返されます。 カスタム スタイルの場合、スタイル名が返されます。 組み込みのスタイルの場合、列挙型の BuiltInStyle 値を表す文字列が返されます。
getSpecialCells(cellType, cellValueType)	指定した型と値に RangeAreas 一致するすべてのセルを表す オブジェクトを返します。 条件に一致する特殊なセルが見つからない場合、このメソッドは を返します undefined。
getTables(fullyContained)	この RangeAreas オブジェクト内の任意の範囲と重複するテーブルのスコープ付きコレクションを返します。
getUsedRangeAreas(valuesOnly)	オブジェクト内の個々の RangeAreas 四角形の範囲のすべての使用領域を構成する used を RangeAreas 返します。 内に使用されているセルがない場合、 RangeAreasこのメソッドは を返します undefined。
getWorksheet()	現在 RangeAreasの のワークシートを返します。
setDirty()	次の RangeAreas 再計算が発生したときに再計算する を設定します。
setPredefinedCellStyle(predefinedCellStyle)	この RangeAreas オブジェクト内のすべての範囲のスタイルを表します。 セルのスタイルに一貫性がない場合は、 null が返されます。 カスタム スタイルの場合、スタイル名が返されます。 組み込みのスタイルの場合、列挙型の BuiltInStyle 値を表す文字列が返されます。

メソッドの詳細

addConditionalFormat(type)

コレクションに新しい条件付き書式を最初または最優先事項で追加します。

addConditionalFormat(type: ConditionalFormatType): ConditionalFormat;

パラメーター

type

ExcelScript.ConditionalFormatType

追加される条件付き書式の種類。 詳細は「ExcelScript.ConditionalFormatType」をご覧ください。

戻り値

ExcelScript.ConditionalFormat

calculate()

内のすべてのセルを計算します RangeAreas。

calculate(): void;

戻り値

void

clear(applyTo)

この RangeAreas オブジェクトを構成する各領域の値、書式、塗りつぶし、罫線、およびその他のプロパティをクリアします。

clear(applyTo?: ClearApplyTo): void;

パラメーター

applyTo

ExcelScript.ClearApplyTo

オプション。 クリア操作の種類を決定します。 詳細は「ExcelScript.ClearApplyTo」をご覧ください。 既定値は "All" です。

戻り値

void

例

/**
 * This script clears all the cells in the current worksheet that are displaying errors.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the used range on the current sheet.
  const currentSheet = workbook.getActiveWorksheet();
  const usedRange = currentSheet.getUsedRange();

  // Get the RangeAreas object for each cell with a formula error.
  const errorCells = usedRange.getSpecialCells(ExcelScript.SpecialCellType.formulas, ExcelScript.SpecialCellValueType.errors);

  // If there are any error cells, clear them.
  if (errorCells) {
    errorCells.clear();
  }
}

clearAllConditionalFormats()

現在指定している範囲でアクティブなすべての条件付き書式をクリアする。

clearAllConditionalFormats(): void;

戻り値

void

convertDataTypeToText()

データ型を持つ 内のすべてのセルを RangeAreas テキストに変換します。

convertDataTypeToText(): void;

戻り値

void

copyFrom(sourceRange, copyType, skipBlanks, transpose)

セル データまたは書式設定をソース範囲または RangeAreas 現在 RangeAreasの にコピーします。 変換先 RangeAreas のサイズは、ソース範囲または RangeAreasとは異なる場合があります。 コピー先がソースより小さい場合は、自動的に展開されます。

copyFrom(
            sourceRange: Range | RangeAreas | string,
            copyType?: RangeCopyType,
            skipBlanks?: boolean,
            transpose?: boolean
        ): void;

パラメーター

sourceRange

ExcelScript.Range | ExcelScript.RangeAreas | string

コピー元の範囲または RangeAreas コピー元の範囲。 ソース RangeAreas に複数の範囲がある場合は、四角形の範囲から完全な行または列を削除してフォームを作成できる必要があります。

copyType

ExcelScript.RangeCopyType

コピーするセル データまたは書式設定の種類。 既定値は "All" です。

skipBlanks

boolean

True を指定すると、ソース範囲内の空白のセルがスキップされるか、 または RangeAreasがスキップされます。 既定値は false です。

transpose

boolean

True の場合は、変換先 RangeAreasの セルを置き換えます。 既定値は false です。

戻り値

void

getAddress()

RangeAreas A1 スタイルの参照を返します。 アドレス値には、セルの四角形の各ブロックのワークシート名が含まれます (例: "Sheet1!A1:B4、Sheet1!D1:D4")。

getAddress(): string;

戻り値

string

getAddressLocal()

ユーザー ロケールの RangeAreas 参照を返します。

getAddressLocal(): string;

戻り値

string

getAreaCount()

この RangeAreas オブジェクトを構成する四角形の範囲の数を返します。

getAreaCount(): number;

戻り値

number

getAreas()

この RangeAreas オブジェクトを構成する四角形の範囲のコレクションを返します。

getAreas(): Range[];

戻り値

ExcelScript.Range[]

getCellCount()

オブジェクト内のセルの数を返し RangeAreas 、個々のすべての四角形の範囲のセル数を合計します。 セル数が 2^31-1 (2,147,483,647) を超える場合、-1 を返します。

getCellCount(): number;

戻り値

number

getConditionalFormat(id)

ID で識別される条件付き形式を返します。 条件付き書式オブジェクトが存在しない場合、このメソッドは を返します undefined。

getConditionalFormat(id: string): ConditionalFormat | undefined;

パラメーター

id

string

条件付き書式の ID。

戻り値

ExcelScript.ConditionalFormat | undefined

getConditionalFormats()

この RangeAreas オブジェクト内の任意のセルと交差する条件付き形式のコレクションを返します。

getConditionalFormats(): ConditionalFormat[];

戻り値

ExcelScript.ConditionalFormat[]

getDataValidation()

内のすべての範囲のデータ検証オブジェクトを返します RangeAreas。

getDataValidation(): DataValidation;

戻り値

ExcelScript.DataValidation

getEntireColumn()

のRangeAreas列全体をRangeAreas表すオブジェクトを返します (たとえば、現在のRangeAreasがセル "B4:E11, H2" を表している場合、列 "B:E, H:H" を表す をRangeAreas返します)。

getEntireColumn(): RangeAreas;

戻り値

ExcelScript.RangeAreas

getEntireRow()

の行全体をRangeAreas表す オブジェクトを返します (たとえば、現在RangeAreasのRangeAreasがセル "B4:E11" を表している場合は、行 "4:11" を表す をRangeAreas返します)。

getEntireRow(): RangeAreas;

戻り値

ExcelScript.RangeAreas

getFormat()

オブジェクト内 RangeFormat のすべての範囲のフォント、塗りつぶし、罫線、配置、およびその他のプロパティをカプセル化して、オブジェクトを RangeAreas 返します。

getFormat(): RangeFormat;

戻り値

ExcelScript.RangeFormat

例

/**
 * This script finds and highlights all the cells in the current worksheet that contain a formula.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the used range on the current sheet.
  const currentSheet = workbook.getActiveWorksheet();
  const usedRange = currentSheet.getUsedRange();

  // Get the RangeAreas object for each cell with a formula.
  const formulaCells = usedRange.getSpecialCells(ExcelScript.SpecialCellType.formulas);

  // Add a light blue background to the cells containing formulas.
  formulaCells.getFormat().getFill().setColor("#ADD8E6");
}

getIntersection(anotherRange)

指定した RangeAreas 範囲または RangeAreasの積集合を表す オブジェクトを返します。 積集合が見つからない場合、このメソッドは を返します undefined。

getIntersection(anotherRange: Range | RangeAreas | string): RangeAreas;

パラメーター

anotherRange

ExcelScript.Range | ExcelScript.RangeAreas | string

交差部分を決定するために使用される範囲 RangeAreas 、オブジェクト、またはアドレス。

戻り値

ExcelScript.RangeAreas

getIsEntireColumn()

この RangeAreas オブジェクトのすべての範囲が列全体を表すかどうかを指定します (例: "A:C, Q:Z")。

getIsEntireColumn(): boolean;

戻り値

boolean

getIsEntireRow()

この RangeAreas オブジェクトのすべての範囲が行全体を表すかどうかを指定します (例: "1:3, 5:7")。

getIsEntireRow(): boolean;

戻り値

boolean

getOffsetRangeAreas(rowOffset, columnOffset)

特定の RangeAreas 行と列のオフセットによってシフトされるオブジェクトを返します。 返される RangeAreas の次元は、元のオブジェクトと一致します。 結果 RangeAreas がワークシート グリッドの範囲外に強制されると、エラーがスローされます。

getOffsetRangeAreas(
            rowOffset: number,
            columnOffset: number
        ): RangeAreas;

パラメーター

rowOffset

number

オフセットする行数 (正、負、または 0 RangeAreas )。 正の値は下方向、負の値は上方向のオフセットを表します。

columnOffset

number

オフセットする列の数 (正、負、または 0 RangeAreas )。 正の値は右方向、負の値は左方向のオフセットを表します。

戻り値

ExcelScript.RangeAreas

getPredefinedCellStyle()

この RangeAreas オブジェクト内のすべての範囲のスタイルを表します。 セルのスタイルに一貫性がない場合は、 null が返されます。 カスタム スタイルの場合、スタイル名が返されます。 組み込みのスタイルの場合、列挙型の BuiltInStyle 値を表す文字列が返されます。

getPredefinedCellStyle(): string;

戻り値

string

getSpecialCells(cellType, cellValueType)

指定した型と値に RangeAreas 一致するすべてのセルを表す オブジェクトを返します。 条件に一致する特殊なセルが見つからない場合、このメソッドは を返します undefined。

getSpecialCells(
            cellType: SpecialCellType,
            cellValueType?: SpecialCellValueType
        ): RangeAreas;

パラメーター

cellType

ExcelScript.SpecialCellType

含めるセルの種類。

cellValueType

ExcelScript.SpecialCellValueType

が または formulasのconstants場合cellType、この引数を使用して、結果に含めるセルの種類を決定します。 これらの値を組み合わせて、複数の型を返すことができます。 この引数を省略すると、すべての定数および数式が対象になります。

戻り値

ExcelScript.RangeAreas

getTables(fullyContained)

この RangeAreas オブジェクト内の任意の範囲と重複するテーブルのスコープ付きコレクションを返します。

getTables(fullyContained?: boolean): Table[];

パラメーター

fullyContained

boolean

の場合 trueは、範囲の境界内に完全に含まれるテーブルのみが返されます。 既定値は です false。

戻り値

ExcelScript.Table[]

getUsedRangeAreas(valuesOnly)

オブジェクト内の個々の RangeAreas 四角形の範囲のすべての使用領域を構成する used を RangeAreas 返します。 内に使用されているセルがない場合、 RangeAreasこのメソッドは を返します undefined。

getUsedRangeAreas(valuesOnly?: boolean): RangeAreas;

パラメーター

valuesOnly

boolean

値を持つセルのみを使用セルと見なすかどうか。

戻り値

ExcelScript.RangeAreas

getWorksheet()

現在 RangeAreasの のワークシートを返します。

getWorksheet(): Worksheet;

戻り値

ExcelScript.Worksheet

setDirty()

次の RangeAreas 再計算が発生したときに再計算する を設定します。

setDirty(): void;

戻り値

void

setPredefinedCellStyle(predefinedCellStyle)

この RangeAreas オブジェクト内のすべての範囲のスタイルを表します。 セルのスタイルに一貫性がない場合は、 null が返されます。 カスタム スタイルの場合、スタイル名が返されます。 組み込みのスタイルの場合、列挙型の BuiltInStyle 値を表す文字列が返されます。

setPredefinedCellStyle(predefinedCellStyle: string): void;

パラメーター

predefinedCellStyle

string

戻り値

void

例

/**
 * This script sets the cell style to "warning text"
 * on every cell with a formula error.
 */ 
function main(workbook: ExcelScript.Workbook) {
  // Get the used range in the current worksheet.
  const sheet = workbook.getActiveWorksheet();
  const usedRange = sheet.getUsedRange();

  // Get any cells that are displaying errors.
  const errorCells = usedRange.getSpecialCells(
    ExcelScript.SpecialCellType.formulas,
    ExcelScript.SpecialCellValueType.errors
  );

  // Check if there are error cells before proceeding.
  if (errorCells) {
    // Use the built-in warning text style on the error cells.
    errorCells.setPredefinedCellStyle(
      ExcelScript.BuiltInStyle.warningText.toString()
    );
  } else {
    console.log("No formula errors in the worksheet.");
  }
}