Fonction Confirm

S’applique à : Applications pilotées par modèle

Une boîte de dialogue de confirmation s’affiche à l’intention de l’utilisateur.

Description

Note

Pour le moment, la fonction Confirmer n’est disponible que lors de l’écriture de commandes Power Fx pour les applications pilotées par modèle.

La fonction Confirm affiche une boîte de dialogue en haut de l’écran. Deux boutons sont fournis : un bouton de confirmation et un bouton d’annulation, qui correspondent par défaut aux versions localisées de « OK » et « Annuler », respectivement. L’utilisateur doit confirmer ou annuler avant que la boîte de dialogue ne soit fermée et que la fonction ne revienne. Outre le bouton de la boîte de dialogue, il est également possible de sélectionner Annuler avec la touche Échap ou d’autres gestes spécifiques à la plateforme.

Le paramètre Message est affiché dans le corps de la boîte de dialogue. Si le message est long, il est possible qu’il soit tronqué ou qu’une barre de défilement soit fournie.

Utilisez le paramètre OptionsRecord pour spécifier les options de la boîte de dialogue. Toutes les options ne sont pas disponibles sur toutes les plateformes et sont gérées au mieux. Ces options ne sont pas prises en charge dans les applications canevas.

Champ Option	Description
Bouton de confirmation	Le texte à afficher sur le bouton confirm remplaçant le texte "OK" localisé par défaut.
Bouton Annuler	Le texte à afficher sur le bouton cancel remplaçant le texte "Annuler" localisé par défaut.
Titre	Texte à afficher comme titre de la boîte de dialogue. Une police plus grande et plus audacieuse que la police du message peut être utilisée pour afficher ce texte. Si le texte est très long, il sera tronqué.
Sous-titre	Texte à afficher comme sous-titre de la boîte de dialogue. Une police plus grande et plus audacieuse que la police du message peut être utilisée pour afficher ce texte. Si le texte est très long, il sera tronqué.

Confirmer renvoie vrai si le bouton confirmer a été sélectionné, faux sinon.

Utilisez la fonction Notify pour afficher une bannière en haut de l’application qui n’a pas besoin d’être rejetée.

Syntaxe

Confirmer( Message [, OptionsEnregistrement ] )

• Message - Obligatoire. Message à afficher à l’utilisateur.
• OptionsRecord - Facultatif. Fournissez des paramètres d’option pour la boîte de dialogue. Toutes les options ne sont pas disponibles sur toutes les plateformes et sont gérées au mieux.

Examples

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

Boîte de dialogue de confirmation simple, demandant à l’utilisateur de confirmer la suppression d’un enregistrement avant qu’il ne soit supprimé. A moins que l’utilisateur n’appuie sur le bouton OK, l’enregistrement n’est pas supprimé.

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

Même boîte de dialogue que le dernier exemple, mais ajoute le texte du titre.

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

Demande à l’utilisateur sa couleur préférée, capturant le résultat dans une variable globale. Le résultat qui sera placé dans FavColor sera la chaîne de texte « Red » ou « Green ». Comme choix de confirmation, « Red » est la valeur par défaut. Cela ne fonctionne que sur les plateformes qui prennent en charge les options ConfirmButton et CancelButton.

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

Affiche un message semblable à la fonction Notify, mais qui est modal et nécessite que l’utilisateur sélectionne un bouton pour continuer. À utiliser dans les situations où il est important que l’utilisateur accuse réception du message avant de poursuivre. Dans cette situation, le bouton sélectionné n’a pas d’importance et le résultat n’est pas vérifié.