Es un elemento de diseño que marca el inicio de una página. Se puede acceder a los elementos o crearlos desde una Form
.
// Create a form and add three page-break items. var form = FormApp.create('Form Name'); var pageTwo = form.addPageBreakItem().setTitle('Page Two'); var 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
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
duplicate() | PageBreakItem | Crea una copia de este elemento y la agrega al final del formulario. |
getGoToPage() | PageBreakItem | Obtiene el PageBreakItem al que dirigirá el formulario después de completar la página antes de este salto de página (es decir, cuando llega a este salto de página mediante una progresión lineal normal a través del formulario). |
getHelpText() | String | Obtiene el texto de ayuda del elemento (a veces llamado texto descriptivo para los elementos de diseño, como ImageItems , PageBreakItems y SectionHeaderItems ). |
getId() | Integer | Obtiene el identificador único del elemento. |
getIndex() | Integer | Obtiene el índice del elemento entre todos los elementos del formulario. |
getPageNavigationType() | PageNavigationType | Obtiene el tipo de navegación de página que se produce después de completar la página antes de este salto de página (es decir, al llegar a este salto de página mediante una progresión lineal normal a través del formulario). |
getTitle() | String | Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de SectionHeaderItem ). |
getType() | ItemType | Obtiene el tipo del elemento, representado como ItemType . |
setGoToPage(goToPageItem) | PageBreakItem | Configura la página al que se saltará después de completarla antes de este salto de página (es decir, al llegar a este salto de página mediante una progresión lineal normal a través del formulario). |
setGoToPage(navigationType) | PageBreakItem | Establece el tipo de navegación de página que se produce después de completar la página antes de este salto de página (es decir, al llegar a este salto de página mediante una progresión lineal normal a través del formulario). |
setHelpText(text) | PageBreakItem | Establece el texto de ayuda del elemento (a veces llamado texto descriptivo para elementos de diseño, como ImageItems , PageBreakItems y SectionHeaderItems ). |
setTitle(title) | PageBreakItem | Establece el título del elemento (a veces llamado texto de encabezado, en el caso de SectionHeaderItem ). |
Documentación detallada
duplicate()
Crea una copia de este elemento y la agrega al final del formulario.
Devolvedor
PageBreakItem
: Es un duplicado de este PageBreakItem
para encadenamiento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGoToPage()
Obtiene el PageBreakItem
al que dirigirá el formulario después de completar la página antes de este salto de página (es decir, cuando llega a este salto de página mediante una progresión lineal normal a través del formulario).
Devolvedor
PageBreakItem
: Es el salto de página al que se debe ir después de completar la página antes de este salto de página, o bien null
si no se establece ninguno.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Obtiene el texto de ayuda del elemento (a veces llamado texto descriptivo para los elementos de diseño, como ImageItems
, PageBreakItems
y SectionHeaderItems
).
Devolvedor
String
: Es el texto de ayuda o la descripción del elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Obtiene el identificador único del elemento.
Devolvedor
Integer
: Es el ID del artículo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Obtiene el índice del elemento entre todos los elementos del formulario.
Devolvedor
Integer
: Es el índice del elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de SectionHeaderItem
).
Devolvedor
String
: Es el título o texto del encabezado del elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Obtiene el tipo del elemento, representado como ItemType
.
Devolvedor
ItemType
: Es el tipo de elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGoToPage(goToPageItem)
Configura la página al que se saltará después de completarla antes de este salto de página (es decir, al llegar a este salto de página mediante una progresión lineal normal a través del formulario). Si la página anterior contenía un MultipleChoiceItem
o un ListItem
con una opción de navegación, esa navegación prevalecerá.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
goToPageItem | PageBreakItem | el salto de página al que apunta después de completar la página antes de este salto de página |
Devolvedor
PageBreakItem
: Este PageBreakItem
, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Establece el texto de ayuda del elemento (a veces llamado texto descriptivo para elementos de diseño, como ImageItems
, PageBreakItems
y SectionHeaderItems
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | el nuevo texto de ayuda |
Devolvedor
PageBreakItem
: Este PageBreakItem
, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Establece el título del elemento (a veces llamado texto de encabezado, en el caso de SectionHeaderItem
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | el nuevo título o texto del encabezado |
Devolvedor
PageBreakItem
: Este PageBreakItem
, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms