Función Confirm

Se aplica a: Aplicaciones basadas en modelos

Muestra un cuadro de diálogo de confirmación al usuario.

Description

Nota

En este momento, la función Confirm solo está disponible al escribir comandos Power Fx para aplicaciones basadas en modelos.

La función Confirm muestra un cuadro de diálogo en la parte superior de la pantalla actual. Se proporcionan dos botones: un botón de confirmación y un botón de cancelación, que por defecto son versiones localizadas de "Aceptar" y "Cancelar", respectivamente. El usuario debe confirmar o cancelar antes de que se cierre el cuadro de diálogo y vuelva la función. Además del botón de diálogo, también se puede seleccionar cancelar con la tecla Esc u otros gestos específicos de la plataforma.

El parámetro Mensaje se muestra en el cuerpo del cuadro de diálogo. Si el mensaje es largo, se puede truncar o se puede proporcionar una barra de desplazamiento.

Use el parámetro OptionsRecord para especificar opciones para el cuadro de diálogo. No todas las opciones están disponibles en todas las plataformas y se manejan según el mejor esfuerzo. Estas opciones no se admiten en aplicaciones de lienzo.

Campo opción	Description
Botón de confirmación	El texto que se mostrará en el botón confirmar, reemplazando el texto "Aceptar" localizado predeterminado.
Botón Cancelar	El texto que se mostrará en el botón cancelar, reemplazando el texto "Cancelar" localizado predeterminado.
Título	El texto que se mostrará como título del cuadro de diálogo. Se puede usar una fuente más grande y en negrita que la fuente del mensaje para mostrar este texto. El texto se truncará si es largo.
Subtitular	El texto que se mostrará como subtítulo del cuadro de diálogo. Se puede usar una fuente más grande y en negrita que la fuente del mensaje para mostrar este texto. El texto se truncará si es largo.

Confirmar devuelve verdadero si se seleccionó el botón confirmar , falso en caso contrario.

Utilice la función Notify para mostrar un banner en la parte superior de la aplicación que no necesita ser descartado.

Sintaxis

Confirmar( Mensaje [, OpcionesRegistro ] )

• Mensaje - Obligatorio. Mensaje que se va a mostrar al usuario.
• OpcionesRegistro - Opcional. Proporcione configuración de opciones para el cuadro de diálogo. No todas las opciones están disponibles en todas las plataformas y se manejan según el "mejor esfuerzo".

Ejemplos

If( Confirm( "Are you sure?" ), Remove( ThisItem ) )

Diálogo de confirmación simple, pidiendo al usuario que confirme la eliminación de un registro antes de eliminarlo. A menos que el usuario presione el botón "Aceptar", el registro no se eliminará.

If( Confirm( "Are you sure?", {Title: "Delete Confirmation"} ), Remove( ThisItem ) )

El mismo cuadro de diálogo que el último ejemplo, pero agrega el texto del título.

Set( FavColor, 
     If( Confirm( "What is your favorite color?", 
                  { ConfirmButton: "Red", CancelButton: "Green" } 
         ), 
         "Red", 
         "Green" 
     ) 
)

Pregunta al usuario por su color favorito, capturando el resultado en una variable global. El resultado que se colocará en FavColor será la cadena de texto "Rojo" o "Verde". Como opción de confirmación, "Rojo" es el predeterminado. Esto solo funciona en plataformas que admiten las opciones ConfirmButton y CancelButton.

Confirm( "There was a problem, please review your order." )

Muestra un mensaje muy parecido al de la función Notify, pero es modal y requiere que el usuario seleccione un botón para continuar. Utilícelo en situaciones en las que sea importante que el usuario reconozca el mensaje antes de continuar. En esta situación, el botón que se seleccionó no es importante y el resultado no se verifica.