Class Browser

Navegador

Esta clase proporciona acceso a cuadros de diálogo específicos de Hojas de cálculo de Google.

Los métodos de esta clase solo están disponibles para usarse en el contexto de una hoja de cálculo de Google. En su lugar, usa los diálogos de Google Workspace.

Consulta también

• ButtonSet

Propiedades

Propiedad	Tipo	Descripción
Buttons	ButtonSet

Métodos

Método	Tipo de datos que se devuelve	Descripción breve
inputBox(prompt)	String|null	Aparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.
inputBox(prompt, buttons)	String|null	Aparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.
inputBox(title, prompt, buttons)	String|null	Aparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.
msgBox(prompt)	String|null	Aparece un cuadro de diálogo con el mensaje determinado y un botón Aceptar en el navegador del usuario.
msgBox(prompt, buttons)	String|null	Aparece un cuadro de diálogo con el mensaje determinado y los botones especificados en el navegador del usuario.
msgBox(title, prompt, buttons)	String|null	Aparece un cuadro de diálogo con el título, el mensaje y los botones especificados en el navegador del usuario.

Documentación detallada

inputBox(prompt)

Aparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.

El método inputBox genera un cuadro de entrada del lado del cliente que muestra el mensaje determinado al usuario. Ten en cuenta que esta función hace que se suspenda la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones JDBC no persisten durante la suspensión.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');

No se recomienda este método. En su lugar, usa un mensaje de la IU.

Parámetros

Nombre	Tipo	Descripción
prompt	String	Es el texto que se mostrará en el cuadro de diálogo.

Volver

String|null: Es el texto que ingresó el usuario (o "cancelar" para un diálogo cancelado o descartado).

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

inputBox(prompt, buttons)

Aparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.

El método inputBox genera un cuadro de entrada del lado del cliente que muestra el mensaje determinado al usuario y ofrece una opción de botones para mostrar. Ten en cuenta que esta función hace que se suspenda la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones JDBC no persisten durante la suspensión.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);

No se recomienda este método. En su lugar, usa un mensaje de la IU.

Parámetros

Nombre	Tipo	Descripción
prompt	String	Es el texto que se mostrará en el cuadro de diálogo.
buttons	ButtonSet	Es el tipo de conjunto de botones que se usará.

Volver

String|null: Es el texto que ingresó el usuario (o "cancelar" para un diálogo cancelado o descartado).

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

inputBox(title, prompt, buttons)

Aparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.

El método inputBox genera un cuadro de entrada del lado del cliente con el título determinado, que muestra el mensaje determinado al usuario y ofrece una opción de botones para mostrar. Ten en cuenta que esta función hace que se suspenda la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones JDBC no persisten durante la suspensión.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);

No se recomienda este método. En su lugar, usa un mensaje de la IU.

Parámetros

Nombre	Tipo	Descripción
title	String	Es el título del cuadro de diálogo.
prompt	String	Es el texto que se mostrará en el cuadro de diálogo.
buttons	ButtonSet	Es el tipo de conjunto de botones que se usará.

Volver

String|null: Es el texto que ingresó el usuario (o "cancelar" para un diálogo cancelado o descartado).

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

msgBox(prompt)

Aparece un cuadro de diálogo con el mensaje determinado y un botón Aceptar en el navegador del usuario.

El método msgBox genera un cuadro de mensaje del lado del cliente que muestra el mensaje determinado al usuario. Ten en cuenta que este método hace que se suspenda la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones JDBC no persisten durante la suspensión.

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');

No se recomienda este método. En su lugar, usa un diálogo de alerta de la IU.

Parámetros

Nombre	Tipo	Descripción
prompt	String	Es el texto que se mostrará en el cuadro de diálogo.

Volver

String|null — Es el texto en minúscula del botón en el que hace clic el usuario (o "cancelar" para un diálogo descartado).

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

msgBox(prompt, buttons)

Aparece un cuadro de diálogo con el mensaje determinado y los botones especificados en el navegador del usuario.

El método msgBox genera un cuadro de mensaje del lado del cliente que muestra el mensaje determinado al usuario y ofrece una opción de botones para mostrar. Ten en cuenta que este método hace que se suspenda la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones JDBC no persisten durante la suspensión.

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);

No se recomienda este método. En su lugar, usa un diálogo de alerta de la IU.

Parámetros

Nombre	Tipo	Descripción
prompt	String	Es el texto que se mostrará en el cuadro de diálogo.
buttons	ButtonSet	Es el tipo de conjunto de botones que se usará.

Volver

String|null — Es el texto en minúscula del botón en el que hace clic el usuario (o "cancelar" para un diálogo descartado).

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

msgBox(title, prompt, buttons)

Aparece un cuadro de diálogo con el título, el mensaje y los botones especificados en el navegador del usuario.

El método msgBox genera un cuadro de mensaje del lado del cliente con el título determinado, que muestra el mensaje determinado al usuario y ofrece una opción de botones para mostrar. Ten en cuenta que este método hace que se suspenda la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones JDBC no persisten durante la suspensión.

// The code below displays "hello world" in a dialog box with a custom title and
// Yes and No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);

No se recomienda este método. En su lugar, usa un diálogo de alerta de la IU.

Parámetros

Nombre	Tipo	Descripción
title	String	Es el título del cuadro de diálogo.
prompt	String	Es el texto que se mostrará en el cuadro de diálogo.
buttons	ButtonSet	Es el tipo de conjunto de botones que se usará.

Volver

String|null — Es el texto en minúscula del botón en el que hace clic el usuario (o "cancelar" para un diálogo descartado).

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes permisos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets