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

Class CheckboxItem

Un elemento de pregunta que permite que el encuestado seleccione una o más casillas de verificación, así como un campo opcional (otro). Puedes acceder a los elementos o crearlos desde Form. Cuando se usan en un cuestionario, estos elementos se califican de forma automática.

// Open a form by ID and add a new checkbox item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
          item.createChoice('Ketchup'),
          item.createChoice('Mustard'),
          item.createChoice('Relish')
    ])
    .showOtherOption(true);

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`clearValidation()`	`CheckboxItem`	Quita cualquier validación de datos para este elemento de la casilla de verificación.
`createChoice(value)`	`Choice`	Crea una opción nueva.
`createChoice(value, isCorrect)`	`Choice`	Crea una opción nueva.
`createResponse(responses)`	`ItemResponse`	Crea un `ItemResponse` nuevo para este elemento de casilla de verificación.
`duplicate()`	`CheckboxItem`	Crea una copia de este elemento y la adjunta al final del formulario.
`getChoices()`	`Choice[]`	Obtiene todas las opciones de un elemento.
`getFeedbackForCorrect()`	`QuizFeedback`	Muestra los comentarios que se muestran a los encuestados cuando responden correctamente una pregunta.
`getFeedbackForIncorrect()`	`QuizFeedback`	Muestra los comentarios que se muestran a los encuestados cuando responden incorrectamente una pregunta.
`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.
`getPoints()`	`Integer`	Muestra la puntuación de un elemento calificable.
`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`.
`hasOtherOption()`	`Boolean`	Determina si el elemento tiene una opción "other".
`isRequired()`	`Boolean`	Determina si el encuestado debe responder la pregunta.
`setChoiceValues(values)`	`CheckboxItem`	Establece las opciones para un elemento a partir de un arreglo de strings.
`setChoices(choices)`	`CheckboxItem`	Establece una selección de opciones para un elemento.
`setFeedbackForCorrect(feedback)`	`CheckboxItem`	Establece que los comentarios se muestren a los encuestados cuando respondan correctamente una pregunta.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	Establece los comentarios que se mostrarán a los encuestados cuando respondan incorrectamente una pregunta.
`setHelpText(text)`	`CheckboxItem`	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`).
`setPoints(points)`	`CheckboxItem`	Establece la cantidad de puntos que vale un elemento calificado.
`setRequired(enabled)`	`CheckboxItem`	Establece si el encuestado debe responder la pregunta.
`setTitle(title)`	`CheckboxItem`	Establece el título del elemento (a veces llamado texto de encabezado, en el caso de `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxItem`	Establece la validación de datos para este elemento de la casilla de verificación.
`showOtherOption(enabled)`	`CheckboxItem`	Establece si el elemento tiene una opción “Otro”.

Documentación detallada

`clearValidation()`

Quita cualquier validación de datos para este elemento de la casilla de verificación.

Volver

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

`createChoice(value)`

Crea una opción nueva.

Parámetros

Nombre	Tipo	Descripción
`value`	`String`	el valor de la elección, que los encuestados consideran una etiqueta cuando consultan el formulario

Volver

Choice: La nueva opción

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

`createChoice(value, isCorrect)`

Crea una opción nueva.

Parámetros

Nombre	Tipo	Descripción
`value`	`String`	el valor de la elección, que los encuestados consideran una etiqueta cuando consultan el formulario
`isCorrect`	`Boolean`	si la elección es una respuesta correcta

Volver

Choice: La nueva opción

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 casilla de verificación. El argumento responses es un arreglo String[] que contiene valores que deben verificarse. Muestra una excepción si algún valor no coincide con una opción válida para este elemento, a menos que showOtherOption(enabled) esté configurado como true.

Parámetros

Nombre	Tipo	Descripción
`responses`	`String[]`	un arreglo de respuestas válidas para este elemento de opción múltiple

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

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

`getChoices()`

Obtiene todas las opciones de un elemento.

Volver

Choice[]: Es un arreglo de opciones.

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

`getFeedbackForCorrect()`

Muestra los comentarios que se muestran a los encuestados cuando responden correctamente una pregunta.

Volver

QuizFeedback: Los comentarios, si corresponde.

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

`getFeedbackForIncorrect()`

Muestra los comentarios que se muestran a los encuestados cuando responden incorrectamente una pregunta.

Volver

QuizFeedback: Los comentarios, si corresponde.

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

`getPoints()`

Muestra la puntuación de un elemento calificable.

Volver

Integer: la cantidad de puntos que vale una 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

`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

`hasOtherOption()`

Determina si el elemento tiene una opción "other".

Volver

Boolean: true si el elemento tiene la opción "otro"; si no, false

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

`setChoiceValues(values)`

Establece las opciones para un elemento a partir de un arreglo de strings. Genera una excepción si el arreglo está vacío.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parámetros

Nombre	Tipo	Descripción
`values`	`String[]`	la matriz de valores de las opciones, que los encuestados consideran etiquetas al visualizar el formulario

Volver

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

`setChoices(choices)`

Establece una selección de opciones para un elemento. Genera una excepción si el arreglo determinado está vacío o contiene un elemento null.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

Parámetros

Nombre	Tipo	Descripción
`choices`	`Choice[]`	un arreglo de opciones

Volver

CheckboxItem: este CheckboxItem, para encadenar

Arroja

Error: Si el arreglo dado es null, está vacío o contiene un elemento null

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

`setFeedbackForCorrect(feedback)`

Establece que los comentarios se muestren a los encuestados cuando respondan correctamente una pregunta.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());

Parámetros

Nombre	Tipo	Descripción
`feedback`	`QuizFeedback`	los nuevos comentarios. Un valor nulo borrará los comentarios.

Volver

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

`setFeedbackForIncorrect(feedback)`

Establece los comentarios que se mostrarán a los encuestados cuando respondan incorrectamente una pregunta.

Parámetros

Nombre	Tipo	Descripción
`feedback`	`QuizFeedback`	los nuevos comentarios

Volver

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

`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

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

`setPoints(points)`

Establece la cantidad de puntos que vale un elemento calificado. El valor predeterminado para los elementos nuevos es 0.

Parámetros

Nombre	Tipo	Descripción
`points`	`Integer`	la cantidad de puntos que vale un elemento de una pregunta

Volver

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

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

`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

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

Parámetros

Nombre	Tipo	Descripción
`validation`	`CheckboxValidation`	una casilla de verificación para aplicar a este elemento.

Volver

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

`showOtherOption(enabled)`

Establece si el elemento tiene una opción “Otro”. El valor predeterminado para un CheckboxItem o MultipleChoiceItem nuevo es false.

Parámetros

Nombre	Tipo	Descripción
`enabled`	`Boolean`	`true` si el elemento tiene una opción "other"; `false` si no es así

Volver

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