次の方法で共有

MessageBox.Show メソッド (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

  • [アーティクル]

指定したオブジェクトの前に、指定したテキスト、キャプション、ボタン、アイコン、既定のボタン、およびオプションを表示するメッセージ ボックスを表示します。

Overloads Public Shared Function Show( _
   ByVal owner As IWin32Window, _   ByVal text As String, _   ByVal caption As String, _   ByVal buttons As MessageBoxButtons, _   ByVal icon As MessageBoxIcon, _   ByVal defaultButton As MessageBoxDefaultButton, _   ByVal options As MessageBoxOptions _) As DialogResult
[C#]
public static DialogResult Show(IWin32Windowowner,stringtext,stringcaption,MessageBoxButtonsbuttons,MessageBoxIconicon,MessageBoxDefaultButtondefaultButton,MessageBoxOptionsoptions);
[C++]
public: static DialogResult Show(IWin32Window* owner,String* text,String* caption,MessageBoxButtonsbuttons,MessageBoxIconicon,MessageBoxDefaultButtondefaultButton,MessageBoxOptionsoptions);
[JScript]
public static function Show(
   owner : IWin32Window,text : String,caption : String,buttons : MessageBoxButtons,icon : MessageBoxIcon,defaultButton : MessageBoxDefaultButton,options : MessageBoxOptions) : DialogResult;

パラメータ

  • owner
    メッセージ ボックスがその前に表示される IWin32Window 。
  • text
    メッセージ ボックスに表示するテキスト。
  • caption
    メッセージ ボックスのタイトル バーに表示するテキスト。
  • buttons
    メッセージ ボックスに表示されるボタンを指定する MessageBoxButtons 値の 1 つ。
  • icon
    メッセージ ボックスに表示されるアイコンを指定する MessageBoxIcon 値の 1 つ。
  • defaultButton
    メッセージ ボックスの既定のボタンを指定する MessageBoxDefaultButton 値の 1 つ。
  • options
    メッセージ ボックスで使用する表示オプションと関連付けオプションを指定する MessageBoxOptions 値の 1 つ。

戻り値

DialogResult 値の 1 つ。

例外

例外の種類 条件
InvalidEnumArgumentException buttons が MessageBoxButtons のメンバではありません。

または

icon が MessageBoxIcon のメンバではありません。

または

defaultButton が MessageBoxDefaultButton のメンバではありません。
InvalidOperationException ユーザー対話モード以外のモードで実行されているプロセスで、 MessageBox を表示しようとしました。このモードは、 SystemInformation.UserInteractive プロパティで指定されています。
ArgumentException options に、 DefaultDesktopOnly と ServiceNotification が両方指定されています。

または

options に、 DefaultDesktopOnly または ServiceNotification 、および owner パラメータの値が指定されています。これら 2 つのオプションは、このメソッドの owner パラメータをとらないバージョンを起動する場合にだけ使用するようにしてください。

または

buttons に、無効な MessageBoxButtons の組み合わせが指定されています。

解説

owner パラメータを使用して、 IWin32Window インターフェイスを実装する特定のオブジェクトを指定し、そのオブジェクトの前にメッセージ ボックスを配置できます。メッセージ ボックスはモーダル ダイアログです。つまり、キーボードやマウスのクリックによる入力は、モーダル フォーム上のオブジェクトに対してしか発生しません。プログラムで別のフォームに対する入力を行うためには、通常はユーザーの操作に応答する形で、事前にモーダル フォームを非表示にするか、閉じる必要があります。

メッセージ ボックスには、最大 3 つのボタンを配置できます。

使用例

[Visual Basic, C#, C++] Show のこのオーバーロードでサポートされているオプションを使用して、 MessageBox を表示する方法の例を次に示します。この例では、文字列変数、 ServerName が空であることを検査した後、操作をキャンセルするためのオプションをユーザーに提供する MessageBox を表示します。 Show メソッドの戻り値が Yes と評価された場合、 MessageBox を表示したフォームは閉じられます。

 
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

[C#] 

    private void validateUserEntry2()
    {

        // Checks the value of the text.

        if(serverName.Text.Length == 0)
        {

            // Initializes the variables to pass to the MessageBox.Show method.

            string message = "You did not enter a server name. Cancel this operation?";
            string caption = "No Server Name Specified";
            MessageBoxButtons buttons = MessageBoxButtons.YesNo;
            DialogResult result;

            // Displays the MessageBox.

            result = MessageBox.Show(this, message, caption, buttons,
                MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
                MessageBoxOptions.RightAlign);

            if(result == DialogResult.Yes)
            {

                // Closes the parent form.

                this.Close();

            }

        }

    }


[C++] 
private:
    void validateUserEntry2() {
        // Checks the value of the text.
        if (serverName->Text->Length == 0) {

            // Initializes the variables to pass to the MessageBox::Show method.
            String* message = S"You did not enter a server name. Cancel this operation?";
            String* caption = S"No Server Name Specified";
            MessageBoxButtons buttons = MessageBoxButtons::YesNo;
            System::Windows::Forms::DialogResult result;

            // Displays the MessageBox.
            result = MessageBox::Show(this, message, caption, buttons,
                MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, 
                MessageBoxOptions::RightAlign);

            if (result == DialogResult::Yes) {
                // Closes the parent form.
                this->Close();
            }
        }
    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

MessageBox クラス | MessageBox メンバ | System.Windows.Forms 名前空間 | MessageBox.Show オーバーロードの一覧 | MessageBoxButtons | MessageBoxIcon | MessageBoxDefaultButton | MessageBoxOptions