Работа с окнами оповещений в трее на Ассемблере

Окно оповещения в системном трее, оно же System Tray Balloon Notification, - очень удобный инструмент для взаимодействия с пользователем и оповещения его о каких-либо событиях. Когда у меня возникла необходимость, в этих ваших интернетах нашлось не так много материалов по работе с такими оповещениями, а тем более на Ассемблере. Пришлось разбираться самому. Зато теперь я попробую хоть чуть-чуть восполнить этот пробел.

Как обычно, все начинается с описания большого количества констант, которые FASM в заводской комплектации не знает. Пока я ограничусь краткими комментариями, в дальнейшем по тексту значения и применение констант будут описаны более подробно.Основная работа выполняется через структуру NOTIFYICONDATA. В принципе, FASM ее знает, но только самую первую, базовую версию. Поэтому все равно придется определить структуру новой версии самостоятельно:Небольшое лирическое отступление. В статье часто используются термины "уведомление", причем, как правило, рядом, но в разном контексте. Вы должны понимать, что фраза "отправляет уведомление окну" подразумевает отправку notification message, а словосочетание "показывать уведомление" в значении "balloon notification" используется в локализованной версии Windows. Я очень надеюсь, что вы разберетесь.

Чтобы выводить уведомления, надо сперва добавить в системный трей иконку, к которой эти уведомления и будут привязаны. Делается это при помощи функции Shell_NotifyIcon. В любом руководстве по программированию наверняка найдется пример заполнения структуры NOTIFYICONDATA и вызова Shell_NotifyIcon. Здесь почти все то же самое, но с некоторыми дополнениями. Поле uVersion заполняется значением NOTIFYICON_VERSION_4, тем самым обозначая, что должны использоваться флаги и события, которые введены в систему, начиная с Windows Vista. Для того, чтобы этот флаг вступил в силу, после добавления иконки в трей надо сразу же вызвать Shell_NotifyIcon с параметром NIM_SETVERSION.Отлично, иконка в трее создана. Теперь можно выводить уведомления. Начнем с самого простого уведомления - заголовок и текст с одной из стандартных системных иконок. Для этого поля szInfoTitle и szInfo заполняются, соответственно, строкой заголовка и текстом, который будет выведен в баллуне. Тип иконки задается в поле dwInfoFlags одним из стандартных значений, описанных в константах. По умолчанию используется маленькая иконка, а если надо показать большую, то к этому полю дополнительно применяется флаг-модификатор NIIF_LARGE_ICON. Если иконка вообще не нужна, то поле dwInfoFlags заполняется единственным значением NIIF_NONE.Чуть более сложный пример - окно уведомления с нашей собственной иконкой. Поля szInfoTitle и szInfo заполняются аналогично предыдущему примеру, а вот поле dwInfoFlags заполняется комбинацией флагов NIIF_USER и NIIF_LARGE_ICON. Хэндл пользовательской иконки заносится в поле hBalloonIcon. Важно! Если для системных иконок можно было выбирать большой или маленький размер, то пользовательские иконки выводятся без вариантов только в размере 32х32 пиксела и флаг NIIF_LARGE_ICON в этом случае обязателен! Маленькие иконки будут растянуты, большие, соответственно, отмасштабированы. Если флаг NIIF_LARGE_ICON не указать, то окно уведомления вообще не появится, даже если все остальные поля NOTIFYICONDATA были заполнены правильно.С отображением окна уведомления разобрались. Но одного отображения обычно мало, нужна обратная связь от пользователя. Для этого иконка должна быть создана с флагом NIF_MESSAGE и установлены поля uCallbackMessage и uID. Если все сделано правильно, то система будет отправлять сообщения окну приложения, к которому приписана иконка в трее. Обработка выполняется примерно так:В wParam приходит идентификатор иконки, а в lParam - полученное уведомление. Ничего сложного, но есть несколько особенностей, о которых я сейчас расскажу поподробнее.

Основное уведомление, которое баллун отправляет окну-владельцу, это NIN_BALLOONSHOW. Оно отправляется сразу же, как только окно уведомления появится на экране.

Система Windows устроена таким образом, что одновременно может быть открыто только одно окно оповещения. Если несколько приложений одновременно пытаются вывести свои окна, то по умолчанию они выстраиваются в очередь и следующее уведомление отображается только когда предыдущее закрывается. В этом случае уведомление NIN_BALLOONSHOW приходит в момент фактического появления окна. Если для приложения важно, чтобы уведомление отображало мгновенные события, его надо отображать с установленным флагом NIF_REALTIME в поле uFlags. Такое уведомление или отобразится мгновенно, если очередь не занята, или не отобразится никогда, если какое-то окно с уведомлением уже открыто. Хороший пример из документации - информирование о входящем звонке. Вряд ли кому-то будет интересно получить сообщение типа "вам звонят", когда фактически звонок уже давно закончился, но очередь до этого сообщения еще не дошла. Вы можете поэкспериментировать с очередью, запустив одновременно несколько копий тестовой программы и открыв из каждой несколько уведомлений.

Уведомление NIN_BALLOONHIDE приходит в том случае, если на уровне системы приложению запрещено выводить уведомления. Также оно отправляется, если в трее уже открыто какое-либо окно уведомления, а приложение пытается добавить свое окно с установленным флагом NIF_REALTIME в поле uFlags. В большинстве случаев это уведомление можно приравнивать к ситуации, когда баллун был просто закрыт. А если, например, надо обязательно уведомить пользователя о каком-то важном событии, то приложение может продублировать информацию через MessageBox или иным способом.

Когда поле uVersion имеет значение NOTIFYICON_VERSION_4, то есть используется система Windows Vista и выше, окно приложения получает дополнительные системные уведомления: NIN_POPUPOPEN и NIN_POPUPCLOSE. Для этого поле uFlags обязательно надо дополнить флагом NIF_SHOWTIP. Уведомление NIN_POPUPOPEN приходит когда курсор мыши наведен на иконку приложения в трее и появилась подсказка (текст из поля szTip). Когда курсор мыши выходит за пределы иконки и подсказка скрывается, приложению отправляется уведомление NIN_POPUPCLOSE. Оба уведомления передаются независимо от состояния и наличия окна оповещения. Затрудняюсь сказать, где на практике это можно использовать, но знать это будет полезно. Для совместимости с Windows XP в поле uVersion надо заносить нулевое значение, но тогда уведомления NIN_POPUPOPEN и NIN_POPUPCLOSE будут недоступны. Невелика потеря.

Уведомление NIN_BALLOONUSERCLICK приходит, когда пользователь кликнул на само окно, например, когда ему о чем-то сообщают и предлагают выполнить какое-нибудь действие на основании этой информации. После клика окно уведомления закрывается, но каких-либо других уведомлений о закрытии баллуна родительскому окну больше не поступает. Это же сообщение отправляется, если кликнуть на иконке в трее при открытом окне уведомления.

Кроме этого, баллун может быть закрыт принудительно кликом на "крестик" или по истечении времени, отведенного системой на показ всплывающих уведомлений. В обоих случаях родительскому окну отправляется уведомление NIN_BALLOONTIMEOUT. На мой взгляд логичней было бы разделить эти два события, они все-таки не равноценны, но разработчики Windows посчитали иначе.

В приложении пример программы с исходным текстом, которая выводит баллуны с пользовательской или стандартной иконкой и обрабатывает поступающие от них сообщения. Из-за описанных выше особенностей реализации, тестовая программа работоспособна на Windows Vista и выше.

Комментарии

Добавить комментарий

Для вставки цитаты выделите текст и нажмите сюда

Имя*:

Текст комментария (не более 2000 символов)*:

*Все поля обязательны для заполнения.

Комментарии, содержащие рекламу, ненормативную лексику, оскорбления и т.п., а также флуд и сообщения не по теме, будут удаляться. Нарушителям может быть заблокирован доступ к сайту.