Class RangeList

동일한 시트에 있는 하나 이상의 Range 인스턴스 모음입니다. 이 클래스를 사용하여 인접하지 않은 범위 또는 셀의 컬렉션에 작업을 적용할 수 있습니다.

메서드

메서드	반환 유형	간략한 설명
`activate()`	`RangeList`	`Range` 인스턴스 목록을 선택합니다.
`breakApart()`	`RangeList`	범위 목록에 포함된 모든 가로 또는 세로 병합 셀을 개별 셀로 다시 분리합니다.
`check()`	`RangeList`	범위의 체크박스 상태를 '선택됨'으로 변경합니다.
`clear()`	`RangeList`	범위 목록에 있는 각 `Range`의 콘텐츠, 형식, 데이터 유효성 검사 규칙을 지웁니다.
`clear(options)`	`RangeList`	지정된 옵션으로 지정된 콘텐츠, 형식, 데이터 유효성 검사 규칙, 댓글의 범위를 지웁니다.
`clearContent()`	`RangeList`	범위 목록에 있는 각 `Range`의 콘텐츠를 지우고 서식은 그대로 유지합니다.
`clearDataValidations()`	`RangeList`	범위 목록에 있는 각 `Range`의 데이터 확인 규칙을 지웁니다.
`clearFormat()`	`RangeList`	범위 목록에 있는 각 `Range`의 텍스트 서식을 지웁니다.
`clearNote()`	`RangeList`	범위 목록에 있는 각 `Range`의 메모를 지웁니다.
`getRanges()`	`Range[]`	동일한 시트에 있는 하나 이상의 `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 - 연결을 위한 활성 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`breakApart()`

범위 목록에 포함된 모든 가로 또는 세로 병합 셀을 개별 셀로 다시 분리합니다.

범위 목록에서 이 함수를 호출하는 것은 범위 집합을 선택하고 서식 > 병합 > 병합 해제 Sheets 메뉴 항목을 선택하는 것과 같습니다.

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

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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 - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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 - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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});

매개변수

이름	유형	설명
`options`	`Object`	아래에 나열된 고급 매개변수를 지정하는 JavaScript 객체입니다.

고급 파라미터

이름	유형	설명
`commentsOnly`	`Boolean`	댓글만 삭제할지 여부입니다.
`contentsOnly`	`Boolean`	콘텐츠만 삭제할지 여부입니다.
`formatOnly`	`Boolean`	형식만 지울지 여부입니다. 형식을 지우면 데이터 유효성 검사 규칙도 지워집니다.
`validationsOnly`	`Boolean`	데이터 확인 규칙만 삭제할지 여부입니다.
`skipFilteredRows`	`Boolean`	필터링된 행을 삭제하지 않을지 여부입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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 - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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 - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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 - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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 - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`getRanges()`

동일한 시트에 있는 하나 이상의 Range 인스턴스 목록을 반환합니다.

리턴

Range[] - 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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 - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`checkedValue`	`Object`	체크박스 데이터 유효성 검사의 선택된 값입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`checkedValue`	`Object`	체크박스 데이터 유효성 검사의 선택된 값입니다.
`uncheckedValue`	`Object`	체크박스 데이터 유효성 검사의 선택 해제된 값입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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 - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`color`	`String`	`'#ffffff'` 또는 `'white'`과 같은 CSS 표기법의 배경색 코드입니다. `null` 값은 색상을 재설정합니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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);

매개변수

이름	유형	설명
`red`	`Integer`	RGB 표기법의 빨간색 값입니다.
`green`	`Integer`	RGB 표기법의 녹색 값입니다.
`blue`	`Integer`	RGB 표기법의 파란색 값입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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);

매개변수

이름	유형	설명
`top`	`Boolean`	테두리의 경우 `true`, 없음의 경우 `false`, 변경 없음의 경우 `null`
`left`	`Boolean`	테두리의 경우 `true`, 없음의 경우 `false`, 변경 없음의 경우 `null`
`bottom`	`Boolean`	테두리의 경우 `true`, 없음의 경우 `false`, 변경 없음의 경우 `null`
`right`	`Boolean`	테두리의 경우 `true`, 없음의 경우 `false`, 변경 없음의 경우 `null`
`vertical`	`Boolean`	`true`: 내부 세로 테두리, `false`: 없음, `null`: 변경 없음
`horizontal`	`Boolean`	`true`(내부 가로 테두리), `false`(없음), `null`(변경 없음)

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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,
);

매개변수

이름	유형	설명
`top`	`Boolean`	테두리의 경우 `true`, 없음의 경우 `false`, 변경 없음의 경우 `null`
`left`	`Boolean`	테두리의 경우 `true`, 없음의 경우 `false`, 변경 없음의 경우 `null`
`bottom`	`Boolean`	테두리의 경우 `true`, 없음의 경우 `false`, 변경 없음의 경우 `null`
`right`	`Boolean`	테두리의 경우 `true`, 없음의 경우 `false`, 변경 없음의 경우 `null`
`vertical`	`Boolean`	`true`: 내부 세로 테두리, `false`: 없음, `null`: 변경 없음
`horizontal`	`Boolean`	`true`(내부 가로 테두리), `false`(없음), `null`(변경 없음)
`color`	`String`	`'#ffffff'` 또는 `'white'`와 같은 CSS 표기법의 테두리 색상, 기본 색상 (검은색)의 경우 `null`
`style`	`BorderStyle`	테두리 스타일입니다. 기본 스타일 (실선)은 `null`입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`color`	`String`	CSS 표기법의 글꼴 색상(예: `'#ffffff'` 또는 `'white'`). `null` 값은 색상을 재설정합니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setFontFamily(fontFamily)`

범위 목록에서 각 Range의 글꼴 모음을 설정합니다. 글꼴 모음은 Arial 또는 Roboto과 같은 문자열 식별자로 설명됩니다.

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

매개변수

이름	유형	설명
`fontFamily`	`String`	설정할 글꼴 모음입니다. `null` 값을 사용하면 글꼴 모음이 재설정됩니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`fontLine`	`String`	글꼴 선 스타일(`'underline'`, `'line-through'` 또는 `'none'`). `null` 값은 글꼴 선 스타일을 재설정합니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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);

매개변수

이름	유형	설명
`size`	`Integer`	글꼴 포인트 크기입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`fontStyle`	`String`	글꼴 스타일(`'italic'` 또는 `'normal'`). `null` 값은 글꼴 스타일을 재설정합니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`fontWeight`	`String`	글꼴 두께(`'bold'` 또는 `'normal'`)입니다. `null` 값은 글꼴 두께를 재설정합니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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)');

매개변수

이름	유형	설명
`formula`	`String`	설정할 수식을 나타내는 문자열입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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])');

매개변수

이름	유형	설명
`formula`	`String`	문자열 수식

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`alignment`	`String`	정렬(`'left'`, `'center'` 또는 `'normal'`). `null` 값은 정렬을 재설정합니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`note`	`String`	설정할 메모 텍스트입니다. `null` 값을 사용하면 메모가 삭제됩니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`numberFormat`	`String`	숫자 형식 문자열입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setShowHyperlink(showHyperlink)`

범위 목록의 각 Range에 하이퍼링크를 표시할지 여부를 설정합니다.

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

매개변수

이름	유형	설명
`showHyperlink`	`Boolean`	하이퍼링크 표시 여부입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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);

매개변수

이름	유형	설명
`direction`	`TextDirection`	원하는 텍스트 방향입니다. `null`인 경우 방향은 설정 전에 추론됩니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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);

매개변수

이름	유형	설명
`degrees`	`Integer`	표준 방향과 원하는 방향 사이의 원하는 각도입니다. 왼쪽에서 오른쪽으로 쓰는 텍스트의 경우 양수 각도는 시계 반대 방향입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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);

매개변수

이름	유형	설명
`value`	`Object`	범위의 값입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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');

매개변수

이름	유형	설명
`alignment`	`String`	정렬(`'top'`, `'middle'` 또는 `'bottom'`). `null` 값은 정렬을 재설정합니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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);

매개변수

이름	유형	설명
`isVertical`	`Boolean`	텍스트를 스택할지 여부입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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);

매개변수

이름	유형	설명
`isWrapEnabled`	`Boolean`	텍스트를 줄바꿈할지 여부입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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);

매개변수

이름	유형	설명
`strategy`	`WrapStrategy`	원하는 줄바꿈 전략입니다.

리턴

RangeList - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`trimWhitespace()`

이 범위 목록의 모든 셀에서 공백, 탭, 줄바꿈과 같은 공백을 자릅니다. 각 셀 텍스트의 시작과 끝에 있는 모든 공백을 삭제하고 남아 있는 공백 문자의 모든 후속 항목을 단일 공백으로 줄입니다.

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 - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

참고 항목

Range.trimWhitespace()

`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 - 체이닝을 위한 이 범위 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

Class RangeList 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

메서드

자세한 문서

activate()

리턴

승인

breakApart()

리턴

승인

check()

리턴

승인

clear()

리턴

승인

clear(options)

매개변수

고급 파라미터

리턴

승인

clearContent()

리턴

승인

clearDataValidations()

리턴

승인

clearFormat()

리턴

승인

clearNote()

리턴

승인

getRanges()

리턴

승인

insertCheckboxes()

리턴

승인

insertCheckboxes(checkedValue)

매개변수

리턴

승인

insertCheckboxes(checkedValue, uncheckedValue)

매개변수

리턴

승인

removeCheckboxes()

리턴

승인

setBackground(color)

매개변수

리턴

승인

setBackgroundRGB(red, green, blue)

매개변수

리턴

승인

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

매개변수

리턴

승인

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

매개변수

리턴

승인

setFontColor(color)

매개변수

리턴

승인

setFontFamily(fontFamily)

매개변수

리턴

승인

setFontLine(fontLine)

매개변수

리턴

승인

setFontSize(size)

매개변수

리턴

Class RangeList

`activate()`

`breakApart()`

`check()`

`clear()`

`clear(options)`

`clearContent()`

`clearDataValidations()`

`clearFormat()`

`clearNote()`

`getRanges()`

`insertCheckboxes()`

`insertCheckboxes(checkedValue)`

`insertCheckboxes(checkedValue, uncheckedValue)`

`removeCheckboxes()`

`setBackground(color)`

`setBackgroundRGB(red, green, blue)`

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

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

`setFontColor(color)`

`setFontFamily(fontFamily)`

`setFontLine(fontLine)`

`setFontSize(size)`

`setFontStyle(fontStyle)`

`setFontWeight(fontWeight)`

`setFormula(formula)`

`setFormulaR1C1(formula)`

`setHorizontalAlignment(alignment)`

`setNote(note)`

`setNumberFormat(numberFormat)`

`setShowHyperlink(showHyperlink)`

`setTextDirection(direction)`

`setTextRotation(degrees)`

`setValue(value)`

`setVerticalAlignment(alignment)`

`setVerticalText(isVertical)`

`setWrap(isWrapEnabled)`

`setWrapStrategy(strategy)`

`trimWhitespace()`

`uncheck()`