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