Se usó la API de Cloud Translation para traducir esta página.

Class GridItem

Un elemento de pregunta, presentado como una cuadrícula de columnas y filas, que permite a los encuestados seleccionar una opción por fila de una secuencia de botones de selección Se puede acceder a los elementos o crearlos desde un 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']);

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`clearValidation()`	`GridItem`	Quita toda validación de datos de este elemento de la cuadrícula.
`createResponse(responses)`	`ItemResponse`	Crea un `ItemResponse` nuevo para este elemento de la cuadrícula.
`duplicate()`	`GridItem`	Crea una copia de este elemento y la adjunta al final del formulario.
`getColumns()`	`String[]`	Obtiene los valores para cada columna de la cuadrícula.
`getHelpText()`	`String`	Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para los elementos de diseño, como `ImageItems`, `PageBreakItems` y `SectionHeaderItems`).
`getId()`	`Integer`	Obtiene el identificador único del artículo.
`getIndex()`	`Integer`	Obtiene el índice del elemento entre todos los elementos del formulario.
`getRows()`	`String[]`	Obtiene los valores para cada fila de la cuadrícula.
`getTitle()`	`String`	Obtiene el título del elemento (a veces llamado texto de encabezado, en el caso de un `SectionHeaderItem`).
`getType()`	`ItemType`	Obtiene el tipo del elemento, representado como `ItemType`.
`isRequired()`	`Boolean`	Determina si el encuestado debe responder la pregunta.
`setColumns(columns)`	`GridItem`	Establece las columnas de la cuadrícula en función de un arreglo de valores.
`setHelpText(text)`	`GridItem`	Establece el texto de ayuda del elemento (a veces llamado texto de descripción para los elementos de diseño, como `ImageItems`, `PageBreakItems` y `SectionHeaderItems`).
`setRequired(enabled)`	`GridItem`	Establece si el encuestado debe responder la pregunta.
`setRows(rows)`	`GridItem`	Establece las filas de la cuadrícula en función de un arreglo de valores.
`setTitle(title)`	`GridItem`	Establece el título del elemento (a veces llamado texto de encabezado, en el caso de `SectionHeaderItem`).
`setValidation(validation)`	`GridItem`	Establece la validación de datos para este elemento de la cuadrícula.

Documentación detallada

`clearValidation()`

Quita toda validación de datos de este elemento de la cuadrícula.

Volver

GridItem: Este elemento se usa para cadenas

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

`createResponse(responses)`

Crea un ItemResponse nuevo para este elemento de la cuadrícula. El argumento responses debe ser un arreglo String[] que contenga tantos valores como el número de filas en la cuadrícula. Un elemento null para una pregunta de cuadrícula no obligatoria indica que no hay respuesta a esa fila. Genera una excepción si alguno de los valores no coincide con una opción válida.

Parámetros

Nombre	Tipo	Descripción
`responses`	`String[]`	un arreglo de respuestas válidas para este elemento de la cuadrícula

Volver

ItemResponse: Es la respuesta 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

`duplicate()`

Crea una copia de este elemento y la adjunta al final del formulario.

Volver

GridItem: Es un duplicado de este GridItem para encadenar

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

`getColumns()`

Obtiene los valores para cada columna de la cuadrícula.

Volver

String[]: Es un arreglo de valores de columna, que los encuestados ven como etiquetas cuando consultan el formulario.

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 de descripción para los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).

Volver

String: el texto de ayuda o el texto de 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 artículo.

Volver

Integer: 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.

Volver

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

`getRows()`

Obtiene los valores para cada fila de la cuadrícula.

Volver

String[]: Es un arreglo de valores de fila que los encuestados pueden ver como etiquetas cuando consultan el formulario.

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 de encabezado, en el caso de un SectionHeaderItem).

Volver

String: el título o el 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.

Volver

ItemType: el tipo 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

`isRequired()`

Determina si el encuestado debe responder la pregunta.

Volver

Boolean: Indica si el encuestado debe responder la pregunta.

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

`setColumns(columns)`

Establece las columnas de la cuadrícula en función de un arreglo de valores. Genera una excepción si el arreglo está vacío.

Parámetros

Nombre	Tipo	Descripción
`columns`	`String[]`	un arreglo de valores de columna, que los encuestados ven como etiquetas al visualizar el formulario

Volver

GridItem: Este elemento se usa para cadenas

Arroja

Error: Si el arreglo especificado es null o está vacío

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 de descripción para los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).

Parámetros

Nombre	Tipo	Descripción
`text`	`String`	el nuevo texto de ayuda

Volver

GridItem: este GridItem, para encadenar

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

`setRequired(enabled)`

Establece si el encuestado debe responder la pregunta.

Parámetros

Nombre	Tipo	Descripción
`enabled`	`Boolean`	si el encuestado debe responder la pregunta

Volver

GridItem: Es el elemento actual (para encadenar).

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

`setRows(rows)`

Establece las filas de la cuadrícula en función de un arreglo de valores. Genera una excepción si el arreglo está vacío.

Parámetros

Nombre	Tipo	Descripción
`rows`	`String[]`	un arreglo de valores de fila, que los encuestados consideran etiquetas al visualizar el formulario

Volver

GridItem: Este elemento se usa para cadenas

Arroja

Error: Si el arreglo especificado es null o está vacío

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

Volver

GridItem: este GridItem, para encadenar

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

`setValidation(validation)`

Establece la validación de datos para este elemento de la cuadrícula. Si pasas un valor nulo o una validación sin ninguna función requerida, se quitará la validación anterior.

Parámetros

Nombre	Tipo	Descripción
`validation`	`GridValidation`	una GridValidation para aplicar a este elemento.

Volver

GridItem: este GridItem, para encadenar

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