응답자가 체크박스 시퀀스에서 행당 여러 개 선택지를 선택할 수 있는 열과 행의 그리드로 표시되는 질문 항목입니다. Form
에서 항목에 액세스하거나 이를 만들 수 있습니다.
// Open a form by ID and add a new checkgox grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Years?') .setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
clearValidation() | CheckboxGridItem | 이 그리드 항목의 데이터 확인을 삭제합니다. |
createResponse(responses) | ItemResponse | 이 체크박스 그리드 항목의 새 ItemResponse 를 만듭니다. |
duplicate() | CheckboxGridItem | 이 항목의 사본을 만들어 양식 끝에 추가합니다. |
getColumns() | String[] | 그리드의 모든 열에 대한 값을 가져옵니다. |
getHelpText() | String | 항목의 도움말 텍스트 (ImageItems , PageBreakItems , SectionHeaderItems 와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 가져옵니다. |
getId() | Integer | 항목의 고유 식별자를 가져옵니다. |
getIndex() | Integer | 양식의 모든 항목 중에서 항목의 색인을 가져옵니다. |
getRows() | String[] | 그리드의 모든 행의 값을 가져옵니다. |
getTitle() | String | 항목의 제목을 가져옵니다 (SectionHeaderItem 의 경우 헤더 텍스트라고도 함). |
getType() | ItemType | ItemType 으로 표시되는 항목 유형을 가져옵니다. |
isRequired() | Boolean | 응답자가 질문에 답해야 하는지 여부를 결정합니다. |
setColumns(columns) | CheckboxGridItem | 값 배열을 기반으로 그리드의 열을 설정합니다. |
setHelpText(text) | CheckboxGridItem | 항목의 도움말 텍스트 (ImageItems , PageBreakItems , SectionHeaderItems 와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다. |
setRequired(enabled) | CheckboxGridItem | 응답자가 질문에 답해야 하는지 여부를 설정합니다. |
setRows(rows) | CheckboxGridItem | 값 배열을 기반으로 그리드의 행을 설정합니다. |
setTitle(title) | CheckboxGridItem | 항목의 제목을 설정합니다 (SectionHeaderItem 의 경우 헤더 텍스트라고도 함). |
setValidation(validation) | CheckboxGridItem | 이 체크박스 그리드 항목의 데이터 검증을 설정합니다. |
자세한 문서
clearValidation()
이 그리드 항목의 데이터 확인을 삭제합니다.
Return
CheckboxGridItem
— 이 항목(체이닝용)
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
이 체크박스 그리드 항목의 새 ItemResponse
를 만듭니다. responses
인수는 체크박스 그리드의 입력 수만큼의 값이 포함된 배열의 String[][]
배열이어야 합니다. 필수 체크박스 그리드 질문에 대한 null
요소는 해당 행에 대한 응답이 없음을 나타냅니다. 값 중 하나라도 유효한 선택 항목과 일치하지 않으면 예외가 발생합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
responses | String[][] | 이 체크박스 그리드 항목의 유효한 답변 배열 |
Return
ItemResponse
— 항목 응답
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
이 항목의 사본을 만들어 양식 끝에 추가합니다.
Return
CheckboxGridItem
: 이 CheckboxGridItem
의 중복으로, 체인용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
그리드의 모든 열에 대한 값을 가져옵니다.
Return
String[]
: 응답자가 양식을 볼 때 라벨로 표시하는 열 값의 배열입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
항목의 도움말 텍스트 (ImageItems
, PageBreakItems
, SectionHeaderItems
와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 가져옵니다.
Return
String
: 항목의 도움말 텍스트 또는 설명 텍스트
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
항목의 고유 식별자를 가져옵니다.
Return
Integer
: 항목 ID
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
양식의 모든 항목 중에서 항목의 색인을 가져옵니다.
Return
Integer
: 항목의 색인
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRows()
그리드의 모든 행의 값을 가져옵니다.
Return
String[]
: 응답자가 양식을 볼 때 라벨로 표시하는 행 값의 배열입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
항목의 제목을 가져옵니다 (SectionHeaderItem
의 경우 헤더 텍스트라고도 함).
Return
String
— 항목의 제목 또는 헤더 텍스트입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
isRequired()
응답자가 질문에 답해야 하는지 여부를 결정합니다.
Return
Boolean
: 응답자가 질문에 답해야 하는지 여부
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
값 배열을 기반으로 그리드의 열을 설정합니다. 지정된 배열이 비어 있으면 예외가 발생합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
columns | String[] | 응답자가 양식을 볼 때 라벨로 표시하는 열 값의 배열 |
Return
CheckboxGridItem
— 이 항목(체이닝용)
예외 처리
Error
: 지정된 배열이 null
이거나 비어 있는 경우
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
항목의 도움말 텍스트 (ImageItems
, PageBreakItems
, SectionHeaderItems
와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 새 도움말 텍스트 |
Return
CheckboxGridItem
: 이 CheckboxGridItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
응답자가 질문에 답해야 하는지 여부를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
enabled | Boolean | 응답자가 질문에 답변해야 하는지 여부 |
Return
CheckboxGridItem
: 현재 항목 (체이닝용)
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
값 배열을 기반으로 그리드의 행을 설정합니다. 지정된 배열이 비어 있으면 예외가 발생합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
rows | String[] | 응답자가 양식을 볼 때 라벨로 표시하는 행 값의 배열입니다. |
Return
CheckboxGridItem
— 이 항목(체이닝용)
예외 처리
Error
: 지정된 배열이 null
이거나 비어 있는 경우
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
항목의 제목을 설정합니다 (SectionHeaderItem
의 경우 헤더 텍스트라고도 함).
매개변수
이름 | 유형 | 설명 |
---|---|---|
title | String | 새 제목 또는 헤더 텍스트 |
Return
CheckboxGridItem
: 이 CheckboxGridItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
이 체크박스 그리드 항목의 데이터 검증을 설정합니다. 호출된 함수 없이 null 또는 검증을 전달하면 이전의 모든 검증이 삭제됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
validation | CheckboxGridValidation | 이 항목에 적용할 CheckboxGridValidation입니다. |
Return
CheckboxGridItem
: 이 CheckboxGridItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms