1.6.3. Сообщения приложения для пользователя

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

int WINAPI MessageBox (

HWND hwnd, //Дескриптор родительского окна

LPCTSTR lpText, //Адрес текста сообщения

LPCTSTR lpCaption, //Адрес заголовка окна сообщения

UINT uType //Стиль окна сообщения

);

Если hwnd = NULL, окно сообщения не имеет родительского окна. При lpCaption = NULL в заголовке по умолчанию выводится строка "Ошибка".

Параметр uType задают в виде комбинации флажков, определяющих содержание и поведение окна сообщения.

Следующие флаги определяют список кнопок окна сообщения:

Флаг	Список имен кнопок
MB_ABORTRETRYIGNORE	"Стоп", "Повтор" и "Пропустить"
МВ_ОК	ОК
MB_OKCANCEL	ОК и "Отмена"
MB_RETRYCANCEL	"Повтор" и "Отмена"
MB_YESNO	"Да" и "Нет"
MB_YESNOCANCEL	"Да", "Нет" и "Отмена"

Жирным шрифтом выделены кнопки по умолчанию. По умолчанию активна первая кнопка. Следующие флаги могут назначить одну из кнопок активной по умолчанию:

Флаг	Номер кнопки	Флаг	Номер кнопки
MB_DEFBUTTON1	Первая	MB_DEFBUTTON3	Третья
MB_DEFBUTTON2	Вторая	MB_DEFBUTTON4	Четвертая

Следующие флаги включают одну иконку в окно сообщения:

Флаги	Вид иконки
MB_ICONEXCLAMATION, MB_ICONWARNING	Восклицательный знак
MB_ICONINFORMATION, MB_ICONASTERISK	Символ i
MB_ICONQUESTION	Знак вопроса
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND	Знак остановки

Следующие флаги определяют стиль окна сообщения:

Флаг	Пояснение
MB_APPLMODAL	Этот стиль по умолчанию. Окно hwnd переводится в неактивное состояние на время работы окна сообщения, но можно активизировать другие приложения или окна, не дочерние по отношению к hwnd
MB_SYSTEMMODAL	На время работы окна сообщения все другие приложения в неактивном состоянии
MB_TASKMODAL	Этот стиль подобен MB_APPLMODAL. Но если родительское окно не указано (hwnd = NULL), блокируются все перекрывающиеся окна этого приложения
MB_HELP	Добавляет кнопку "Справка" в окне сообщения
MB_RIGHT	Текст выравнивается по правому краю
MB_RTLREADING	Отображает символы сообщения и текста заголовка в направлении справа налево
MB_SETFOREGROUND	Окно сообщения выдвигается на передний план

Приложение может обработать ответ пользователя на сообщение, анализируя возвращаемое функцией MessageBox значение. В случае ошибки возвращается 0. Иначе функция MessageBox возвращает константу, соответствующую нажатой кнопке. Ниже перечислены имена констант, соответствующие кнопкам окна сообщения:

Константа	Нажата кнопка	Константа	Нажата кнопка
IDABORT	"Стоп"	IDOK	ОК
IDCANCEL	"Отмена"	IDRETRY	"Повтор"
IDIGNORE	"Пропустить"	IDYES	"Да"
IDNO	"Нет"

Если окно сообщения содержит кнопку "Отмена", то значение IDCANCEL может быть возвращено и при нажатии клавиши Esc.

Windows предусматривает возможность выдачи и звуковых "сообщений". Например, при вызове функции MessageBeep компьютер проигрывает "звук" из множества зарегистрированных в системе "звуков". Синтаксис этой функции:

BOOL MessageBeep( UINT uType);

Параметр uType этой функции определяет звуковой тип и принимает одно из следующих значений:

Значение	Обозначение в файле win.ini
0xFFFFFFFF или -1	Стандартный звуковой сигнал
MB_ICONASTERISK	SystemAsterisk
MB_ICONEXCLAMATION	SystemExclamation
MB_ICONHAND	SystemHand
MB_ICONQUESTION	SystemQuestion
МВ_ОК или 0	SystemDefault

В случае успешного выполнения функция возвращает ненулевое значение, иначе – 0. После передачи сообщения о формировании звука, функция MessageBeep прекращает работу. Далее выполняются последующие операторы приложения, и одновременно проигрывается указанный звук.

Если требуется обратить внимание пользователя на определенное окно, то можно несколько раз изменить подсветку окна или его пиктограммы.

Для этой цели используют функцию FlashWindow, которая за один вызов один раз изменяет подсветку указанного окна:

BOOL FlashWindow(

HWND hwnd, //Дескриптор подсвечиваемого окна

BOOL bInvert //Параметр подсветки

);

Если параметр bInvert = TRUE, окно меняет подсветку. Если же bInvert = FALSE, окно только возвращается к исходному состоянию.

При подсветке неактивное окно может принять внешний вид активного окна, но не получит фокуса ввода.

Если окно было активно до вызова FlashWindow, возвращается ненулевое значение. Если окно не было активно, возвращается 0.

Пример 1.1.

После нажатия левой клавиши мыши над окном hwnd 5 раз изменить подсветку неактивного окна OwnedHwnd.

Следующий фрагмент описывает версию решения этой задачи:

case WM_LBUTTONDOWN:

{ FlashWindow(OwnedHwnd, TRUE);

for (int i=0; i<9; i++)

{ for (long j=0;j<1e7;j++);

FlashWindow(OwnedHwnd, TRUE);

}

return 0;

}

После нажатия левой клавиши мыши окно OwnedHwnd примет вид активного окна:

FlashWindow(OwnedHwnd, TRUE);

При i = 0 выполняется некая "работа", обозначенная циклом

for (long j=0; j<1e7; j++);

Эта работа сводится к простой задержке времени. После этой паузы окно OwnedHwnd примет вид неактивного окна. При i = 1 после паузы окно OwnedHwnd примет вид активного окна, а при i = 2 после паузы окно OwnedHwnd примет вид неактивного окна... Таким образом, окно OwnedHwnd 5 раз изменяет свой внешний вид.