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

Class CheckboxGridItem

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

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`clearValidation()`	`CheckboxGridItem`	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 de casillas de verificación.
`duplicate()`	`CheckboxGridItem`	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)`	`CheckboxGridItem`	Establece las columnas de la cuadrícula en función de un arreglo de valores.
`setHelpText(text)`	`CheckboxGridItem`	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)`	`CheckboxGridItem`	Establece si el encuestado debe responder la pregunta.
`setRows(rows)`	`CheckboxGridItem`	Establece las filas de la cuadrícula en función de un arreglo de valores.
`setTitle(title)`	`CheckboxGridItem`	Establece el título del elemento (a veces llamado texto de encabezado, en el caso de `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxGridItem`	Establece la validación de datos para este elemento de la cuadrícula de casillas de verificación.

Documentación detallada

`clearValidation()`

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

Volver

CheckboxGridItem: 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 de casillas de verificación. El argumento responses debe ser un arreglo String[][] de arreglos que contenga tantos valores como el número de entradas en la cuadrícula de la casilla de verificación. Un elemento null para una pregunta de cuadrícula de casilla de verificación no obligatoria indica que no hay respuesta a esa fila. Muestra 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 casilla de verificación

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

CheckboxGridItem: Es un duplicado de este CheckboxGridItem 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

CheckboxGridItem: 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

CheckboxGridItem: este CheckboxGridItem, 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

CheckboxGridItem: 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

CheckboxGridItem: 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

CheckboxGridItem: este CheckboxGridItem, 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 de casillas de verificación. Si pasas un valor nulo o una validación sin cualquier función requerida, se quitará la validación anterior.

Parámetros

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

Volver

CheckboxGridItem: este CheckboxGridItem, 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