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