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

Class CheckboxGridItem

Elemento de una pregunta, presentado como una cuadrícula de columnas y filas, que permite al encuestado seleccionar varias opciones por fila a partir de una secuencia de casillas de verificación. Se puede acceder a los elementos o crearlos desde una 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 cualquier validación de datos para este elemento de la cuadrícula.
`createResponse(responses)`	`ItemResponse`	Crea un `ItemResponse` nuevo para este elemento de cuadrícula de la casilla de verificación.
`duplicate()`	`CheckboxGridItem`	Crea una copia de este elemento y la agrega al final del formulario.
`getColumns()`	`String[]`	Obtiene los valores de cada columna de la cuadrícula.
`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.
`getRows()`	`String[]`	Obtiene los valores de cada fila de la cuadrícula.
`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`.
`isRequired()`	`Boolean`	Determina si el encuestado debe responder la pregunta.
`setColumns(columns)`	`CheckboxGridItem`	Configura 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 descriptivo para 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 según 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 la casilla de verificación.

Documentación detallada

`clearValidation()`

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

Devolvedor

CheckboxGridItem: Este artículo, 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

`createResponse(responses)`

Crea un ItemResponse nuevo para este elemento de cuadrícula de la casilla de verificación. El argumento responses debe ser un array String[][] de arreglos que contengan tantos valores como la cantidad de entradas en la cuadrícula de la casilla de verificación. Un elemento null para una pregunta de cuadrícula con casillas de verificación no obligatoria indica que no hay respuesta para 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[][]`	una matriz de matrices de respuestas válidas para este elemento de la cuadrícula de la casilla de verificación

Devolvedor

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 agrega al final del formulario.

Devolvedor

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

`getColumns()`

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

Devolvedor

String[]: Es un array de valores de columna, que los encuestados ven como etiquetas cuando ven 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 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

`getRows()`

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

Devolvedor

String[]: Es un array de valores de fila, que los encuestados ven como etiquetas cuando ven 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 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

`isRequired()`

Determina si el encuestado debe responder la pregunta.

Devolvedor

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

Configura las columnas de la cuadrícula en función de un arreglo de valores. Muestra una excepción si el array dado está vacío.

Parámetros

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

Devolvedor

CheckboxGridItem: Este artículo, para encadenamiento

Arroja

Error: si el array dado está null o 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 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

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

`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

Devolvedor

CheckboxGridItem: Es el elemento actual (para el 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

`setRows(rows)`

Establece las filas de la cuadrícula según un arreglo de valores. Muestra una excepción si el array dado está vacío.

Parámetros

Nombre	Tipo	Descripción
`rows`	`String[]`	un array de valores de fila, que los encuestados ven como etiquetas al ver el formulario

Devolvedor

CheckboxGridItem: Este artículo, para encadenamiento

Arroja

Error: si el array dado está null o 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

Devolvedor

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

`setValidation(validation)`

Establece la validación de datos para este elemento de la cuadrícula de la casilla de verificación. Si pasas un valor nulo o una validación sin ninguna función obligatoria a las que se llame, se quitará cualquier validación anterior.

Parámetros

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

Devolvedor

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