Class PageBreakItem

頁面分頁項目

標示網頁起始處的版面配置項目。您可以透過 Form 存取或建立項目。

// Create a form and add three page-break items.
const form = FormApp.create('Form Name');
const pageTwo = form.addPageBreakItem().setTitle('Page Two');
const pageThree = form.addPageBreakItem().setTitle('Page Three');

// Make the first two pages navigate elsewhere upon completion.
pageTwo.setGoToPage(
    pageThree);  // At end of page one (start of page two), jump to page three
pageThree.setGoToPage(
    FormApp.PageNavigationType.RESTART);  // At end of page two, restart form

方法

方法傳回類型簡短說明
duplicate()PageBreakItem建立此項目的副本，並附加至表單結尾。
getGoToPage()PageBreakItem取得表單在完成本分頁符號之前的頁面後跳轉至的 PageBreakItem (也就是在表單中以一般線性進度到達這個分頁符號時)。
getHelpText()String取得項目的說明文字 (有時稱為版面配置項目的說明文字，例如 ImageItems、PageBreakItems 和 SectionHeaderItems)。
getId()Integer取得項目的專屬 ID。
getIndex()Integer取得表單中所有項目中的項目索引。
getPageNavigationType()PageNavigationType取得在這個分頁前完成網頁後，所發生的網頁導覽類型 (也就是透過表單的一般線性進展，到達這個分頁時)。
getTitle()String取得項目的標題 (在 SectionHeaderItem 的情況下，有時稱為標頭文字)。
getType()ItemType取得項目的類型，以 ItemType 表示。
setGoToPage(goToPageItem)PageBreakItem設定在完成此分頁前所跳轉的頁面 (也就是在透過表單的一般線性進度到達此分頁時)。
setGoToPage(navigationType)PageBreakItem設定在這個分頁前完成頁面後，所發生的頁面導覽類型 (也就是透過表單的一般線性進展，到達這個分頁時)。
setHelpText(text)PageBreakItem設定項目的說明文字 (對於 ImageItems、PageBreakItems 和 SectionHeaderItems 等版面配置項目，有時稱為說明文字)。
setTitle(title)PageBreakItem設定項目的標題 (在 SectionHeaderItem 的情況下，有時稱為標頭文字)。

內容詳盡的說明文件

duplicate()

建立此項目的副本，並附加至表單結尾。

回攻員

PageBreakItem：這個 PageBreakItem 的複本，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

getGoToPage()

取得表單在完成本分頁符號之前的頁面後跳轉至的 PageBreakItem (也就是在表單中以一般線性進度到達這個分頁符號時)。

回攻員

PageBreakItem：在這個分頁符號之前完成頁面後，要跳轉的分頁符號，如果未設定，則為 null

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

取得項目的專屬 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

getPageNavigationType()

取得在這個分頁前完成網頁後，所發生的網頁導覽類型 (也就是透過表單的一般線性進展，到達這個分頁時)。

回攻員

PageNavigationType：在這個分頁符號前完成網頁後，要採取的導覽動作

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • 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

setGoToPage(goToPageItem)

設定在完成此分頁前所屬頁面之後，要跳轉至的頁面 (也就是在透過表單的一般線性進度到達此分頁時)。如果先前頁面包含 MultipleChoiceItem 或 ListItem，且含有導覽選項，則該導覽會覆寫此導覽。

參數

名稱類型說明
goToPageItemPageBreakItem在這個分頁符號前完成的頁面後，要跳轉至的分頁符號

回攻員

PageBreakItem — 這個 PageBreakItem，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

setGoToPage(navigationType)

設定在這個分頁前完成頁面後，所發生的頁面導覽類型 (也就是透過表單的一般線性進展，到達這個分頁時)。如果頁面包含含有導覽選項的 MultipleChoiceItem 或 ListItem，則該導覽會覆寫此導覽。

參數

名稱類型說明
navigationTypePageNavigationType在這個頁面結束前完成頁面後採取的導覽動作

回攻員

PageBreakItem — 這個 PageBreakItem，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

setHelpText(text)

設定項目的說明文字 (對於 ImageItems、PageBreakItems 和 SectionHeaderItems 等版面配置項目，有時稱為說明文字)。

參數

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

回攻員

PageBreakItem — 這個 PageBreakItem，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

setTitle(title)

設定項目的標題 (在 SectionHeaderItem 的情況下，有時稱為標頭文字)。

參數

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

回攻員

PageBreakItem — 這個 PageBreakItem，用於鏈結

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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