Поделиться через

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

  • Статья

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

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

Рисунок, показывающий части окна сообщения для WPF.

  • Заголовок окна с подписью (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.")

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

    Простое окно сообщения для WPF, которое не имеет параметров, настроенных.

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

    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)

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

    Поле предупреждения для WPF с значком, подписью и текстом.

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

    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)

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

    Простое окно сообщения для WPF с значком предупреждения.

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

    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

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

    Простое окно сообщения для WPF, которое запрашивает у пользователя вопрос

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

Метод 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.

См. также