Открытие окна сообщения (WPF .NET)

Окно сообщения — это диалоговое окно, которое используется для быстрого отображения информации. Дополнительно оно позволяет пользователям принимать решения. Доступ к окну сообщения предоставляется классом MessageBox. Окно сообщения отображается в модальном режиме. А выполнение кода, отображающего окно сообщения, приостанавливается, пока пользователь не закроет окно сообщения с помощью кнопки закрытия или кнопки ответа.

На следующем рисунке демонстрируются части окна сообщения:

• Заголовок окна с подписью (1).
• Кнопка «Закрыть» (2).
• Значок (3).
• Сообщение, отображаемое пользователю (4).
• Кнопки ответа (5).

Для представления или сбора сложных данных диалоговое окно может подходить больше, чем окно сообщения. Дополнительные сведения см. в разделе Общие сведения о диалоговых окнах.

Отображение окна сообщения

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

string messageBoxText = "Do you want to save changes?";
string caption = "Word Processor";
MessageBoxButton button = MessageBoxButton.YesNoCancel;
MessageBoxImage icon = MessageBoxImage.Warning;
MessageBoxResult result;

result = MessageBox.Show(messageBoxText, caption, button, icon, MessageBoxResult.Yes);

Dim messageBoxText As String = "Do you want to save changes?"
Dim caption As String = "Word Processor"
Dim Button As MessageBoxButton = MessageBoxButton.YesNoCancel
Dim Icon As MessageBoxImage = MessageBoxImage.Warning
Dim result As MessageBoxResult

result = MessageBox.Show(messageBoxText, caption, Button, Icon, MessageBoxResult.Yes)

Перегрузки метода MessageBox.Show предоставляют способы настройки окна сообщения. Вот какие параметры доступны:

• Заголовок окна
• Значок сообщения
• Текст сообщения
• Кнопки ответа

Ниже приведено еще несколько примеров использования окна сообщения.

• Отображает оповещение.

  MessageBox.Show("Unable to save file, try again.");
  

  MessageBox.Show("Unable to save file, try again.")
  

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

  

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

  MessageBox.Show("Unable to save file, try again.", "Save error", MessageBoxButton.OK, MessageBoxImage.Error);
  

  MessageBox.Show("Unable to save file, try again.", "Save error", MessageBoxButton.OK, MessageBoxImage.Error)
  

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

  

• Отображает предупреждение.

  MessageBox.Show("If you close the next window without saving, your changes will be lost.", "Configuration", MessageBoxButton.OK, MessageBoxImage.Warning);
  

  MessageBox.Show("If you close the next window without saving, your changes will be lost.", "Configuration", MessageBoxButton.OK, MessageBoxImage.Warning)
  

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

  

• Задает вопрос пользователю.

  if (MessageBox.Show("If the file save fails, do you want to automatically try again?",
                      "Save file",
                      MessageBoxButton.YesNo,
                      MessageBoxImage.Question) == MessageBoxResult.Yes)
  {
      // Do something here
  }
  

  If MessageBox.Show("If the file save fails, do you want to automatically try again?",
                     "Save file",
                     MessageBoxButton.YesNo,
                     MessageBoxImage.Question) = MessageBoxResult.Yes Then
  
      ' Do something here
  
  End If
  

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

  

Обработка ответа в окне сообщения

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

result = MessageBox.Show(messageBoxText, caption, button, icon, MessageBoxResult.Yes);

switch (result)
{
    case MessageBoxResult.Cancel:
        // User pressed Cancel
        break;
    case MessageBoxResult.Yes:
        // User pressed Yes
        break;
    case MessageBoxResult.No:
        // User pressed No
        break;
}

result = MessageBox.Show(messageBoxText, caption, Button, Icon, MessageBoxResult.Yes)

Select Case result
    Case MessageBoxResult.Cancel
        ' User pressed Cancel
    Case MessageBoxResult.Yes
        ' User pressed Yes
    Case MessageBoxResult.No
        ' User pressed No
End Select

Когда пользователь нажимает кнопки в нижней части окна сообщения, возвращается соответствующий результат MessageBoxResult. Однако, если пользователь нажимает клавишу ESC или кнопку Закрыть (№ 2 на рисунке окна сообщения), результат окна сообщения зависит от параметров кнопки:

Параметры кнопок	Результат для кнопки ESC или Закрыть
OK	OK
OKCancel	Cancel
YesNo	Клавиша клавиатуры ESC и кнопка Закрыть отключены. Пользователю необходимо нажать Yes (Да) или No (Нет).
YesNoCancel	Cancel

Дополнительные сведения об использовании окон сообщений см. в описании MessageBox и примере MessageBox.

См. также

• Общие сведения об окнах WPF
• Общие сведения о диалоговых окнах
• Отображение общего диалогового окна
• Пример MessageBox
• System.Windows.MessageBox
• System.Windows.MessageBox.Show
• System.Windows.MessageBoxResult