MessageBox Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

MessageBox.cs

Megjelenít egy üzenetablakot, más néven párbeszédpanelt, amely üzenetet jelenít meg a felhasználónak. Ez egy modális ablak, amely blokkolja az alkalmazás egyéb műveleteit, amíg a felhasználó be nem zárja. Az A MessageBox tartalmazhat szöveget, gombokat és szimbólumokat, amelyek tájékoztatják és utasítják a felhasználót.

public ref class MessageBox

public class MessageBox

type MessageBox = class

Public Class MessageBox

Öröklődés

Object

MessageBox

Példák

Az alábbi példakód bemutatja, hogyan tájékoztathatja a felhasználót MessageBox egy hiányzó bejegyzésről TextBoxegy . Ez a példa megköveteli, hogy a metódus egy meglévő űrlapról legyen meghívva, rajta egy TextBoxServerName nevű névvel.

private:
   void validateUserEntry()
   {
      // 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;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry()
{
    // 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 = "Error Detected in Input";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.
        result = MessageBox.Show(message, caption, buttons);
        if (result == System.Windows.Forms.DialogResult.Yes)
        {
            // Closes the parent form.
            this.Close();
        }
    }
}

Private Sub ValidateUserEntry()
    ' 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 = "Error Detected in Input"
        Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays the MessageBox
        Result = MessageBox.Show(Message, Caption, Buttons)

        ' Gets the result of the MessageBox display.
        If Result = System.Windows.Forms.DialogResult.Yes Then
            ' Closes the parent form.
            Me.Close()
        End If
    End If
End Sub

Az alábbi példakód bemutatja, hogyan kérdezheti meg a felhasználót igen vagy nem kérdésre, és hogyan hozhat döntést a válasz alapján.

private:
   void Form1_FormClosing(Object^ sender, FormClosingEventArgs^ e)
   {
      // If the no button was pressed ...
      if ((MessageBox::Show(
         "Are you sure that you would like to close the form?", 
         "Form Closing", MessageBoxButtons::YesNo, 
         MessageBoxIcon::Question) == DialogResult::No))
      {
         // cancel the closure of the form.
         e->Cancel = true;
      }
   }

private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
    const string message =
        "Are you sure that you would like to close the form?";
    const string caption = "Form Closing";
    var result = MessageBox.Show(message, caption,
                                 MessageBoxButtons.YesNo,
                                 MessageBoxIcon.Question);

    // If the no button was pressed ...
    if (result == DialogResult.No)
    {
        // cancel the closure of the form.
        e.Cancel = true;
    }
}

Private Sub Form1_FormClosing( _
    ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.FormClosingEventArgs) _
    Handles MyBase.FormClosing

    Dim message As String = _
            "Are you sure that you would like to close the form?"
    Dim caption As String = "Form Closing"
    Dim result = MessageBox.Show(message, caption, _
                                 MessageBoxButtons.YesNo, _
                                 MessageBoxIcon.Question)

    ' If the no button was pressed ...
    If (result = DialogResult.No) Then
        ' cancel the closure of the form.
        e.Cancel = True
    End If
End Sub

Megjegyzések

Az osztály új példánya MessageBox nem hozható létre. Üzenetmező megjelenítéséhez hívja meg a metódust staticMessageBox.Show. Az üzenetmezőben megjelenő címet, üzenetet, gombokat és ikonokat a metódusnak átadott paraméterek határozzák meg.

Metódusok

Name	Description
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Megjeleníti a megadott szöveget, feliratot, gombokat, ikont, alapértelmezett gombot, beállításokat és Súgó gombot a megadott súgófájl HelpNavigatorés súgótémakör használatával.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Megjeleníti a megadott szöveget, feliratot, gombokat, ikont, alapértelmezett gombot, beállításokat és súgógombot tartalmazó üzenetmezőt a megadott súgófájllal és HelpNavigator.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Megjeleníti a megadott szöveget, feliratot, gombokat, ikont, alapértelmezett gombot, beállításokat és súgógombot tartalmazó üzenetmezőt a megadott súgófájl és súgó kulcsszó használatával.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Megjelenít egy üzenetmezőt a megadott szöveggel, felirattal, gombokkal, ikonnal, alapértelmezett gombbal, beállításokkal és Súgó gombbal a megadott súgófájl használatával.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Megjeleníti a megadott objektum előtti üzenetmezőt, valamint a megadott szöveget, feliratot, gombokat, ikont, alapértelmezett gombot és beállításokat.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Egy üzenetmezőt jelenít meg a megadott objektum előtt, a megadott szöveggel, felirattal, gombokkal, ikonnal és alapértelmezett gombbal.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	Megjelenít egy üzenetmezőt a megadott objektum előtt, a megadott szöveggel, felirattal, gombokkal és ikonnal.
Show(IWin32Window, String, String, MessageBoxButtons)	Egy üzenetmezőt jelenít meg a megadott objektum előtt, a megadott szöveggel, felirattal és gombokkal együtt.
Show(IWin32Window, String, String)	Egy üzenetmezőt jelenít meg a megadott objektum előtt, a megadott szöveggel és felirattal együtt.
Show(IWin32Window, String)	Egy üzenetmezőt jelenít meg a megadott objektum és a megadott szöveg előtt.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	Megjeleníti a megadott szöveget, feliratot, gombokat, ikont, alapértelmezett gombot, beállításokat és Súgó gombot tartalmazó üzenetmezőt.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Megjeleníti a megadott szöveget, feliratot, gombokat, ikont, alapértelmezett gombot, beállításokat és Súgó gombot a megadott súgófájl HelpNavigatorés súgótémakör használatával.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Megjeleníti a megadott szöveget, feliratot, gombokat, ikont, alapértelmezett gombot, beállításokat és súgógombot tartalmazó üzenetmezőt a megadott súgófájllal és HelpNavigator.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Megjeleníti a megadott szöveget, feliratot, gombokat, ikont, alapértelmezett gombot, beállításokat és súgógombot tartalmazó üzenetmezőt a megadott súgófájl és súgó kulcsszó használatával.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Megjelenít egy üzenetmezőt a megadott szöveggel, felirattal, gombokkal, ikonnal, alapértelmezett gombbal, beállításokkal és Súgó gombbal a megadott súgófájl használatával.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Megjeleníti a megadott szöveget, feliratot, gombokat, ikont, alapértelmezett gombot és beállításokat tartalmazó üzenetmezőt.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Megjeleníti a megadott szöveget, feliratot, gombokat, ikont és alapértelmezett gombot tartalmazó üzenetmezőt.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Megjeleníti a megadott szöveget, feliratot, gombokat és ikonokat tartalmazó üzenetmezőt.
Show(String, String, MessageBoxButtons)	Megjeleníti a megadott szöveget, feliratot és gombokat tartalmazó üzenetmezőt.
Show(String, String)	Egy megadott szöveggel és felirattal rendelkező üzenetmezőt jelenít meg.
Show(String)	Egy megadott szöveggel rendelkező üzenetmező megjelenítése.

Lásd még

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