FMX.Dialogs.MessageDlg

• Aller au parent : FMX.Dialogs

Delphi

function MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext): Integer;
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext; const ACloseDialogProc: TInputCloseDialogProc);
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext; const ACloseDialogEvent: TInputCloseDialogEvent; const AContext: TObject);
function MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext; const ADefaultButton: TMsgDlgBtn): Integer;
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext; const ADefaultButton: TMsgDlgBtn; const ACloseDialogProc: TInputCloseDialogProc);
procedure MessageDlg(const AMessage: string; const ADialogType: TMsgDlgType; const AButtons: TMsgDlgButtons;
const AHelpContext: THelpContext; const ADefaultButton: TMsgDlgBtn; const ACloseDialogEvent: TInputCloseDialogEvent;
const AContext: TObject);

C++

extern DELPHI_PACKAGE int __fastcall MessageDlg _DEPRECATED_ATTRIBUTE1("Use FMX.DialogService methods") (const System::UnicodeString AMessage, const System::Uitypes::TMsgDlgType ADialogType, const System::Uitypes::TMsgDlgButtons AButtons, const System::Classes::THelpContext AHelpContext)/* overload */;

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	FMX.Dialogs.pas FMX.Dialogs.hpp	FMX.Dialogs	FMX.Dialogs

Description

Avertissement : MessageDlg est obsolète. Veuillez utiliser Platform.IFMXDialogServiceAsync.MessageDialogAsync.

Affiche une boîte de dialogue personnalisée.

Utilisez MessageDlg pour afficher une boîte de dialogue qui a été conçue relativement aux paramètres de la fonction :

• AMessage représente le message de la boîte de dialogue.
• ADialogType représente le type de boîte de dialogue.
  • Pour une liste des types de dialogue, voir System.UITypes.TMsgDlgType.
• AButtons détermine les boutons de la boîte de dialogue. Les combinaisons de boutons valides sont disponibles sous la forme de constantes dans FMX.Dialogs#Constantes.
  • Pour une liste des types de boutons, voir System.UITypes.TMsgDlgBtn.
  • Par exemple, mbYes.
• AHelpContext spécifie l'identificateur de contexte de l'aide pour la boîte de dialogue.
• ADefaultButton détermine le bouton ayant la focalisation lors de l'affichage de la boîte de dialogue.
  • Pour une liste des types de boutons, voir System.UITypes.TMsgDlgBtn.
• ACloseDialogProc est une méthode anonyme exécutée par MessageDlg lors de la fermeture de la boîte de dialogue.

MessageDlg renvoie la valeur du bouton que l'utilisateur a sélectionné. Si vous fournissez le paramètre ACloseQueryProc, InputQuery transmet à la place le bouton sélectionné à la méthode {Arg|ACloseQueryProc}}.

Le tableau suivant liste les valeurs renvoyées possibles :

Valeur TMsgDlgBtn	Valeur renvoyée correspondante
mbOK	mrOk
mbCancel	mrCancel
mbAbort	mrAbort
mbRetry	mrRetry
mbIgnore	mrIgnore
mbYes	mrYes
mbNo	mrNo
mbClose	mrClose
mbHelp	mrHelp
mbTryAgain	mrTryAgain
mbContinue	mrContinue
mbNone	mrNone
mbAll	mrAll
mbNoToAll	mrNoToAll
mbYesToAll	mrYesToAll

Remarque : Le bouton Aide ne renvoie pas de valeur car il ne ferme pas le dialogue. Voir TCommonDialog.HelpContext.

Si un appel à MessageDlg n'inclut pas le paramètre ACloseDialogProc, l'appel est bloquant sur toutes les plates-formes ; c'est-à-dire que, MessageDlg ne renvoie rien jusqu'à la fermeture de la boîte de dialogue. Android ne prend pas en charge ces appels bloquants. Vous pouvez uniquement utiliser MessageDlg sur Android si vous fournissez le paramètre ACloseDialogProc.

Les appels à MessageDlg qui incluent le paramètre ACloseDialogProc sont également bloquants sur des plates-formes de bureau, mais ils sont non bloquants sur des plates-formes mobiles. Ce qui signifie que sur les plates-formes mobiles, tout code placé après un appel à MessageDlg est exécuté avant la fermeture de la boîte de dialogue. Si vous devez exécuter du code après la fermeture de votre boîte de dialogue, utilisez le paramètre ACloseDialogProc de MessageDlg pour définir une méthode anonyme qui exécute ce code. Voir :

• Méthodes anonymes dans Delphi

• Comment gérer les méthodes anonymes Delphi dans C++

Prise en charge de la plate-forme

Le tableau suivant récapitule la prise en charge des appels à MessageDlg sur les différentes plates-formes et indique si ces appels sont bloquants ou non bloquants :

Plate-forme	Sans ACloseDialogProc	Avec ACloseDialogProc
Windows	Bloquants	Bloquants
OS X	Bloquants	Bloquants
iOS	Bloquants	Non bloquants
Android		Non bloquants

Voir aussi

• System.UITypes.TMsgDlgType
• System.UITypes.TMsgDlgBtn
• System.UITypes.TMsgDlgButtons

• FMX.Dialogs.InputBox
• FMX.Dialogs.InputQuery
• FMX.Dialogs.ShowMessage

• Ouverture et fermeture des ensembles de données

Exemples de code

• FileExists (Delphi)
• FileExists (C++)
• TStringBuilderClickCount (Delphi)
• TStringBuilderClickCount (C++)
• Exemple MessageAlerts