Muestra un cuadro de diálogo en el que se visualiza el documento actual (bien esté abierto o seleccionado en una vista). El cuadro de diálogo comparte los campos con

el documento subyacente. Como de costumbre, el usuario interactúa con el cuadro de diálogo y hace clic en Aceptar o en Cancelar una vez finalizada la tarea.

Esta función puede usarse con cualquier tipo de formulario, pero resulta especialmente útil con los formularios que contienen un único marco de diseño o tabla; esto es debido a que el usuario puede interactuar con el marco de diseño o la tabla como si se tratase de un cuadro de diálogo.

Sintaxis

@DialogBox( formulario ; [AUTOHORZFIT] : [AUTOVERTFIT] : [NOCANCEL] : [NONEWFIELDS] : [NOFIELDUPDATE] : [READONLY] : [SIZETOTABLE] : [NOOKCANCEL] : [OKCANCELATBOTTOM] : [NONOTE] ; título )

Parámetros

formulario

Texto. El nombre del formulario con el que se desea ver el documento actual.

Palabra clave. Opcional. Cambia el tamaño del cuadro de diálogo horizontalmente para que se ajuste al primer marco de diseño o tabla del formulario. Si no se especifica esta palabra clave, el cuadro de diálogo no varía de tamaño horizontalmente.

Palabra clave. Opcional. Cambia el tamaño del cuadro de diálogo verticalmente para que se ajuste al primer marco de diseño o tabla del formulario. Si no se especifica esta palabra clave, el cuadro de diálogo no varía de tamaño verticalmente.

Palabra clave. Opcional. No muestra el botón Cancelar. Si no se especifica esta palabra clave, el cuadro de diálogo incluirá el botón Cancelar.

Palabra clave. Opcional. No agrega al documento subyacente los campos que existen en el formulario del cuadro de diálogo pero que no se encuentran en el formulario subyacente. Si no se especifica esta palabra clave, todos los campos del cuadro de diálogo se pasan al documento subyacente.

Palabra clave. Opcional. No pasa las modificaciones realizadas en los campos del cuadro de diálogo al documento subyacente (por ejemplo, si se están enviando las modificaciones efectuadas en el formulario del cuadro de diálogo a algún otro destino en un script QueryClose). Si no se especifica esta palabra clave, las modificaciones se pasan al documento subyacente.

Palabra clave. Opcional. Impide la entrada de texto en el cuadro de diálogo (por ejemplo, si está utilizando el cuadro de diálogo para mostrar una pantalla de ayuda). Si no se especifica esta palabra clave, el cuadro de diálogo permite la entrada de texto. Si se utiliza esta palabra clave, deberá especificarse asimismo [NoCancel].

Nota Este parámetro es una novedad de la Versión 5.

Palabra clave. Opcional. Aplica las palabras clave [AUTOHORZFIT] y [AUTOVERTFIT] a la primera tabla del formulario. Si no se especifica esta palabra clave, las opciones se aplican al primer marco de diseño del formulario.

Nota Este parámetro es una novedad de la Versión 5.

Palabra clave. Opcional. No muestra el botón Aceptar. Si no se especifica esta palabra clave, el cuadro de diálogo incluirá el botón Aceptar. El uso de esta palabra clave impide que los cambios efectuados en el cuadro de diálogo se reflejen en el documento actual. Si desea que el documento actual se actualice, pero no desea que aparezca el botón Aceptar, incluya un botón de zona activa que ejecute el comando de @Command RefreshParentNote.

Nota Este parámetro es una novedad de la Versión 6.

Palabra clave. Opcional. Muestra los botones Aceptar y/o Cancelar uno junto a otro en la zona inferior derecha del cuadro de diálogo. Si no se especifica esta palabra clave, los botones aparecen agrupados en la zona superior derecha.

Nota Este parámetro es una novedad de la Versión 7.

Palabra clave. Opcional. Permite utilizar la función @Dialogbox sin necesidad de un documento actual. Si existe éste, se ignorará. El uso de esta palabra clave implica el uso de [NOFIELDUPDATE] y [NONEWFIELDS], aunque no se especifiquen explícitamente. Si no se especifica el parámetro [NONOTE], se requerirá un documento actual.

Texto. El título del cuadro de diálogo. El valor predeterminado es "Lotus Notes".

ninguno

Sólo actualiza los cambios efectuados en los campos del mismo nombre del formulario actual si el cuadro de diálogo se guarda y se cierra. Consulte "Uso compartido de valores de campos".

Esta función resulta útil en botones de acción. No funciona en fórmulas de columna ni de selección, ni en agentes que se ejecutan en un servidor (sean agentes programados o agentes que se activan cuando se reciben documentos por correo). Tampoco es aconsejable su uso en fórmulas de título de ventana ni de formulario. Puede usarse con cualquier tipo de formulario, pero resulta especialmente útil con los formularios que contienen un único marco de diseño o tabla; esto es debido a que el usuario puede interactuar con el marco de diseño o la tabla como si se tratase de un cuadro de diálogo.

@DialogBox no puede dar como resultado datos procedentes de un campo de texto enriquecido.

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

Si el formulario contiene acciones en la barra de acciones, éstas no se visualizarán en el cuadro de diálogo.

[AUTOHORZFIT] y [AUTOVERTFIT] permiten incluir en un cuadro de diálogo el marco de diseño completo (sin usar [SIZETOTABLE]) o la tabla completa (usando [SIZETOTABLE]) sin necesidad de visualizar el resto del formulario. Si el formulario tiene más de un marco de diseño o tabla, se utiliza el primero de ellos. Si desea obtener buenos resultados:

• Utilice los dos parámetros, [AUTOHORZFIT] y [AUTOVERTFIT].
• En el cuadro de propiedades del marco, desactive Mostrar borde y seleccione 3D.

Uso compartido de valores de campos

@DialogBox muestra el documento actual haciendo uso de un formulario distinto al utilizado durante su creación. Esto significa que:

• Si el formulario y el documento actual tienen nombres de campo en común, en el cuadro de diálogo se visualizarán los valores de los campos correspondientes al documento actual. Los campos de texto enriquecido no se visualizarán en el formulario, incluso si sus nombres coinciden con los del documento actual.
• Si el usuario cambia el valor de cualquiera de los campos en el cuadro de diálogo y selecciona Aceptar, estos cambios aparecerán reflejados en los mismos campos del documento actual.
• Si el usuario introduce un valor para un campo del cuadro de diálogo, y el documento actual no dispone de dicho campo, Notes agrega el valor al documento, incluso si éste no se visualiza en el formulario.
• Si no desea incluir los botones Aceptar o Cancelar en el cuadro de diálogo, pero desea que los cambios efectuados en él se reflejen en el documento actual, utilice el comando @Command([RefreshParentNote]). Si agrega este comando a un botón de zona activa de un cuadro de diálogo, por ejemplo, cuando un usuario haga clic en el botón, los valores de los campos del documento actual se actualizarán para reflejar los cambios efectuados en los campos del mismo nombre del cuadro de diálogo.

Método DialogBox de la clase NotesUIWorkspace de LotusScript

Ejemplo
Véase también

DialogBox method
Filling out a form with @DialogBox
@PickList
@Prompt
RefreshParentNote - @Command
"Taking your Domino applications to the Web" en Lotus Developer Domain
"Creating context-sensitive help for applications" en Lotus Developer Domain