Vcl.Forms.TApplication.MessageBox

Delphi

function MessageBox(const Text, Caption: PChar; Flags: Longint = MB_OK): Integer;

C++

int __fastcall MessageBox(const System::WideChar * Text, const System::WideChar * Caption, int Flags = 0x0);

説明

指定されたメッセージをユーザーに表示します。

MessageBox を使用すると、メッセージや 1 つ以上のボタンのある汎用ダイアログボックスを、表示することができます。 Caption パラメータは、ダイアログボックスのキャプションを示し、任意です。

MessageBox の TApplication によるカプセル化により、Windows API 関数では必要となるウィンドウハンドルパラメータが欠けていても、自動的に補完されます。

Text パラメータの値はメッセージで、必要なら 255 文字以上になっても構いません。長文メッセージは、メッセージボックスでは自動的に改行されます。

Caption パラメータの値はキャプションで、ダイアログボックスのタイトルバー上に表示されます。 Captions は 225 文字より長く指定できますが、改行されません。長文キャプションの場合、メッセージボックスの幅が広げられます。

Flags パラメータでは、メッセージボックスに表示されるボタンと、その振る舞い（可能性のある戻り値）が指定されます。次の表に、指定可能な値を示します。これらの値は、希望する効果を得るため、組み合わせて使うこともできます。

値	意味
MB_ABORTRETRYIGNORE	メッセージボックスには、次の 3 つのボタンが配置されます：中止、再試行、無視。
MB_OK	メッセージボックスには、次のボタンが配置されます： OK。これがデフォルトの設定です。
MB_OKCANCEL	メッセージボックスには、次の 2 つのボタンが配置されます： OK、キャンセル。
MB_RETRYCANCEL	メッセージボックスには、次の 2 つのボタンが配置されます：再試行、キャンセル。
MB_YESNO	メッセージボックスには、次の 2 つのボタンが配置されます：はい、いいえ。
MB_YESNOCANCEL	メッセージボックスには、次の 3 つのボタンが配置されます：はい、いいえ、キャンセル。

MessageBox は、メッセージボックスを作成するのに十分なメモリがなかった場合に、0 を返します。そうでなければ、次の値のいずれかを返します：