Class CheckboxGridItem

CheckboxGridItem

Es un elemento de 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 un Form. 

// Open a form by ID and add a new checkbox grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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étodoTipo de datos que se devuelveDescripción breve
clearValidation()CheckboxGridItemQuita cualquier validación de datos para este elemento de la cuadrícula.
createResponse(responses)ItemResponseCrea un objeto ItemResponse nuevo para este elemento de cuadrícula de casillas de verificación.
duplicate()CheckboxGridItemCrea 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()StringObtiene el texto de ayuda del elemento (a veces, se denomina texto de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).
getId()IntegerObtiene el identificador único del elemento.
getIndex()IntegerObtiene el índice del elemento entre todos los elementos del formulario.
getRows()String[]Obtiene los valores de cada fila de la cuadrícula.
getTitle()StringObtiene el título del elemento (a veces, se denomina texto del encabezado, en el caso de un SectionHeaderItem).
getType()ItemTypeObtiene el tipo del elemento, representado como un ItemType.
isRequired()BooleanDetermina si el encuestado debe responder la pregunta.
setColumns(columns)CheckboxGridItemEstablece las columnas de la cuadrícula según un array de valores.
setHelpText(text)CheckboxGridItemEstablece el texto de ayuda del elemento (a veces, se denomina texto de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).
setRequired(enabled)CheckboxGridItemEstablece si el encuestado debe responder la pregunta.
setRows(rows)CheckboxGridItemEstablece las filas de la cuadrícula según un array de valores.
setTitle(title)CheckboxGridItemEstablece el título del elemento (a veces, se denomina texto del encabezado, en el caso de un SectionHeaderItem).
setValidation(validation)CheckboxGridItemEstablece la validación de datos para este elemento de cuadrícula de casillas de verificación.

Documentación detallada

clearValidation()

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

Volver

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

createResponse(responses)

Crea un objeto ItemResponse nuevo para este elemento de cuadrícula de casillas de verificación. El argumento responses debe ser un array de arrays String[][] que contenga tantos valores como la cantidad de entradas en la cuadrícula de casillas de verificación. Un elemento null para una pregunta con estilo de cuadrícula de casillas de verificación no obligatoria indica que no hay respuesta para esa fila. Se arroja una excepción si alguno de los valores no coincide con una opción válida.

Parámetros

NombreTipoDescripción
responsesString[][]Es un array de arrays de respuestas válidas para este elemento de cuadrícula de casillas de verificación.

Volver

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

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 de cada columna de la cuadrícula.

Volver

String[]: Es un array de valores de columna que los encuestados ven como etiquetas cuando visualizan 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, se denomina texto de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).

Volver

String: Texto de ayuda o 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.

Volver

Integer: Es el ID 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

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 de cada fila de la cuadrícula.

Volver

String[]: Es un array de valores de filas que los encuestados ven como etiquetas cuando visualizan 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, se denomina texto del encabezado, en el caso de un SectionHeaderItem).

Volver

String: 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 un ItemType.

Volver

ItemType: Es 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 según un array de valores. Arroja una excepción si el array proporcionado está vacío.

Parámetros

NombreTipoDescripción
columnsString[]Es un array de valores de columna que los encuestados ven como etiquetas cuando visualizan el formulario.

Volver

CheckboxGridItem: Este elemento, para encadenar

Arroja

Error: Si el array proporcionado 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, se denomina texto de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).

Parámetros

NombreTipoDescripción
textStringEl 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

NombreTipoDescripción
enabledBooleanSi 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 según un array de valores. Arroja una excepción si el array proporcionado está vacío.

Parámetros

NombreTipoDescripción
rowsString[]Es un array de valores de filas que los encuestados ven como etiquetas cuando visualizan el formulario.

Volver

CheckboxGridItem: Este elemento, para encadenar

Arroja

Error: Si el array proporcionado 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, se denomina texto del encabezado, en el caso de un SectionHeaderItem).

Parámetros

NombreTipoDescripción
titleStringEl 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 cuadrícula de casillas de verificación. Si se pasa un valor nulo o una validación sin que se llame a ninguna función require, se quitará cualquier validación anterior.

Parámetros

NombreTipoDescripción
validationCheckboxGridValidationEs un CheckboxGridValidation que se 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