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取得項目的說明文字 (有時稱為 ImageItemsPageBreakItemsSectionHeaderItems 等版面配置項目的說明文字)。
getId()Integer取得項目的專屬 ID。
getIndex()Integer取得表單中所有項目的索引。
getRows()String[]取得格狀檢視畫面中每列的值。
getTitle()String取得項目的標題 (在 SectionHeaderItem 中則稱為標題文字)。
getType()ItemType取得項目的類型,以 ItemType 表示。
isRequired()Boolean決定作答者是否必須回答問題。
setColumns(columns)CheckboxGridItem根據值陣列設定格線的資料欄。
setHelpText(text)CheckboxGridItem設定項目的說明文字 (有時稱為 ImageItemsPageBreakItemsSectionHeaderItems 等版面配置項目的說明文字)。
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()

取得項目的說明文字 (有時稱為 ImageItemsPageBreakItemsSectionHeaderItems 等版面配置項目的說明文字)。

回攻員

String:商品的說明文字或說明文字

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

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

getId()

取得項目的專屬 ID。

回攻員

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)

設定項目的說明文字 (有時稱為 ImageItemsPageBreakItemsSectionHeaderItems 等版面配置項目的說明文字)。

參數

名稱類型說明
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)

設定這個核取方塊格線項目的資料驗證。如果您傳入空值或驗證,而未呼叫任何必要函式,系統將移除任何先前的驗證。

參數

名稱類型說明
validationCheckboxGridValidation需要套用至這個項目的 CheckboxGridValidation。

回攻員

CheckboxGridItem — 此 CheckboxGridItem,用於鏈結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

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