Muestra un cuadro de diálogo al usuario y da como resultado un valor de texto basándose en las acciones que el usuario realiza en dicho cuadro de diálogo. @Prompt resulta útil cuando se necesita pedir información al usuario y determinar las acciones a tomar basándose en la información suministrada.

Tabla de estilos de cuadros de diálogo

Esta tabla incluye los distintos estilos de cuadros de diálogo. @Prompt acepta los parámetros y da como resultado un valor en base al estilo especificado.

Estilo	Objetivo	Muestra	Resultado
CHOOSEDATABASE	Muestra un cuadro de diálogo que permite al usuario especificar y abrir una base de datos	El título, "Seleccionar base de datos"; una lista de opciones de servidores y bases de datos; los botones Abrir, Seleccionar, Cancelar, Examinar, Ayuda y Acerca de	Texto. Lista de tres valores. Nombre del servidor, nombre del archivo, título de la base de datos. Si la base de datos es local, muestra una cadena vacía para el nombre del servidor.
LOCALBROWSE	Permite al usuario seleccionar un nombre de archivo del sistema de archivos local.	Controles y listas que permiten examinar el sistema de archivos local y los botones Seleccionar, Cancelar y Red o Ayuda	Texto. El nombre o los nombres de archivo seleccionados o introducidos por el usuario.
OK	Muestra un mensaje informativo	El título y el mensaje, y el botón Aceptar	1 (Verdadero).
OKCANCELCOMBO	Permite al usuario seleccionar una de las opciones de una lista desplegable	El título, el mensaje, una lista de opciones y los botones Aceptar y Cancelar	Texto. El valor seleccionado por el usuario.
OKCANCELEDIT	Permite al usuario escribir una entrada de texto	El título, el mensaje, un cuadro de texto en el que el usuario deberá introducir los datos y los botones Aceptar y Cancelar	Texto. El valor introducido por el usuario.
OKCANCELEDITCOMBO	Permite al usuario seleccionar una de las opciones de una lista o escribir otra distinta	El título, el mensaje, una lista de opciones desplegable con un cuadro de texto y los botones Aceptar y Cancelar	Texto. El valor seleccionado o introducido por el usuario.
OKCANCELLIST	Permite al usuario seleccionar una de las opciones de una lista	El título, el mensaje, una lista de opciones y los botones Aceptar y Cancelar	Texto. El valor seleccionado por el usuario.
OKCANCELLISTMULT	Permite al usuario seleccionar una o varias de las opciones de una lista	El título, el mensaje, una lista de opciones y los botones Aceptar y Cancelar	Lista de texto. Todos los valores seleccionados por el usuario, concatenados con el carácter : (dos puntos).
PASSWORD	Permite al usuario introducir una contraseña sin mostrarla en la pantalla	El título, el mensaje, un cuadro de texto que acepta y oculta el texto introducido por el usuario y los botones Aceptar y Cancelar	Texto. La contraseña introducida.
YESNO	Permite al usuario optar entre las opciones Sí y No	El título, el mensaje, y los botones Sí y No	1 (Verdadero, Sí) o 0 (Falso, No).
YESNOCANCEL	Permite al usuario optar entre las opciones Sí, No y Cancelar	El título, el mensaje, y los botones Sí, No y Cancelar	1 (Verdadero, Sí), 0 (Falso, No) o -1 (Cancelar).

Sintaxis

@Prompt( [estilo] : [ NOSORT ] ; título ; mensaje ; predeterminado ; lista-opciones ; tipo-archivo )

Parámetros

[estilo]

Palabra clave. Obligatorio. Indica el tipo de cuadro de diálogo que se va a mostrar. Puede ser cualquiera de los siguientes:

[CHOOSEDATABASE]

[LOCALBROWSE]

[OK]

[OKCANCELCOMBO]

[OKCANCELEDIT]

[OKCANCELEDITCOMBO]

[OKCANCELLIST]

[OKCANCELLISTMULT]

[PASSWORD]

[YESNO]

[YESNOCANCEL]

Incluya los corchetes ([ ]); éstos identifican los parámetros de estilo como palabras clave. Si no se indica la palabra clave [NOSORT], ponga a continuación del parámetro de estilo un punto y coma (;).

Palabra clave. Opcional. Incluya esta palabra clave si desea que los elementos que componen lista-opciones aparezcan en el mismo orden en que se especifican. Si omite esta palabra clave, los elementos de lista-opciones se ordenarán alfabéticamente.

Texto. Corresponde al título que se visualizará en la barra de título del cuadro de diálogo. Encierre el título entre comillas. El título debe especificarse siempre, aunque con una cadena vacía "" es suficiente. El número máximo de caracteres que puede incluir en un título es 65. Indique una cadena vacía con la palabra clave [CHOOSEDATABASE]; no es posible reemplazar el título predeterminado "Seleccionar base de datos".

Texto. Corresponde al texto que se visualiza dentro del cuadro de diálogo. El mensaje debe especificarse siempre, excepto para el estilo LocalBrowse. Si para el mensaje utiliza una fórmula y ésta da como resultado una lista, en el mensaje sólo se visualiza el primer elemento de la lista. Para visualizar la lista completa, utilice @Implode. Si lo desea, puede especificar un nombre de campo para mostrar su contenido como mensaje; para ello el campo deberá ser de texto. En caso de que sea un campo de número o de fecha-hora, incluya como prefijo @Text. No utilice @NewLine en el mensaje. Utilice @Char(13) para insertar un retorno de carro. El número máximo de caracteres que puede incluir en el texto que se muestra es 255. Indique una cadena vacía para la palabra clave [CHOOSEDATABASE]; no es posible mostrar texto personalizado en el cuadro de diálogo Seleccionar base de datos.

Texto. Corresponde al valor que se utilizará como valor predeterminado. En el cuadro de diálogo, Notes sitúa el valor predeterminado en el cuadro de texto; el usuario puede aceptar este valor haciendo clic en Aceptar o bien sustituirlo por otro. Este parámetro no puede utilizarse en los estilos [OK], [YESNO],[YESNOCANCEL],[LOCALBROWSE] o [PASSWORD]. En el resto de los estilos debe especificarse siempre. Para [OKCANCELLISTMULT], puede especificar diversos valores predeterminados en forma de lista de texto "elemento1":"elemento2".

Lista de texto. Corresponde a los valores que, en forma de lista, se visualizarán en el cuadro de lista del cuadro de diálogo. El usuario puede utilizar uno de estos valores. Separe unos valores de otros con el signo de dos puntos (por ejemplo, "TELEF.NSF":@MailDbName). Cada uno de los valores de lista-opciones puede ser una cadena de texto o una función @ que dé como resultado una cadena de texto. Este parámetro sólo es necesario con los estilos [OKCANCELLIST], [OKCANCELCOMBO], [OKCANCELEDITCOMBO] y[OKCANCELLISTMULT].

Texto. Corresponde al valor que indica los tipos de archivos que se visualizarán inicialmente: "1" para archivos sólo de tipo NSF; "2" para archivos sólo de tipo NTF; "3" para archivos de todo tipo. Sólo es necesario para el estilo [LOCALBROWSE].

elección

• Si el usuario introduce un valor, da como resultado dicho valor como texto.
• Si el usuario selecciona Sí, da como resultado 1 (Verdadero).
• Si el usuario selecciona No, da como resultado 0 (Falso).
• Si el usuario selecciona Cancelar, Notes interrumpe la evaluación de la fórmula. La excepción es [YESNOCANCEL], que da como resultado -1 si el usuario selecciona Cancelar.
• @Prompt([OKCANCELEDIT]) da como resultado sólo los primeros 254 caracteres del texto introducido.

Utilice @Prompt en fórmulas de campos, de botones de barras de herramientas, de agentes manuales, de acciones de formulario y de acciones de vista. Esta función no funciona en fórmulas de columna, de selección, de agente que se activa al recibir documentos por correo ni de agente programado; asimismo, su utilidad está limitada en las fórmulas de título de ventana y en las de formulario.

No es posible utilizar esta función en las aplicaciones para Web.

Equivalencias en otros lenguajes

Función InputBox del lenguaje LotusScript

Propiedad DialogBoxCanceled de la clase NotesUIDocument de LotusScript

Método Prompt de la clase NotesUIWorkspace de LotusScript

Ejemplo
Véase también

@DialogBox
Getting user input with @Prompt and @PickList
@PickList
Writing messages to the user
Examples: Lexical elements
Data types
Form fields
Ejemplo de código para administrador de direcciones de Internet de la Versión 5 de Sandbox en Lotus Developer Domain
"Adding a friendly ad-hoc query tool to Domino applications" en Lotus Developer Domain
"Taking your Domino applications to the Web" en Lotus Developer Domain
"Creating context-sensitive help for applications" en Lotus Developer Domain
"The hidden power of Profile documents" en Lotus Developer Domain
"Create your own formula debugger" en Tips de Lotus Developer Domain