FMX.Dialogs.MessageDlg
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 */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | FMX.Dialogs.pas FMX.Dialogs.hpp |
FMX.Dialogs | FMX.Dialogs |
説明
警告: MessageDlg は非推奨になっています。 Platform.IFMXDialogServiceAsync.MessageDialogAsync を使用してください。
カスタム ダイアログ ボックスを表示します。
MessageDlg を使用すると、関数のパラメータに応じて設計されたダイアログ ボックスを表示することができます:
AMessage
は、ダイアログ ボックスのテキスト メッセージを表します。ADialogType
は、ダイアログ ボックスのタイプを表します。- ダイアログ タイプの一覧については、System.UITypes.TMsgDlgType を参照してください。
AButtons
は、ダイアログ ボックスのボタンを決定します。ボタンの有効な組み合わせは、「FMX.Dialogs#定数」における定数で確認することができます。- ボタン タイプの一覧については、System.UITypes.TMsgDlgBtn を参照してください。
- たとえば、
mbYes
です。
AHelpContext
は、ダイアログ ボックスのヘルプ コンテキスト ID を示します。ADefaultButton
は、ダイアログ ボックスが表示された際にフォーカスされているボタンを決定します。- ボタン タイプの一覧については、System.UITypes.TMsgDlgBtn を参照してください。
ACloseDialogProc
は、ダイアログ ボックスが閉じられた際に MessageDlg が実行する任意のメソッドです。
MessageDlg は、ユーザーが選択したボタンの値を返します。 ACloseQueryProc
パラメータを渡した場合、InputQuery は選択されたボタンを ACloseQueryProc
メソッドに代わりに渡します。
次の表は、可能な戻り値の一覧です:
TMsgDlgBtn 値 | 対応する戻り値 |
---|---|
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 |
- メモ: ヘルプ ボタンは、ダイアログを閉じないため、値を返しません。 「TCommonDialog.HelpContext」を参照してください。
MessageDlg への呼び出しに ACloseDialogProc
パラメータが含まれていなかった場合、呼び出しはすべてのプラットフォーム上でブロックし、つまり、MessageDlg はダイアログ ボックスが閉じられるまで戻らなくなります。 Android は、これらのブロックを起こす呼び出しをサポートしていませんので、Android 上で MessageDlg を使用できるのは、ACloseDialogProc
パラメータを渡す場合のみです。
ACloseDialogProc
パラメータを含む MessageDlg への呼び出しは、デスクトップ プラットフォーム上ではブロックしますが、モバイル プラットフォームでは非ブロック呼び出しとなります。つまり、モバイル プラットフォームでは、MessageDlg への呼び出し後に配置されたコードはすべて、ダイアログ ボックスが閉じられるまえに実行されます。 ダイアログ ボックスが閉じた後にコードを実行する必要がある場合には、MessageDlg の ACloseDialogProc
パラメータを使用して、そのコードを実行する 任意のメソッド の定義をします。 詳細については、以下を参照してください。
サポート対象プラットフォーム
次の表では、どのプラットフォームが MessageDlg へのどの呼び出しをサポートしており、それらの呼び出しがブロックするのかブロックしないのかを、まとめています:
プラットフォーム | ACloseDialogProc なし
|
ACloseDialogProc あり
|
---|---|---|
Windows | ブロック | ブロック |
OS X | ブロック | ブロック |
iOS | ブロック | ブロックしない |
Android | ブロックしない |