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 cuadros de diálogo de Google Workspace.

Consulta también

Propiedades

PropiedadTipoDescripción
ButtonsButtonSet

Métodos

MétodoTipo de datos que se muestraDescripción breve
inputBox(prompt)String|nullAparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.
inputBox(prompt, buttons)String|nullAparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.
inputBox(title, prompt, buttons)String|nullAparece un cuadro de diálogo con un cuadro de entrada de texto en el navegador del usuario.
msgBox(prompt)String|nullAparece un cuadro de diálogo con el mensaje determinado y un botón Aceptar en el navegador del usuario.
msgBox(prompt, buttons)String|nullAparece un cuadro de diálogo con el mensaje determinado y los botones especificados en el navegador del usuario.
msgBox(title, prompt, buttons)String|nullAparece 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 muestra un cuadro de entrada 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 cierra 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 una instrucción de IU.

Parámetros

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

Volver

String|null: Es el texto que ingresó el usuario (o "cancel" si se canceló o descartó el diálogo).

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 muestra un cuadro de entrada 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 cierra 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 una instrucción de IU.

Parámetros

NombreTipoDescripción
promptStringEs el texto que se mostrará en el cuadro de diálogo.
buttonsButtonSetEs el tipo de conjunto de botones que se usará.

Volver

String|null: Es el texto que ingresó el usuario (o "cancel" si se canceló o descartó el diálogo).

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 muestra un cuadro de entrada del lado del cliente con el título determinado, que muestra la instrucción determinada 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 cierra 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 una instrucción de IU.

Parámetros

NombreTipoDescripción
titleStringEs el título del cuadro de diálogo.
promptStringEs el texto que se mostrará en el cuadro de diálogo.
buttonsButtonSetEs el tipo de conjunto de botones que se usará.

Volver

String|null: Es el texto que ingresó el usuario (o "cancel" si se canceló o descartó el diálogo).

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)

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 suspende la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario cierra 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 IU.

Parámetros

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

Volver

String|null: Es el texto en minúsculas del botón en el que el usuario hizo clic (o "cancel" 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 alcances:

  • 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 muestra un cuadro de mensaje del lado del cliente que muestra el mensaje determinado al usuario y ofrece una selección de botones para mostrar. Ten en cuenta que este método suspende la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario cierra 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 IU.

Parámetros

NombreTipoDescripción
promptStringEs el texto que se mostrará en el cuadro de diálogo.
buttonsButtonSetEs el tipo de conjunto de botones que se usará.

Volver

String|null: Es el texto en minúsculas del botón en el que el usuario hizo clic (o "cancel" 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 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 muestra 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 suspende la secuencia de comandos del servidor. Se reanuda automáticamente después de que el usuario cierra 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 IU.

Parámetros

NombreTipoDescripción
titleStringEs el título del cuadro de diálogo.
promptStringEs el texto que se mostrará en el cuadro de diálogo.
buttonsButtonSetEs el tipo de conjunto de botones que se usará.

Volver

String|null: Es el texto en minúsculas del botón en el que el usuario hizo clic (o "cancel" 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 alcances:

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