Class GridItem

GridItem

以項目和列格線呈現的問題項目,可讓作答者從一系列圓形按鈕選項中選取一個選項。可從 Form 存取或建立項目。

// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

方法

方法傳回類型簡短說明
clearValidation()GridItem移除這個格線項目的所有資料驗證。
createResponse(responses)ItemResponse為這個格線項目建立新的 ItemResponse
duplicate()GridItem建立這個項目的副本,然後附加到表單結尾。
getColumns()String[]取得格線中每個資料欄的值。
getHelpText()String取得商品的說明文字 (有時為版面配置項目的說明文字,例如 ImageItemsPageBreakItemsSectionHeaderItems)。
getId()Integer取得商品的專屬 ID。
getIndex()Integer取得表單中所有商品的索引。
getRows()String[]取得格線中每一列的值。
getTitle()String取得商品標題 (有時為 SectionHeaderItem 標頭)。
getType()ItemType取得項目類型,以 ItemType 表示。
isRequired()Boolean判斷作答者是否需要回答問題。
setColumns(columns)GridItem根據值陣列設定格線欄。
setHelpText(text)GridItem設定項目的說明文字 (有時是指 ImageItemsPageBreakItemsSectionHeaderItems 等版面配置項目的說明文字)。
setRequired(enabled)GridItem設定作答者是否需要回答問題。
setRows(rows)GridItem根據值陣列設定格線列。
setTitle(title)GridItem設定項目標題 (有時在 SectionHeaderItem 中稱為標題文字)。
setValidation(validation)GridItem設定這個格狀項目的資料驗證。

內容詳盡的說明文件

clearValidation()

移除這個格線項目的所有資料驗證。

Return 鍵

GridItem — 用於鏈結

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

createResponse(responses)

為這個格線項目建立新的 ItemResponse。引數 responses 必須是 String[] 陣列,其中包含格線中的列數。如果 null 元素是非必要的格線問題,表示該列沒有回應。如有任何值不符合有效的選項,則擲回例外狀況。

參數

名稱類型說明
responsesString[]這個格線項目的有效答案陣列

Return 鍵

ItemResponse:項目回應

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

duplicate()

建立這個項目的副本,然後附加到表單結尾。

Return 鍵

GridItem:與這個 GridItem 重複,用於鏈結

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

取得商品的說明文字 (有時為版面配置項目的說明文字,例如 ImageItemsPageBreakItemsSectionHeaderItems)。

Return 鍵

String:項目的說明文字或說明文字

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

getId()

取得商品的專屬 ID。

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

取得項目類型,以 ItemType 表示。

Return 鍵

ItemType:項目類型

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

isRequired()

判斷作答者是否需要回答問題。

Return 鍵

Boolean — 作答者必須回答問題

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

setColumns(columns)

根據值陣列設定格線欄。如果指定的陣列為空白,則擲回例外狀況。

參數

名稱類型說明
columnsString[]資料欄值陣列,作答者會在查看表單時將其顯示為標籤

Return 鍵

GridItem — 用於鏈結

擲回

Error — 如果指定的陣列為 null 或空白

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

setHelpText(text)

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

參數

名稱類型說明
textString新的說明文字

Return 鍵

GridItem — 這個 GridItem 用於鏈結

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

setRequired(enabled)

設定作答者是否需要回答問題。

參數

名稱類型說明
enabledBoolean作答者是否需要回答問題

Return 鍵

GridItem:目前的項目 (用於鏈結)

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

setRows(rows)

根據值陣列設定格線列。如果指定的陣列為空白,則擲回例外狀況。

參數

名稱類型說明
rowsString[]陣列列值,作答者會在查看表單時看見標籤值

Return 鍵

GridItem — 用於鏈結

擲回

Error — 如果指定的陣列為 null 或空白

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

setTitle(title)

設定項目標題 (有時在 SectionHeaderItem 中稱為標題文字)。

參數

名稱類型說明
titleString新的標題或標題文字

Return 鍵

GridItem — 這個 GridItem 用於鏈結

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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

setValidation(validation)

設定這個格狀項目的資料驗證。如果傳入空值或驗證,不需要使用任何呼叫函式即可移除任何先前的驗證。

參數

名稱類型說明
validationGridValidation要套用至這個項目的 GridValidation。

Return 鍵

GridItem — 這個 GridItem 用於鏈結

授權

如果指令碼使用這個方法,就必須符合下列一或多個範圍的授權:

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