Partager via

Confirm Fonction

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

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

Description

Note

À ce stade, la fonction est disponible uniquement lors de l’écriture Confirm de commandes Power Fx pour les applications basées sur des modèles.

La Confirm fonction affiche une boîte de dialogue en haut de l’écran actif. 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 de 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. Le texte est tronqué s’il est long.
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. Le texte est tronqué s’il est long.

Confirm retourne true si le bouton de confirmation a été sélectionné, false dans le cas contraire.

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

Syntaxe

Confirm( Message [, OptionsRecord ] )

  • 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 placé dans FavColor sera la chaîne de texte « Rouge » ou « Vert ». 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é.

  • Last updated on