openConfirmDialog (référence de l’API client)
Affiche une boîte de dialogue de confirmation contenant un message et deux boutons.
Syntaxe
Xrm.Navigation.openConfirmDialog(confirmStrings,confirmOptions).then(successCallback,errorCallback);
Paramètres
Note
Avec la nouvelle apparence activée, la hauteur de la boîte de dialogue sera redimensionnée automatiquement si vous ne définissez pas la valeur hauteur des options de la boîte de dialogue.
Nom | Type | Requise | Description |
---|---|---|---|
confirmStrings |
Object | Oui | Les chaînes à utiliser dans la boîte de dialogue de confirmation. L’objet contient les valeurs suivantes : - cancelButtonLabel : (facultatif) chaîne. Étiquette du bouton d’annulation. Si vous ne spécifiez pas l’étiquette du bouton d’annulation, Annuler est utilisé comme étiquette du bouton.- confirmButtonLabel : (facultatif) chaîne. Étiquette du bouton de confirmation. Si vous ne spécifiez pas l’étiquette du bouton de confirmation, OK est utilisé comme étiquette du bouton.- subtitle : (facultatif) chaîne. Sous-titre à afficher dans la boîte de dialogue de confirmation.- text : chaîne. Message à afficher dans la boîte de dialogue de confirmation.- title : (facultatif) chaîne. Titre à afficher dans la boîte de dialogue de confirmation. |
confirmOptions |
Object | Non | Options pour la hauteur et la largeur de la boîte de dialogue de confirmation. L’objet contient les valeurs suivantes : - height : (facultatif) nombre. Hauteur de la boîte de dialogue de confirmation en pixels.- width : (facultatif) nombre. Largeur de la boîte de dialogue de confirmation en pixels. Avec la nouvelle apparence activée, la hauteur de la boîte de dialogue est redimensionnée automatiquement si vous ne définissez pas la valeur hauteur des options de la boîte de dialogue. |
successCallback |
function | Non | Fonction à exécuter lorsque la boîte de dialogue de confirmation est fermée en cliquant sur le bouton de confirmation, d’annulation, ou X dans le coin supérieur droit de la boîte de dialogue. On passe un objet avec l’attribut (booléen) confirmed qui indique si le bouton de confirmation a été appuyé pour fermer la boîte de dialogue. |
errorCallback |
function | Non | Fonction à exécuter lorsque l’opération échoue. |
Exemple
L’exemple de code suivant affiche une boîte de dialogue de confirmation. Le message approprié est consigné dans la console selon que le bouton de confirmation ou d’annulation/X a été appuyé pour fermer la boîte de dialogue.
var confirmStrings = { text:"This is a confirmation.", title:"Confirmation Dialog" };
var confirmOptions = { height: 200, width: 450 };
Xrm.Navigation.openConfirmDialog(confirmStrings, confirmOptions).then(
function (success) {
if (success.confirmed)
console.log("Dialog closed using OK button.");
else
console.log("Dialog closed using Cancel button or X.");
});