Class CheckboxGridItem

CheckboxGridItem

열과 행의 그리드로 표시되는 질문 항목으로, 응답자가 체크박스 시퀀스에서 행당 여러 선택 항목을 선택할 수 있습니다. 항목은 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()ItemTypeItemType로 표시되는 항목의 유형을 가져옵니다.
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()

이 그리드 항목의 데이터 유효성 검사를 삭제합니다.

리턴

CheckboxGridItem: 연결용 항목

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

createResponse(responses)

이 체크박스 그리드 항목의 새 ItemResponse를 만듭니다. responses 인수는 체크박스 그리드의 입력 수만큼 많은 값을 포함하는 배열의 String[][] 배열이어야 합니다. 필수가 아닌 체크박스 그리드 질문에 대한 null 요소는 해당 행에 응답이 없음을 나타냅니다. 값 중 하나라도 유효한 선택과 일치하지 않으면 예외가 발생합니다.

매개변수

이름유형설명
responsesString[][]이 체크박스 그리드 항목에 유효한 답변의 배열

리턴

ItemResponse: 항목 응답

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

duplicate()

이 항목의 사본을 만들어 양식 끝에 추가합니다.

리턴

CheckboxGridItem: 연결을 위해 이 CheckboxGridItem의 복제본입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getColumns()

그리드에 있는 모든 열의 값을 가져옵니다.

리턴

String[]: 열 값의 배열로, 응답자가 양식을 볼 때 라벨로 표시됩니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getHelpText()

항목의 도움말 텍스트 (ImageItems, PageBreakItems, SectionHeaderItems와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 가져옵니다.

리턴

String: 항목의 도움말 텍스트 또는 설명 텍스트

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getId()

항목의 고유 식별자를 가져옵니다.

리턴

Integer: 항목의 ID

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getIndex()

양식의 모든 항목 중에서 항목의 색인을 가져옵니다.

리턴

Integer: 항목의 색인

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getRows()

그리드에 있는 모든 행의 값을 가져옵니다.

리턴

String[]: 응답자가 양식을 볼 때 라벨로 표시되는 행 값의 배열입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getTitle()

항목의 제목을 가져옵니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).

리턴

String: 항목의 제목 또는 헤더 텍스트

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

getType()

ItemType로 표시되는 항목의 유형을 가져옵니다.

리턴

ItemType: 항목의 유형

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

isRequired()

응답자가 질문에 반드시 답변해야 하는지 여부를 결정합니다.

리턴

Boolean: 응답자가 질문에 답변해야 하는지 여부

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setColumns(columns)

값의 배열을 기반으로 그리드의 열을 설정합니다. 지정된 배열이 비어 있으면 예외가 발생합니다.

매개변수

이름유형설명
columnsString[]응답자가 양식을 볼 때 라벨로 보는 열 값의 배열

리턴

CheckboxGridItem: 연결용 항목

생성 값

Error: 지정된 배열이 null이거나 비어 있는 경우

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setHelpText(text)

항목의 도움말 텍스트 (ImageItems, PageBreakItems, SectionHeaderItems와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다.

매개변수

이름유형설명
textString새 도움말 텍스트

리턴

CheckboxGridItem: 이 CheckboxGridItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setRequired(enabled)

응답자가 질문에 반드시 답변해야 하는지 여부를 설정합니다.

매개변수

이름유형설명
enabledBoolean응답자가 질문에 답변해야 하는지 여부

리턴

CheckboxGridItem: 현재 항목 (체이닝용)

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setRows(rows)

값의 배열을 기반으로 그리드의 행을 설정합니다. 지정된 배열이 비어 있으면 예외가 발생합니다.

매개변수

이름유형설명
rowsString[]응답자가 양식을 볼 때 라벨로 보는 행 값의 배열

리턴

CheckboxGridItem: 연결용 항목

생성 값

Error: 지정된 배열이 null이거나 비어 있는 경우

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setTitle(title)

항목의 제목을 설정합니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).

매개변수

이름유형설명
titleString새 제목 또는 헤더 텍스트

리턴

CheckboxGridItem: 이 CheckboxGridItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setValidation(validation)

이 체크박스 그리드 항목의 데이터 유효성 검사를 설정합니다. 필수 함수 없이 null 또는 유효성 검사를 전달하면 이전 유효성 검사가 삭제됩니다.

매개변수

이름유형설명
validationCheckboxGridValidation이 항목에 적용할 CheckboxGridValidation.

리턴

CheckboxGridItem: 이 CheckboxGridItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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