C#でメッセージボックスを使う

メッセージボックスって、色々と便利ですよね。C#でメッセージボックスを表示するには、MessageBoxクラスのshowメソッドを使用します。いろいろな表示のメッセージボックスがあるので、使用頻度が高そうなものを一覧にしてみました。他にもありますので、詳しくはMSDNのmessageboxクラスの説明を参照してください。

目次

  1. テキストを表示するメッセージボックス
  2. テキストとキャプションを表示するメッセージボックス
  3. テキストとキャプションとボタンを表示するメッセージボックス
    1. AbortRetryIgnore
    2. OK
    3. OKCancel
    4. RetryCancel
    5. YesNo
    6. YesNoCancel
  4. テキストとキャプションとボタンとアイコンを表示するメッセージボックス
    1. Asterisk
    2. Error
    3. Exclamation
    4. Hand
    5. Information
    6. None
    7. Question (非推奨)
    8. Stop
    9. Warning
  5. ボタンを表示するメッセージボックスで、デフォルトのボタンを指定する場合
  6. メッセージボックスのテキストを右詰にしたい場合
  7. メッセージボックスにヘルプボタンを表示したい場合
  8. メッセージボックスのヘルプボタンにヘルプファイルを割り当てる場合
  9. メッセージボックスからヘルプファイルを開く際に項目を指定する場合
  10. 戻り値

テキストを表示するメッセージボックス

単純にテキストと「OK」ボタンだけを表示する場合です。

Show(String)

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のようなメッセージボックスが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト");
}

150924-1-02

テキストとキャプションを表示するメッセージボックス

メッセージボックスのウィンドウのタイトルを表示する場合です。

Show(String, String)

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスのウィンドウにタイトルが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション");
}

150924-1-03

テキストとキャプションとボタンを表示するメッセージボックス

メッセージボックスダイアログに表示されるボタンの種類を指定する場合です。

Show(String, String, MessageBoxButtons)

MessageBoxButtonsで指定できるボタンの種類については、MSDNのMessageBoxButtons列挙体を参照してください。ここでは、表示例を挙げてみます。

AbortRetryIgnore

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに「中止」「再試行」「無視」のボタンが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.AbortRetryIgnore);
}

150924-1-04

OK

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに「OK」のボタンが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK);
}

150924-1-05

OKCancel

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに「OK」「キャンセル」のボタンが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OKCancel);
}

150924-1-06

RetryCancel

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに「再試行」「キャンセル」のボタンが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.RetryCancel);
}

150924-1-07

YesNo

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに「はい」「いいえ」のボタンが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.YesNo);
}

150924-1-08

YesNoCancel

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに「はい」「いいえ」「キャンセル」のボタンが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.YesNoCancel);
}

150924-1-09

テキストとキャプションとボタンとアイコンを表示するメッセージボックス

メッセージボックスダイアログのテキストの左側に、アイコンを表示します。

Show(String, String, MessageBoxButtons, MessageBoxIcon)

MessageBoxIconで指定できるアイコンの種類については、MSDNのMessageBoxIcon列挙体を参照してください。ここでは表示例を挙げます。

Asterisk

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに円に入ったびっくりマークが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK, MessageBoxIcon.Asterisk);
}

150924-1-10

Error

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログにばってんマークが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK, MessageBoxIcon.Error);
}

150924-1-11

Exclamation

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに三角に入ったびっくりマークが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
}

150924-1-12

Hand

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログにばってんマークが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK, MessageBoxIcon.Hand);
}

150924-1-13

Information

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに円に入ったびっくりマークが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK, MessageBoxIcon.Information);
}

150924-1-14

None

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログにマークが表示されません。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK, MessageBoxIcon.None);
}

150924-1-15

Question (非推奨)

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに?マークが表示されます。?マークは誤解を生みやすいようで、MSDNでは非推奨になっています。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK, MessageBoxIcon.Question);
}

150924-1-16

Stop

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログにばってんマークが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK, MessageBoxIcon.Stop);
}

150924-1-17

Warning

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、メッセージボックスダイアログに三角に入ったびっくりマークが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK, MessageBoxIcon.Warning);
}

150924-1-18

ボタンを表示するメッセージボックスで、デフォルトのボタンを指定する場合

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

MessageBoxDefaultButtonで指定できる項目の詳細については、MSDNのMessageBoxDefaultButton列挙体を参照してください。簡単に言うと、Button1にすると左側、Button2にすると中央、Button3にすると右側のボタンがデフォルトのボタンになります。ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、Button2を指定すると中央のボタンがデフォルトになります。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.YesNoCancel, MessageBoxIcon.None, MessageBoxDefaultButton.Button2);
}

150924-1-19

メッセージボックスのテキストを右詰にしたい場合

MessageBoxOptionsで、いくつかメッセージボックスダイアログのオプションを指定できます。

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

MessageBoxOptionsで指定できるオプションはいくつかあります。 * DefaultDesktopOnly * RightAlign * RtlReading * ServiceNotification ここでは、テキストの右詰だけ紹介します。他のものについてはMSDNのMessageBoxOptions列挙体を参照してください。ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、テキストが右側に寄ります。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.YesNoCancel, MessageBoxIcon.None, MessageBoxDefaultButton.Button2, MessageBoxOptions.RightAlign);
}

150924-1-20

メッセージボックスにヘルプボタンを表示したい場合

メッセージボックスにヘルプボタンを表示できます。

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

ボタンをクリックしたらメッセージボックスを表示する場合の例です。下図のように、通常のボタンの隣に「ヘルプ」ボタンが表示されます。

private void button1_Click(object sender, EventArgs e)
{
        MessageBox.Show("テスト","キャプション", MessageBoxButtons.OK, MessageBoxIcon.None, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign, true);
}

150924-1-21

メッセージボックスのヘルプボタンにヘルプファイルを割り当てる場合

ヘルプボタンを押したらヘルプが表示されるようにできます。

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

メッセージボックスからヘルプファイルを開く際に項目を指定する場合

ヘルプファイルを開いたときの項目を指定できます。

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

戻り値

メッセージボックスダイアログのボタンが押された際の戻り値を得ることもできます。戻り値は、DialogResult列挙体になります。詳しくは、MSDNのDialogResult列挙体を参照してください。 * Abort * Cancel * Ignore * No * None * OK * Retry * Yes

公開日

広告