FMX.Dialogs.InputBox
Delphi
function InputBox(const ACaption, APrompt, ADefault: string): string;
procedure InputBox(const ACaption, APrompt, ADefault: string; const ACloseBoxProc: TInputCloseBoxProc);
procedure InputBox(const ACaption, APrompt, ADefault: string; const ACloseBoxEvent: TInputCloseBoxEvent; const AContext: TObject);
C++
extern DELPHI_PACKAGE System::UnicodeString __fastcall InputBox _DEPRECATED_ATTRIBUTE1("Use FMX.DialogService methods") (const System::UnicodeString ACaption, const System::UnicodeString APrompt, const System::UnicodeString ADefault)/* overload */;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | FMX.Dialogs.pas FMX.Dialogs.hpp |
FMX.Dialogs | FMX.Dialogs |
説明
警告: InputBox は非推奨になっています。 FMX.Platform ユニットの IFMXDialogServiceAsync.InputQueryAsync または IFMXDialogServiceSync.InputQuerySync を使用してください。
テキスト入力のためのダイアログ ボックスを表示します。
InputBox は、次のパラメータを受け取ります：
ACaptionは、ダイアログ ボックスのタイトルを表します。APromptは、TEdit の左側にあるラベルを表します。ADefaultは、TEdit のデフォルト テキストを表します。ACloseBoxProc（任意）は、ダイアログ ボックスが閉じられた際に InputBox が実行する任意のメソッドです。
ユーザーが ［OK］ボタンをクリックすると、InputBox は、ダイアログ ボックスの TEdit コントロールに入力されたテキストを返します。ユーザーが ［キャンセル］ボタンをクリックすると、InputBox は、ADefault パラメータの値を返します。ACloseBoxProc パラメータを渡すと、InputBox はなんの値も返しません。ACloseBoxProc メソッドに渡された AValue 引数には、代わりにユーザーの入力が含まれています。
InputBox への呼び出しに ACloseBoxProc パラメータが含まれていなかった場合、呼び出しはすべてのプラットフォーム上でブロックし、つまり、InputBox はダイアログ ボックスが閉じられるまで戻らなくなります。Android は、これらのブロックを起こす呼び出しをサポートしていませんので、Android 上で InputBox を使用できるのは、ACloseBoxProc パラメータを渡す場合のみです。
ACloseBoxProc パラメータを含む InputBox への呼び出しは、デスクトップ プラットフォーム上ではブロックしますが、モバイル プラットフォームでは非ブロック呼び出しとなります。つまり、モバイル プラットフォームでは、InputBox への呼び出し後に配置されたコードはすべて、ダイアログ ボックスが閉じられるまえに実行されます。ダイアログ ボックスが閉じた後にコードを実行する必要がある場合には、InputBox の ACloseBoxProc パラメータを使用して、そのコードを実行する 任意のメソッド の定義をします。詳細については、以下を参照してください。
サポート対象プラットフォーム
次の表では、どのプラットフォームが InputBox へのどの呼び出しをサポートしており、それらの呼び出しがブロックするのかブロックしないのかを、まとめています：
| プラットフォーム | ACloseBoxProc なし
|
ACloseBoxProc あり
|
|---|---|---|
| Windows | ブロック | ブロック |
| OS X | ブロック | ブロック |
| iOS | ブロック | ブロックしない |
| Android | ブロックしない |