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 su uso en el contexto de una hoja de cálculo de Google. En su lugar, usa los diálogos de Google Workspace.

Consulta también

Propiedades

PropiedadTipoDescripción
ButtonsButtonSet

Métodos

MétodoTipo de datos que se muestraDescripción breve
inputBox(prompt)StringAparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.
inputBox(prompt, buttons)StringAparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.
inputBox(title, prompt, buttons)StringAparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.
msgBox(prompt)StringMuestra un cuadro de diálogo con el mensaje dado y un botón Aceptar en el navegador del usuario.
msgBox(prompt, buttons)StringMuestra un cuadro de diálogo con el mensaje dado y los botones especificados en el navegador del usuario.
msgBox(title, prompt, buttons)StringAparece 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 una casilla de entrada del lado del cliente que muestra el mensaje dado al usuario. Ten en cuenta que esta función provoca la suspensión de la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones de JDBC no persisten durante la suspensión.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name');
No se recomienda este método. En su lugar, usa un mensaje en la IU.

Parámetros

NombreTipoDescripción
promptStringEl texto que se mostrará en el cuadro de diálogo.

Devolvedor

String: Es el texto que ingresa 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 alcances:

  • 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 cliente que muestra el mensaje específico al usuario y ofrece una selección de botones para mostrar. Ten en cuenta que esta función provoca que se suspenda la secuencia de comandos del lado del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones de JDBC no persisten durante la suspensión.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
No se recomienda este método. En su lugar, usa un mensaje en la IU.

Parámetros

NombreTipoDescripción
promptStringEl texto que se mostrará en el cuadro de diálogo.
buttonsButtonSetEl tipo de botón configurado para usar.

Devolvedor

String: Es el texto que ingresa 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 alcances:

  • 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 una casilla de entrada del lado del cliente con el título proporcionado, que muestra el mensaje determinado al usuario y ofrece una selección de botones para mostrar. Ten en cuenta que esta función provoca la suspensión de la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones de JDBC no persisten durante la suspensión.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('ID Check', 'Enter your name', Browser.Buttons.OK_CANCEL);
No se recomienda este método. En su lugar, usa un mensaje en la IU.

Parámetros

NombreTipoDescripción
titleStringEs el título del cuadro de diálogo.
promptStringEl texto que se mostrará en el cuadro de diálogo.
buttonsButtonSetEl tipo de botón configurado para usar.

Devolvedor

String: Es el texto que ingresa 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 alcances:

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

msgBox(prompt)

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

El método msgBox genera un cuadro de mensaje del cliente que muestra el mensaje dado 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 de 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 IU.

Parámetros

NombreTipoDescripción
promptStringEl texto que se mostrará en el cuadro de diálogo.

Devolvedor

String: Es el texto en minúscula del botón en el que hace clic el usuario (o "cancelar" en el caso de 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 alcances:

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

msgBox(prompt, buttons)

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

El método msgBox genera un cuadro de mensaje del cliente que muestra el mensaje dado al usuario y ofrece una variedad de botones para mostrar. Ten en cuenta que este método hace que se suspenda la secuencia de comandos del lado del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones de 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 IU.

Parámetros

NombreTipoDescripción
promptStringEl texto que se mostrará en el cuadro de diálogo.
buttonsButtonSetEl tipo de botón configurado para usar.

Devolvedor

String: Es el texto en minúscula del botón en el que hace clic el usuario (o "cancelar" en el caso de 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 alcances:

  • 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 cliente con el título dado, que muestra el mensaje dado al usuario y ofrece una variedad de botones para mostrar. Ten en cuenta que este método provoca la suspensión de la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario borra el diálogo, pero las conexiones de 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 IU.

Parámetros

NombreTipoDescripción
titleStringEs el título del cuadro de diálogo.
promptStringEl texto que se mostrará en el cuadro de diálogo.
buttonsButtonSetEl tipo de botón configurado para usar.

Devolvedor

String: Es el texto en minúscula del botón en el que hace clic el usuario (o "cancelar" en el caso de 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 alcances:

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