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 | ブロックしない |