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

Class CheckboxItem

Pregunta que permite que el encuestado seleccione una o más casillas de verificación, así como una opcional “otro” . Se puede acceder a los elementos o crearlos desde un Form. Cuando se usa en un cuestionario, estos elementos se califican automáticamente.

// 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 la casilla de verificación.
`duplicate()`	`CheckboxItem`	Crea una copia de este elemento y la agrega al final del formulario.
`getChoices()`	`Choice[]`	Obtiene todas las opciones de un elemento.
`getFeedbackForCorrect()`	`QuizFeedback`	Devuelve el feedback que se muestra a los encuestados cuando responden correctamente a una pregunta.
`getFeedbackForIncorrect()`	`QuizFeedback`	Devuelve el feedback que se muestra a los encuestados cuando responden una pregunta de forma incorrecta.
`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.
`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 un `ItemType`.
`hasOtherOption()`	`Boolean`	Determina si el elemento tiene un atributo "otro". de 12 a 1 con la nueva opción de compresión.
`isRequired()`	`Boolean`	Determina si el encuestado debe responder la pregunta.
`setChoiceValues(values)`	`CheckboxItem`	Establece las opciones para un elemento a partir de un array de cadenas.
`setChoices(choices)`	`CheckboxItem`	Establece un array de opciones para un elemento.
`setFeedbackForCorrect(feedback)`	`CheckboxItem`	Establece los comentarios que se mostrarán a los encuestados cuando respondan correctamente a una pregunta.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	Permite mostrar los comentarios a los encuestados cuando responden una pregunta de forma incorrecta.
`setHelpText(text)`	`CheckboxItem`	Establece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como `ImageItems`, `PageBreakItems` y `SectionHeaderItems`).
`setPoints(points)`	`CheckboxItem`	Establece la cantidad de puntos que vale un elemento con calificación.
`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 un `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 un atributo "otro" de 12 a 1 con la nueva opción de compresión.

Documentación detallada

`clearValidation()`

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

Volver

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

`createChoice(value)`

Crea una opción nueva.

Parámetros

Nombre	Tipo	Descripción
`value`	`String`	el valor de la opción, que los encuestados verán como una etiqueta al revisar 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 opción, que los encuestados verán como una etiqueta al revisar el formulario.
`isCorrect`	`Boolean`	si la opció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 la casilla de verificación. El argumento responses es un Array String[] que contiene valores que se deben verificar. Muestra una excepción si existe alguna. no coincide con una opción válida para este elemento, a menos que showOtherOption(enabled) se establezca como true.

Parámetros

Nombre	Tipo	Descripción
`responses`	`String[]`	un array 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 agrega al final del formulario.

Volver

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

`getChoices()`

Obtiene todas las opciones de un elemento.

Volver

Choice[]: Es un array 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()`

Devuelve el feedback que se muestra a los encuestados cuando responden correctamente a una pregunta.

Volver

QuizFeedback: Son 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()`

Devuelve el feedback que se muestra a los encuestados cuando responden una pregunta de forma incorrecta.

Volver

QuizFeedback: Son 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 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

`getPoints()`

Muestra la puntuación de un elemento calificable.

Volver

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

`hasOtherOption()`

Determina si el elemento tiene un atributo "otro". de 12 a 1 con la nueva opción de compresión.

Volver

Boolean: true si el elemento tiene un valor "otro" opción; false si no es así

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 array de cadenas. Muestra una excepción si el array dado 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[]`	el array de valores de opción, que los encuestados ven como etiquetas cuando ven el formulario.

Volver

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

`setChoices(choices)`

Establece un array de opciones para un elemento. Muestra una excepción si el array dado 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 array de opciones

Volver

CheckboxItem: este CheckboxItem, para encadenamiento

Arroja

Error: Si el array 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 los comentarios que se mostrarán a los encuestados cuando respondan correctamente a 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`	el nuevo feedback. Un valor nulo borrará los comentarios.

Volver

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

`setFeedbackForIncorrect(feedback)`

Permite mostrar los comentarios a los encuestados cuando responden una pregunta de forma incorrecta.

Parámetros

Nombre	Tipo	Descripción
`feedback`	`QuizFeedback`	el nuevo comentario

Volver

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

`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

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

`setPoints(points)`

Establece la cantidad de puntos que vale un elemento con calificación. 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 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

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

`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

CheckboxItem: este CheckboxItem, 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 casilla de verificación. Pasar un valor nulo o una validación sin ningún Requerir funciones llamadas quitará cualquier validación previa.

Parámetros

Nombre	Tipo	Descripción
`validation`	`CheckboxValidation`	una CheckboxValidation que se aplicará a este elemento.

Volver

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

`showOtherOption(enabled)`

Establece si el elemento tiene un atributo "otro" de 12 a 1 con la nueva opción de compresión. El valor predeterminado para un objeto CheckboxItem nuevo MultipleChoiceItem es false.

Parámetros

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

Volver

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