Как вывести сообщение windows forms c

Последнее обновление: 31.10.2015

Как правило, для вывода сообщений применяется элемент MessageBox. Однако кроме сообственно вывода строки сообщения данный элемент может устанавливать
ряд настроек, которые определяют его поведение.

Для вывода сообщения в классе MessageBox предусмотрен метод Show, который имеет различные версии и может принимать ряд параметров.
Рассмотрим одну из наиболее используемых версий:

public static DialogResult Show(
	string text,
	string caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options
)

Здесь применяются следующие параметры:

text: текст сообщения

caption: текст заголовка окна сообщения

buttons: кнопки, используемые в окне сообщения.
Принимает одно из значений перечисления MessageBoxButtons:

• AbortRetryIgnore: три кнопки Abort (Отмена), Retry (Повтор), Ignore (Пропустить)

• OK: одна кнопка OK

• OKCancel: две кнопки OK и Cancel (Отмена)

• RetryCancel: две кнопки Retry (Повтор) и Cancel (Отмена)

• YesNo: две кнопки Yes и No

• YesNoCancel: три кнопки Yes, No и Cancel (Отмена)

Таким образом, в зависимости от выбора окно сообщения может иметь от одной до трех кнопок.

icon: значок окна сообщения. Может принимать одно из следующих значений перечисления MessageBoxIcon:

• Asterisk, Information: значок, состоящий из буквы i в нижнем регистре, помещенной в кружок

• Error, Hand, Stop: значок, состоящий из белого знака «X» на круге красного цвета.

• Exclamation, Warning: значок, состоящий из восклицательного знака в желтом треугольнике

• Question: значок, состоящий из вопросительного знака на периметре круга

• None: значок у сообщения отсутствует

defaultButton: кнопка, на которую по умолчанию устанавливается фокус. Принимает одно из значений перечисления MessageBoxDefaultButton:

• Button1: первая кнопка из тех, которые задаются перечислением MessageBoxButtons

• Button2: вторая кнопка

• Button3: третья кнопка

options: параметры окна сообщения. Принимает одно из значений перечисления MessageBoxOptions:

• DefaultDesktopOnly: окно сообщения отображается на активном рабочем столе.

• RightAlign: текст окна сообщения выравнивается по правому краю

• RtlReading: все элементы окна располагаются в обратном порядке справа налево

• ServiceNotification: окно сообщения отображается на активном рабочем столе, даже если в системе не зарегистрирован ни один пользователь

Нередко используется один параметр — текст сообщения. Но посмотрим, как использовать остальные параметры. Пусть у нас есть кнопка, в обработчике
нажатия которой открывается следующее окно сообщения:

private void button1_Click(object sender, EventArgs e)
{
    MessageBox.Show(
        "Выберите один из вариантов", 
        "Сообщение", 
        MessageBoxButtons.YesNo, 
        MessageBoxIcon.Information, 
        MessageBoxDefaultButton.Button1, 
        MessageBoxOptions.DefaultDesktopOnly);
}

Однако нам не просто дается возможность установки кнопок в окне сообщения. Метод MessageBox.Show возвращает объект
DialogResult, с помощью которого мы можем узнать, какую кнопку в окне сообщения нажал пользователь. DialogResult представляет
перечисление, в котором определены следующие значения:

• Abort: нажата кнопка Abort

• Retry: нажата кнопка Retry

• Ignore: нажата кнопка Ignore

• OK: нажата кнопка OK

• Cancel: нажата кнопка Cancel

• None: отсутствие результата

• Yes: нажата кнопка Yes и No

• No: нажата кнопка No

Используем обработку выбора пользователя, изменив обработчик нажатия кнопки следующим образом:

private void button1_Click(object sender, EventArgs e)
{
    DialogResult result = MessageBox.Show(
        "Окрасить кнопку в красный цвет?", 
        "Сообщение", 
        MessageBoxButtons.YesNo, 
        MessageBoxIcon.Information, 
        MessageBoxDefaultButton.Button1, 
        MessageBoxOptions.DefaultDesktopOnly);
		
	if (result == DialogResult.Yes)
        button1.BackColor=Color.Red;
    
	this.TopMost = true;
}

И теперь, если в окне сообщения мы выберем выриант Yes, то кнопка окрасится в красный цвет.

MessageBox with Buttons

A MessageBox can have different button combinations such as YesNo and OKCancel. The MessageBoxButtons enumeration represents the buttons to be displayed on a MessageBox and has following values.

MessageBox with Message Options

The whole concept behind a message box is to display text to the user or to ask a question of some sort. So in practice we can use message boxes to display an error to the user, or maybe to ask the user to confirm something before continuing. A C# MessageBox is a read-only dialog box which means that the text displayed in the MessageBox cannot be edited by the end user.

With C#.NET it is very easy to display a message box. The following line of code will display the simplest form of message box available.

MessageBox.Show("Hello from daveoncsharp.com!");

MessageBox is the C# message box class which is part of the System.Windows.Forms namespace and Show() is the static method we must call in order to display the message box on screen. When we execute the code we would be shown a dialog which looks like the following when running under Microsoft Windows Vista:

Adding a Caption

A message box caption is the text which is displayed in the title bar of the message box. To add a caption to our message box we have to pass the text we want to display as another parameter in the Show() method. In this example we are going to write “Welcome” in the caption.

MessageBox.Show("Hello from daveoncsharp.com!", "Welcome");

Customizing Buttons

The C# MessageBox class allows you to customize your message box’s functionality and style by assigning different buttons. There are six different button styles which can be used and they are shown below:

MessageBoxButtons	Buttons Displayed
OK
OKCancel
RetryCancel
YesNo
YesNoCancel
AbortRetryIgnore

Now let’s change our simple message box to display the YesNo buttons instead of the default OK button. To do this we have to add a third parameter to the Show() method of the MessageBox class as shown below (Note I have split the MessageBox.Show() method over three lines. This does not affect the compiler because C# still regards it as a whole line.):

MessageBox.Show("Hello from daveoncsharp.com!",
                "Welcome",
                MessageBoxButtons.YesNo);

Setting the Icon

With C# you can choose to display a number of predefined icons on your message box or you may choose to not display an icon at all. Below is a list of the available icons.

MessageBoxIcon	Icon
Asterisk
Error
Exclamation
Hand
Information
None
Question
Stop
Warning

You can select which icon to display, if any, by using  the MessageBoxIcon enumeration and adding it as the next parameter to the Show() method of the MessageBox. This is shown below where we are displaying the Question icon.

MessageBox.Show("Do you want to continue?",
                "A Question",
                MessageBoxButtons.YesNo,
                MessageBoxIcon.Question);

Setting the Default Button

The default button is the currently selected or highlighted button, and if not manually set, the default button is decided by the operating system.The C# MessageBox accepts a parameter of type MessageBoxDefaultButton which is another enumeration and contains three values – Button1, Button2, and Button3. One of these values can be added as a parameter to the Show() method of the MessageBox class as seen below:

MessageBox.Show("Do you want to continue?",
                "A Question",
                MessageBoxButtons.YesNo,
                MessageBoxIcon.Question,
                MessageBoxDefaultButton.Button2);

Since our example message box is using MessageBoxButtons.YesNo, and therefore only has two buttons, we cannot make use of MessageBoxDefaultButton.Button3 as a third button does not exist. If we try and use Button3 in this situation, the value will be ignored and the default button will be set by the operating system.

So far our message box looks like this:

Capturing Button Return Values

Obviously, after you customize a message box’s buttons you will want to know which button the user clicked. This is very simple to do as the Show() method of the MessageBox class returns a value of type DialogResult which is another enumeration with the value of the selected button.

The below example is showing how different code can be executed according to which button the user selects.

if (MessageBox.Show("Do you want to continue?",
                    "A Question",
                    MessageBoxButtons.YesNo,
                    MessageBoxIcon.Question,
                    MessageBoxDefaultButton.Button2) == DialogResult.No)
{
    // The user clicked the 'No' button
}
else
{
    // The user clicked the 'Yes' button
}

Conclusion

This concludes my explanation of the simple properties of a C# MessageBox. There are a few other parameters which can be passed to the Show() method such as text alignment options for different cultures, and options to show a help button which links to a help file, but these are more advanced topics which I will be covering in the future.

Thanks for reading this article – I hope it was of some help. Please feel free to leave any comments below.

Stay tuned to this blog for more articles in the near future.

Dave