(https://msdn.microsoft.com/ru-ru/library/system.windows.forms.messagebox.show)
(https://msdn.microsoft.com/ru-ru/library/tk4wkzwk)
Синтаксис использования метода имеет следующий вид:
ReturnValue = MessageBox::Show([owner], text, [caption], [buttons],
[icon], [defaultButton], [options],
[helpFilePath, navigator, param]);
Рис.4.3. Варианты окна сообщения MessageBox
где:
– owner – указывает окно, которому будет принадлежать данное модальное диалоговое окно;
– text – текст, отображаемый в окне сообщения;
– caption – текст, отображаемый в заголовке окна сообщения;
– buttons – определяет набор кнопок в окне сообщения. Один из типовых наборов кнопок выбирается соответствующей константой из перечисления System::Windows::Forms::MessageBoxButtons (таблица 4.9);
– icon – определяет вид пиктограммы в окне сообщения. Вид пиктограммы определяется соответствующей константой из перечисления System::Windows::Forms::MessageBoxIcon (таблица 4.9);
– defaultButton – определяет кнопку по умолчанию в окне сообщения. Для этого используется соответствующая константа из перечисления System::Windows::Forms::MessageBoxDefaultButton (таблица 4.9);
– options – определяет вариант отображения окна сообщения и способ отображения текста в нем. Для этого используются соответствующие константы из перечисления System::Windows::Forms::MessageBoxOptions (таблица 4.9). Задание нуля означает использование настроек по умолчанию;
– helpFilePath – строка, содержащая путь и имя файла справки, который отображается при нажатии кнопки "Help" ("Справка");
– navigator – определяет способ доступа к элементам файла справки. Для этого используется соответствующая константа из перечисления System::Windows::Forms::HelpNavigator (таблица 4.10);
– param – числовой идентификатор раздела cправки, который отображается при нажатии кнопки "Help" ("Справка");
|
– ReturnValue – возвращаемое значение, позволяющее определить нажатую пользователем кнопку в окне сообщения. Для этого используется соответствующая константа из перечисления System::Windows::Forms::DialogResult (таблица 4.11).
Таблица 4.9. Константы, используемые в методе Show из класса MessageBox
Константа | Значение | Назначение |
Перечисление MessageBoxButtons | ||
MessageBoxButtons.OK | Отображается только кнопка ОК | |
MessageBoxButtons.OKCancel | Отображаются кнопки ОК и Cancel (Отмена) | |
MessageBoxButtons.AbortRetryIgnore | Отображаются кнопки Abort (Прервать), Retry (Повторить) и Ignore (Пропустить) | |
MessageBoxButtons.YesNoCancel | Отображаются кнопки Yes (Да), No (Нет) и Cancel (Отмена) | |
MessageBoxButtons.YesNo | Отображаются кнопки Yes (Да), No (Нет) | |
MessageBoxButtons.RetryCancel | Отображаются кнопки Retry (Повторить) и Cancel (Отмена) | |
Перечисление MessageBoxIcon | ||
MessageBoxIcon.None | Окно сообщения не содержит ни каких пиктограмм | |
MessageBoxIcon.Error MessageBoxIcon.Hand MessageBoxIcon.Stop | Отображается пиктограмма "Ошибка" – ![]() | |
MessageBoxIcon.Question | Отображается пиктограмма "Запрос" – ![]() | |
MessageBoxIcon.Exclamation MessageBoxIcon.Warning | Отображается пиктограмма "Предупреждение" – ![]() | |
MessageBoxIcon.Information MessageBoxIcon.Asterisk | Отображается пиктограмма "Информация" – ![]() | |
Перечисление MessageBoxDefaultButton | ||
MessageBoxDefaultButton.Button1 | Первая кнопка в окне задается кнопкой по умолчанию | |
MessageBoxDefaultButton.Button2 | Вторая кнопка в окне задается кнопкой по умолчанию | |
MessageBoxDefaultButton.Button3 | Третья кнопка в окне задается кнопкой по умолчанию | |
Перечисление MessageBoxOptions | ||
MessageBoxOptions.DefaultDesktopOnly | Окно сообщения (с параметрами по умолчанию) отображается на активном рабочем столе, =217 | |
MessageBoxOptions.RightAlign | Текст в окне сообщения выравнивается по правому краю, =219 | |
MessageBoxOptions.RtlReading | Текст в окне сообщения отображается с порядком чтения справа налево (еврейский, арабский), =220 | |
MessageBoxOptions.ServiceNotification | Окно сообщения отображается на текущем активном рабочем столе даже в том случае, если ни один пользователь не зарегистрирован в системе, = 221 |
|
Таблица 4.10. Константы (из перечисления System::Windows::Forms::HelpNavigator),
для доступа к элементам файла Справки
Имя члена | Описание |
Topic | Открытие файла Справки в указанной теме, если эта тема существует |
TableOfContents | Открытие файла Справки по оглавлению |
Index | Открытие файла Справки для индексации |
Find | Открытие файла Справки на странице поиска |
AssociateIndex | Открытие файла Справки на элементе указателя на первый символ указанного раздела |
KeywordIndex | Открытие файла Справки в разделе с записью указанного индекса, если он существует; в противном случае отображается элемент указателя, ближайший к указанному ключевому слову |
TopicId | Открытие файла Справки в разделе, заданном числовым идентификатором раздела |
Таблица 4.11. Константы (из перечисления System::Windows::Forms::DialogResult),
соответствующие возвращаемым методом Show значениям
Константа | Значение | Нажатая кнопка |
OK | OK | |
Cancel | Cancel (Отмена) (этому же значению соответствует и нажатие кнопки Ï – Закрыть в строе заголовка окна сообщения) | |
Abort | Abort (Стоп) | |
Retry | Retry (Повторить) | |
Ignore | Ignore (Пропустить) | |
Yes | Yes (Да) | |
No | No (Нет) | |
None | Значение Nothing возвращается из диалогового окна. Это означает, что модальное диалоговое окно продолжает свою работу |
|
Пример 4.7. Использование метода Show класса MessageBox для отображения окна сообщения с запросом сохранения файла. В зависимости от того, какая кнопка была нажата в ответ на запрос, будут выполнены те или иные действия.
using namespace System;
using namespace System::Windows::Forms;
...
System::Windows::Forms::DialogResult result =
MessageBox::Show(this,
"Сохранить изменения в файле test.txt?", // Текст сообщения
"MyApplication", // Заголовок