동일한 시트에 있는 하나 이상의 Range
인스턴스 모음입니다. 이 클래스를 사용하여
인접하지 않은 범위나 셀 모음에 작업을 적용합니다.
메서드
자세한 문서
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()
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">
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
참고 항목
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