Class RangeList

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로 설정됩니다.

참고: 이렇게 하면 여러 범위를 여러 개 선택할 수 있습니다.

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

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

리턴

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

승인

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

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

---

breakApart()

범위 목록에 포함된 모든 가로 또는 세로로 병합된 셀을 분할 다시 반복하지 않아도 됩니다

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

var sheet = SpreadsheetApp.getActiveSheet();
var 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'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

리턴

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

승인

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

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

---

clear()

각 Range의 콘텐츠, 형식, 데이터 유효성 검사 규칙의 범위를 삭제합니다. 범위 목록입니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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의 내용을 지우고 서식을 그대로 둡니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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의 데이터 확인 규칙을 지웁니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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의 텍스트 서식을 지웁니다.

이렇게 하면 각 범위의 텍스트 서식이 지워지지만 숫자 서식 규칙은 재설정되지 않습니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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의 메모를 지웁니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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로 설정합니다.

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

범위의 각 셀에 체크박스를 삽입합니다. 선택 및 선택에 대한 맞춤 값으로 구성된 선택 해제를 위한 빈 문자열입니다. 범위에 있는 각 셀의 값을 빈 문자열로 설정합니다.

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

선택한 셀에 대한 커스텀 값으로 구성된 범위의 각 셀에 체크박스를 삽입합니다. 확인할 수 있습니다 범위 내 각 셀의 값을 선택 해제된 맞춤 값으로 설정합니다.

var 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()

범위에서 모든 체크박스를 삭제합니다. 각 셀의 데이터 확인을 삭제합니다. 셀에 선택된 값 또는 선택 해제된 값이 있는 경우 해당 값을 추가로 지웁니다.

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

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

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

var 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'입니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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) 호출 주변의 편의 래퍼입니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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 (변경 없음)입니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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'입니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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	CSS 표기법으로 표시된 테두리 색상입니다(예: 기본 색상(검은색)의 경우 '#ffffff' 또는 'white', null).
style	BorderStyle	테두리의 스타일, 기본 스타일 (실선)의 경우 null입니다.

리턴

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

승인

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

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

---

setFontColor(color)

범위 목록에 있는 각 Range의 글꼴 색상을 설정합니다. 색상은 CSS로 표현됩니다. 표기법 예를 들면 '#ffffff' 또는 'white'입니다.

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

매개변수

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

리턴

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

승인

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

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

---

setFontFamily(fontFamily)

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

var sheet = SpreadsheetApp.getActiveSheet();
var 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'입니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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의 글꼴 크기를 포인트 단위로 설정합니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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'

var sheet = SpreadsheetApp.getActiveSheet();
var 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'

var sheet = SpreadsheetApp.getActiveSheet();
var 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 표기법

var sheet = SpreadsheetApp.getActiveSheet();
var 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 표기법을 사용합니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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'입니다.

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

매개변수

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

리턴

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

승인

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

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

---

setNote(note)

범위 목록에 있는 각 Range의 메모 텍스트를 설정합니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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 날짜 및 숫자 형식 지정 가이드에 설명되어 있습니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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에 하이퍼링크를 표시할지 여부를 설정합니다.

var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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의 값을 설정합니다. 값은 숫자, 문자열, 부울 또는 날짜입니다. '='로 시작하는 경우 수식으로 해석됩니다.

var sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment("middle");

매개변수

이름	유형	설명
alignment	String	정렬('top', 'middle' 또는 'bottom') a 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var 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()

이 범위 목록의 모든 셀에서 공백 (예: 공백, 탭, 새 줄)을 자릅니다. 각 셀 텍스트의 시작과 끝에서 모든 공백을 삭제하고 모든 하위 시퀀스를 줄입니다. 나머지 공백 문자를 단일 공백으로 변환합니다.

<ph type="x-smartling-placeholder">

</ph> 참고: 잘린 최종 텍스트가 '+'로 시작하는 경우 또는 '=' 텍스트가 문자열 값으로 유지되고 수식으로 해석되지 않습니다.

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

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

var 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'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

리턴

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

승인

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

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