Class RangeList

範囲リスト

同じシート内の 1 つ以上の Range インスタンスのコレクション。このクラスを使用すると、隣接していない範囲またはセルのコレクションにオペレーションを適用できます。

メソッド

メソッド戻り値の型概要
activate()RangeListRange インスタンスのリストを取得します。
breakApart()RangeList範囲リスト内に含まれる水平方向または垂直方向に結合されたセルをすべて、個々のセルに分割します。
check()RangeList範囲内のチェックボックスの状態を [オン] に変更します。
clear()RangeList範囲リスト内の各 Range の範囲の内容、形式、データ検証ルールを消去します。
clear(options)RangeList指定されたオプションで指定された内容の範囲、形式、データ入力規則、コメントを消去します。
clearContent()RangeList範囲リスト内の各 Range のコンテンツを消去し、書式はそのままにします。
clearDataValidations()RangeList範囲リスト内の各 Range のデータ入力規則を消去します。
clearFormat()RangeList範囲リスト内の各 Range のテキスト書式を消去します。
clearNote()RangeList範囲リスト内の各 Range の注記を消去します。
getRanges()Range[]同じシート内の 1 つ以上の Range インスタンスのリストを返します。
insertCheckboxes()RangeList範囲内の各セルにチェックボックスを挿入します。チェックボックスがオンの場合は true、オフの場合は false で構成されます。
insertCheckboxes(checkedValue)RangeList範囲内の各セルにチェックボックスを挿入します。チェックボックスがオンの場合はカスタム値で、オフの場合は空の文字列で構成されます。
insertCheckboxes(checkedValue, uncheckedValue)RangeList範囲内の各セルにチェックボックスを挿入します。チェックボックスは、オンとオフの状態のカスタム値で構成されます。
removeCheckboxes()RangeList範囲内のすべてのチェックボックスを削除します。
setBackground(color)RangeList範囲リスト内の各 Range の背景色を設定します。
setBackgroundRGB(red, green, blue)RangeList背景を指定された RGB 色に設定します。
setBorder(top, left, bottom, right, vertical, horizontal)RangeList範囲リスト内の各 Range の境界プロパティを設定します。
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeList範囲リスト内の各 Range の色やスタイルを指定して、枠線プロパティを設定します。
setFontColor(color)RangeList範囲リスト内の各 Range のフォントの色を設定します。
setFontFamily(fontFamily)RangeList範囲リスト内の各 Range のフォント ファミリーを設定します。
setFontLine(fontLine)RangeList範囲リスト内の各 Range のフォント線スタイルを設定します。
setFontSize(size)RangeList範囲リスト内の各 Range のフォントサイズ(ポイント単位)を設定します。
setFontStyle(fontStyle)RangeList範囲リスト内の各 Range のフォント スタイルを設定します。
setFontWeight(fontWeight)RangeList範囲リスト内の各 Range のフォントウェイトを設定します。
setFormula(formula)RangeList範囲リスト内の各 Range の数式を更新します。
setFormulaR1C1(formula)RangeList範囲リスト内の各 Range の数式を更新します。
setHorizontalAlignment(alignment)RangeList範囲リスト内の各 Range の水平方向の配置を設定します。
setNote(note)RangeList範囲リスト内の各 Range のメモテキストを設定します。
setNumberFormat(numberFormat)RangeList範囲リスト内の各 Range の数値または日付の形式を設定します。
setShowHyperlink(showHyperlink)RangeList範囲リスト内の各 Range にハイパーリンクを表示するかどうかを設定します。
setTextDirection(direction)RangeList範囲リスト内の各 Range のセルにテキストの向きを設定します。
setTextRotation(degrees)RangeList範囲リスト内の各 Range のセルにテキストの回転設定を設定します。
setValue(value)RangeList範囲リスト内の各 Range の値を設定します。
setVerticalAlignment(alignment)RangeList範囲リスト内の各 Range の垂直方向の配置を設定します。
setVerticalText(isVertical)RangeList範囲リスト内の各 Range のセルのテキストを積み重ねるかどうかを設定します。
setWrap(isWrapEnabled)RangeList範囲リスト内の各 Range にテキストの折り返しを設定します。
setWrapStrategy(strategy)RangeList範囲リスト内の各 Range のテキストの折り返し戦略を設定します。
trimWhitespace()RangeListこの範囲リスト内のすべてのセルの空白文字(スペース、タブ、改行など)を削除します。
uncheck()RangeList範囲内のチェックボックスの状態を [オフ] に変更します。

詳細なドキュメント

activate()

Range インスタンスのリストを取得します。リスト内の最後の範囲は active range として設定されます。

注: これにより、複数の範囲を複数選択できます。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.activate();

const selection = sheet.getSelection();
// Current cell: B2
const currentCell = selection.getCurrentCell();
// Active range: B2:C4
const activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
const activeRangeList = selection.getActiveRangeList();

戻る

RangeList - 連結用のアクティブな範囲のリスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

breakApart()

範囲リスト内に含まれる水平方向または垂直方向に結合されたセルをすべて、個々のセルに分割します。

範囲リストでこの関数を呼び出すことは、一連の範囲を選択して、スプレッドシートのメニュー アイテム [形式] > [結合] > [結合解除] を選択することと同じです。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.breakApart();

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

check()

範囲内のチェックボックスの状態を [オン] に変更します。現在、オンまたはオフの値が設定されていない範囲内のセルは無視されます。

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'checked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clear()

範囲リスト内の各 Range の範囲の内容、形式、データ検証ルールを消去します。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear();

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clear(options)

指定されたオプションで指定された内容の範囲、形式、データ入力規則、コメントを消去します。デフォルトでは、すべてのデータが消去されます。

// The code below clears the contents of the following ranges A:A and C:C in the
// active sheet, but preserves the format, data validation rules, and comments.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

パラメータ

名前説明
optionsObject以下に示す詳細なパラメータを指定する JavaScript オブジェクト。

拡張パラメータ

名前説明
commentsOnlyBooleanコメントのみを消去するかどうか。
contentsOnlyBooleanコンテンツのみを消去するかどうか。
formatOnlyBoolean書式のみを消去するかどうか。書式を消去すると、データの入力規則も消去されます。
validationsOnlyBooleanデータの入力規則のみを消去するかどうか。
skipFilteredRowsBooleanフィルタされた行を消去しないかどうか。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearContent()

範囲リスト内の各 Range のコンテンツを消去し、書式はそのままにします。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearDataValidations()

範囲リスト内の各 Range のデータ入力規則を消去します。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearFormat()

範囲リスト内の各 Range のテキスト書式を消去します。

これにより、各範囲のテキスト書式は消去されますが、数値の書式設定ルールはリセットされません。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearNote()

範囲リスト内の各 Range の注記を消去します。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearNote();

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRanges()

同じシート内の 1 つ以上の Range インスタンスのリストを返します。

戻る

Range[] - 範囲のリスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertCheckboxes()

範囲内の各セルにチェックボックスを挿入します。チェックボックスがオンの場合は true、オフの場合は false で構成されます。範囲内のすべてのセルの値を false に設定します。

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'true' for checked and 'false' for unchecked. Also, sets the value of each
// cell in the ranges D4 and E6 to 'false'.
rangeList.insertCheckboxes();

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertCheckboxes(checkedValue)

範囲内の各セルにチェックボックスを挿入します。チェックボックスがオンの場合はカスタム値で、オフの場合は空の文字列で構成されます。範囲内の各セルの値を空の文字列に設定します。

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'yes' for checked and the empty string for unchecked. Also, sets the value of
// each cell in the ranges D4 and E6 to the empty string.
rangeList.insertCheckboxes('yes');

パラメータ

名前説明
checkedValueObjectチェックボックスのデータ検証でオンになっている値。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertCheckboxes(checkedValue, uncheckedValue)

範囲内の各セルにチェックボックスを挿入します。チェックボックスは、オンとオフの状態のカスタム値で構成されます。範囲内の各セルの値を、未選択のカスタム値に設定します。

const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with
// 'yes' for checked and 'no' for unchecked. Also, sets the value of each cell
// in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

パラメータ

名前説明
checkedValueObjectチェックボックスのデータ検証でオンになっている値。
uncheckedValueObjectチェックボックスのデータ検証の未選択値。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

removeCheckboxes()

範囲内のすべてのチェックボックスを削除します。各セルのデータ検証を消去し、セルにチェック済みまたは未チェックの値が含まれている場合は、その値も消去します。

const range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

const rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their
// value.
rangeList1.removeCheckboxes();

const rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear
// their value.
rangeList2.removeCheckboxes();

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setBackground(color)

範囲リスト内の各 Range の背景色を設定します。色は CSS 記法('#ffffff''white' など)で表されます。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setBackground('red');

パラメータ

名前説明
colorStringCSS 表記の背景色コード('#ffffff''white' など)。null 値は色をリセットします。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setBackgroundRGB(red, green, blue)

背景を指定された RGB 色に設定します。これは、setBackground(color) 呼び出しの便利なラッパーです。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

パラメータ

名前説明
redIntegerRGB 表記の赤色値。
greenIntegerRGB 表記の緑色の値。
blueIntegerRGB 表記の青色値。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setBorder(top, left, bottom, right, vertical, horizontal)

範囲リスト内の各 Range の境界プロパティを設定します。有効な値は true(オン)、false(オフ)、null(変更なし)です。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves
// the left and right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

パラメータ

名前説明
topBoolean枠線の場合は true、枠線なしの場合は false、変更なしの場合は null です。
leftBoolean枠線の場合は true、枠線なしの場合は false、変更なしの場合は null です。
bottomBoolean枠線の場合は true、枠線なしの場合は false、変更なしの場合は null です。
rightBoolean枠線の場合は true、枠線なしの場合は false、変更なしの場合は null です。
verticalBooleantrue: 内部の縦線、false: なし、null: 変更なし。
horizontalBooleantrue: 内部水平境界、false: なし、null: 変更なし。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

範囲リスト内の各 Range の色やスタイルを指定して、枠線プロパティを設定します。有効な値は、true(オン)、false(オフ)、null(変更なし)です。色は CSS 記法('#ffffff''white' など)で表されます。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged
// of the ranges A2:B4 and C1:D4. Also sets the color to 'red', and the border
// to 'DASHED'.
rangeList.setBorder(
    true,
    null,
    true,
    null,
    false,
    false,
    'red',
    SpreadsheetApp.BorderStyle.DASHED,
);

パラメータ

名前説明
topBoolean枠線の場合は true、枠線なしの場合は false、変更なしの場合は null です。
leftBoolean枠線の場合は true、枠線なしの場合は false、変更なしの場合は null です。
bottomBoolean枠線の場合は true、枠線なしの場合は false、変更なしの場合は null です。
rightBoolean枠線の場合は true、枠線なしの場合は false、変更なしの場合は null です。
verticalBooleantrue: 内部の縦線、false: なし、null: 変更なし。
horizontalBooleantrue: 内部水平境界、false: なし、null: 変更なし。
colorStringCSS 記法の枠線の色('#ffffff''white' など)。デフォルトの色(黒)の場合は null です。
styleBorderStyle枠線のスタイル。デフォルトのスタイル(実線)の場合は null

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFontColor(color)

範囲リスト内の各 Range のフォントの色を設定します。色は CSS 表記で表されます(例: '#ffffff''white')。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontColor('red');

パラメータ

名前説明
colorStringCSS 表記のフォント色('#ffffff''white' など)。null 値は色をリセットします。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFontFamily(fontFamily)

範囲リスト内の各 Range のフォント ファミリーを設定します。フォント ファミリーは、ArialRoboto などの文字列識別子で記述されます。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontFamily('Roboto');

パラメータ

名前説明
fontFamilyString設定するフォント ファミリー。null 値はフォント ファミリーをリセットします。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFontLine(fontLine)

範囲リスト内の各 Range のフォント線スタイルを設定します。線のスタイルのオプションは、'underline''line-through''none' です。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontLine('line-through');

パラメータ

名前説明
fontLineStringフォント線のスタイル('underline''line-through''none')。null 値はフォント線のスタイルをリセットします。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFontSize(size)

範囲リスト内の各 Range のフォントサイズ(ポイント単位)を設定します。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontSize(20);

パラメータ

名前説明
sizeIntegerフォント ポイントサイズ。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFontStyle(fontStyle)

範囲リスト内の各 Range のフォント スタイルを設定します。フォント スタイルのオプションは 'italic' または 'normal' です。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontStyle('italic');

パラメータ

名前説明
fontStyleStringフォント スタイル('italic' または 'normal')。null 値はフォント スタイルをリセットします。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFontWeight(fontWeight)

範囲リスト内の各 Range のフォントウェイトを設定します。フォントウェイトのオプションは 'normal' または 'bold' です。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontWeight('bold');

パラメータ

名前説明
fontWeightStringフォントウェイト('bold' または 'normal')。null 値はフォントウェイトをリセットします。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFormula(formula)

範囲リスト内の各 Range の数式を更新します。指定された数式は A1 表記にする必要があります。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

パラメータ

名前説明
formulaString設定する数式を表す文字列。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFormulaR1C1(formula)

範囲リスト内の各 Range の数式を更新します。指定する数式は R1C1 表記にする必要があります。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

パラメータ

名前説明
formulaString文字列数式。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHorizontalAlignment(alignment)

範囲リスト内の各 Range の水平方向の配置を設定します。配置オプションは 'left''center''right' です。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setHorizontalAlignment('center');

パラメータ

名前説明
alignmentString配置('left''center''normal')。null 値は配置をリセットします。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setNote(note)

範囲リスト内の各 Range のメモテキストを設定します。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

パラメータ

名前説明
noteString設定するメモのテキスト。null 値を指定するとメモが削除されます。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setNumberFormat(numberFormat)

範囲リスト内の各 Range の数値または日付の形式を設定します。

使用できる書式パターンについては、Sheets API の日付と数値の書式設定ガイドをご覧ください。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

パラメータ

名前説明
numberFormatString数値形式の文字列。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

範囲リスト内の各 Range にハイパーリンクを表示するかどうかを設定します。

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Show hyperlinks for all the ranges.
rangeList.setShowHyperlink(true);

パラメータ

名前説明
showHyperlinkBooleanハイパーリンクを表示するかどうか。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextDirection(direction)

範囲リスト内の各 Range のセルのテキストの向きを設定します。指定された方向が null の場合、方向が推測されて設定されます。

// Sets right-to-left text direction each range in the range list.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

パラメータ

名前説明
directionTextDirection目的のテキストの向き。null の場合、設定前に向きが推測されます。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextRotation(degrees)

範囲リスト内の各 Range のセルにテキストの回転設定を設定します。入力は、標準のテキストの向きと目的の向きの間の角度に対応します。入力が 0 の場合、テキストは標準の向きに設定されています。

左から右の文章方向では、正の角度は反時計回り、右から左の文章方向では時計回りになります。

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45
// degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

パラメータ

名前説明
degreesInteger標準の向きと目的の向きとの間の角度。左から右のテキストの場合、正の角度は反時計回りになります。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setValue(value)

範囲リスト内の各 Range の値を設定します。値は、数値、文字列、ブール値、日付のいずれかです。先頭が「=」の場合は数式として解釈されます。

const sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

パラメータ

名前説明
valueObject範囲の値。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setVerticalAlignment(alignment)

範囲リスト内の各 Range の垂直方向の配置を設定します。配置オプションは 'top''middle''bottom' です。

// Sets the vertical alignment to middle for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment('middle');

パラメータ

名前説明
alignmentString配置('top''middle''bottom')。null 値は配置をリセットします。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setVerticalText(isVertical)

範囲リスト内の各 Range のセルのテキストを積み重ねるかどうかを設定します。テキストが縦方向に積み重ねられている場合、テキストの回転角度の設定は無視されます。

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

パラメータ

名前説明
isVerticalBooleanテキストを重ねるかどうか。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setWrap(isWrapEnabled)

範囲リスト内の各 Range にテキストの折り返しを設定します。折り返しが有効になっているセルは、コンテンツ全体が表示されるようにサイズが変更されます。折り返しが無効になっているセルは、サイズ変更や複数行への分割を行わずに、できるだけ多くの内容がセル内に表示されます。

// Enable text wrap for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

パラメータ

名前説明
isWrapEnabledBooleanテキストを折り返すかどうか。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setWrapStrategy(strategy)

範囲リスト内の各 Range のテキスト折り返し戦略を設定します。

// Sets the list of ranges to use the clip wrap strategy.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

パラメータ

名前説明
strategyWrapStrategy目的の折り返し戦略。

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

trimWhitespace()

この範囲リスト内のすべてのセルの空白文字(スペース、タブ、改行など)を削除します。各セルのテキストの先頭と末尾にある空白文字をすべて削除し、残りの空白文字のサブシーケンスを 1 つのスペースに縮小します。

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

const rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
rangeList.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

関連情報


uncheck()

範囲内のチェックボックスの状態を「オフ」に変更します。現在、オンまたはオフの値が設定されていない範囲内のセルは無視されます。

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'unchecked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

戻る

RangeList - 連結用の範囲リスト。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets