Una pregunta, presentada como una cuadrícula de columnas y filas, que permite que el encuestado seleccione
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 para cada columna de la cuadrícula. |
getHelpText() | String | Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para 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 en 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 un 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 array de valores. |
setHelpText(text) | CheckboxGridItem | Establece el texto de ayuda del elemento (a veces llamado texto de descripción 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 en función de un array de valores. |
setTitle(title) | CheckboxGridItem | Establece el título del elemento (a veces llamado texto de encabezado, en el caso de un SectionHeaderItem ). |
setValidation(validation) | CheckboxGridItem | Establece la validación de datos para este elemento de 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.
Volver
CheckboxGridItem
: este elemento 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
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 arrays 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 cuadrícula de casillas de verificación no obligatoria
indica que no hay respuesta para esa fila. Arroja una excepción si alguno de los valores no coincide con un
es una elección válida.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
responses | String[][] | un array de respuestas válidas para este elemento de cuadrícula 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 agrega al final del formulario.
Volver
CheckboxGridItem
: Es un duplicado de este CheckboxGridItem
, 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
getColumns()
Obtiene los valores para cada columna de la cuadrícula.
Volver
String[]
: Es un array de valores de columna, que las personas 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 de descripción para elementos de diseño como ImageItems
, PageBreakItems
y SectionHeaderItems
).
Volver
String
: Es el 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 en la cuadrícula.
Volver
String[]
: Es un array de valores de fila, que las personas 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 de encabezado, en el caso de un SectionHeaderItem
).
Volver
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 un ItemType
.
Volver
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.
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 array de valores. Arroja una excepción si el valor proporcionado el array 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. |
Volver
CheckboxGridItem
: este elemento para el encadenamiento
Arroja
Error
: Si el array dado 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 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 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 |
Volver
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 en función de un array 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 verán como etiquetas cuando visualicen el formulario. |
Volver
CheckboxGridItem
: este elemento para el encadenamiento
Arroja
Error
: Si el array dado 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 un SectionHeaderItem
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | el nuevo título o texto del encabezado |
Volver
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 y cualquier función requerida a la que se llame quitará cualquier validación previa.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
validation | CheckboxGridValidation | una CheckboxGridValidation que se aplicará a este elemento. |
Volver
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