Данный спиок вопросов и ответов на них содержит наиболее часто
задаваемые вопросы по использованию в своих программах для microsoft
windows 95 и microsoft windows nt 4.0 возможности оболочки, называемой
system tray.

Часть 1. Комментарий.

Я хочу поблагадорить:
andy nicks (2:5031/16.2@fidonet), kirill pushkin (2:5030/219.19),
а так же программистов петербургской фирмы «ПРОМТ», без этих людей
вряд ли я бы написал этот faq.

Любые пожелания, поправки, уточнения принимаются !
Распространение — свободное !

Часть 2. Версии.

19 января 1997 года — Версия 1.1, появились вопросы 11 и 12, исправлен
код в ответе на вопрос 8.
15 января 1997 года — Версия 1.0, впервые написан.

Часть 3. Содержание.
q1 Что такое system tray ?
q2 Как мне перенести свою программу на tray ?
q3 Что такое иконка на tray ?
q4 Как добавить иконку на tray ?
q5 А как ее там изменить ?
q6 А как удалить иконку с tray ?
q7 Как мне узнать о воздействии мыши на иконку, находящуюся на
tray ?
q8 Многие программы показывают pop-up меню при щелчке на их иконке,
как этого добиться ?

q9 Многие программы минимизируясь, оказываются на tray, как это
сделать ?
q10 Всегда ли все вышесказанное будет работать ?
q11 А есть ли официальная информация по system tray ?
q12 Как сделать пункт «по умолчанию» в pop-up меню выделенным ?

Часть 4. Собственно faq.
======================================================================
q1: Что такое system tray ? О чем идет речь ?
a1: Если Вы в операционной ситеме windows«95 или windows nt 4.0
пользуетесь оболочкой explorer, то справа на taskbar»е Вы
должны были видеть «углубленную» область в которой, обычно,
помещаются часы, переключатель клавиатуры, регулятор громкости и
некоторые другие утилиты. Они изображаются маленькими иконками и
для них существуют tooltip«ы как для кнопок toolbar»ов. При
щелчке или двойном щелчке по такой иконке программа обычно
выполняет действие по умолчанию, а при щелчке правой кнопкой
показывает pop-up меню.
hа уровне оболочки system tray это приложение, поддерживающее
окно, которое вы видите как «углубленную» область и некоторый
сервис для работы с этим окном.
======================================================================

q2: Как мне перенести свою программу на tray ?
a2: Это типичный вопрос программиста, пишущего какую-нибудь утилиту,
работающую в background во время всей работы операционной системы
(в dos такие утилиты делались tsr-программами). hо вопрос
поставлен не корректно.

Обычно задавае этот вопрос программист имеет в виду примерно
следующее : «Моя программа работает [почти] все время в
минимизированном состоянии и очень жалко места под ее кнопку на
taskbar«е. Как мне сделать, что бы при минимизации [старте|все
время] моя программа представлялась иконкой на system tray»е и
отвечала на сообщения мыши от этой иконки ?»
Ответ на этот вопрос состоит из нескольких частей. Смотри
следующие вопросы и ответы на них.
======================================================================

q3: Что такое иконка на system tray ?
a3: Ответ на этот вопрос объясняет некорректность вопроса 2. Иконка
на tray«е это просто картинка, а не окно какой-либо
программы (исследование системы с помощью microsoft spy++ for
windows 95 показывает, что это не окно вообще). system tray
отслеживает события мыши над иконкой и, в случае надобности,
показывает tooltip для этой иконки. Так же он отсылает сообщения
о всех действиях мыши над иконкой окну, которое поместило иконку
на tray.

Таким образом, нельзя поместить программу на tray. Любая
программа может добавить стоько иконок на tray, сколько ей
необходимо. При этом главное окно программы не обязано исчезать
или минимизироватся — примером может служить microsoft internet
mail, помещающая иконку «конверт» на tray в случае появления
новых писем.
======================================================================

q4: Как добавить иконку на tray ?
a4: Для работы с systemtray существует всего одна функция. Вот ее
Си-прототип:
winshellapi bool winapi shell_notifyicon(
dword dwmessage, // message identifier
pnotifyicondata pnid // pointer to structure
);
Эта функция описана в заголовочном файле win32-sdk «shellapi.h»,
включаемом в программу при включении «windows.h». Параметр
dwmessage может принимать одно из трех значений: nim_add,
nim_delete, nim_modify. Для добавления иконки он должен быть
установлен в nim_add.

Параметр pnid имеет тип pnotifydata, который описан как:
typedef struct _notifyicondata { // nid
dword cbsize;
hwnd hwnd;
uint uid;
uint uflags;
uint ucallbackmessage;
hicon hicon;
char sztip[64];
} notifyicondata, *pnotifyicondata;
Поля структуры notifyicondata имеют следующий смысл:
cbsize — размер структуры, должен быть
sizeof(notifyicondata).
hwnd — дескриптор окна, которое будет получать события
мыши над иконкой.
uid — уникальный идентификатор иконки. Идентификатор
должен быть уникален в пределах окна — обрабо-
тчика, передаваемого в hwnd.
uflags — битовое поле, определяющее какое из следующих
полей несет действительную информацию.

Может быть одним из следующих значений: nif_icon,
nif_message, nif_tip или их or-комбинацией.
ucallbackmessage — сообщение, передаваемое окну — обработчику при
событиях мыши. Желательно получать номер
сообщения вызовом registerwindowmessage(),
но допускаются и значения wm_user+n, где n > 0.
hicon — дескриптор иконки, помещаемой на tray.
sztip — текст для tooltip»а, если sztip[0] = 0x00, то
tooltip«а не будет.

Таким образом, для добавления иконки на tray необходимо
заполнить экземпляр структуры notifyicondata и вызвать функцию
shell_notifyicon() с параметром nim_add и указателем на
заполненный экземпляр структуры.

При добавлении иконки необходимо заполнить поля cbsize, hwnd,
uid, uflags, ucallbackmessage, hicon. Поле sztip можно оставить
пустым, если вам не нужен tooltip. Поле uflags должно содержать
как минимум nif_message | nif_icon.
======================================================================

q5: Я добавил иконку на tray, а как ее там изменить ?
a5: После добавления иконки на tray можно менять саму иконку, tooltip
и сообщение, посылаемое окну. Для этого необходимо заполнить
экземпляр структуры notifyicondata и вызвать функцию
shell_notifyicon() с параметром nim_modify и указателем
на заполненный экземпляр структуры.

При изменении иконки необходимо заполнить поля cbsize, hwnd,
uid, uflags и поля, отвечающие за параметры иконки, которые вы
хотите менять. При этом uflags должен содержать комбинацию
флагов, описывающую поля, которые необходимо менять.
======================================================================

q6: А как удалить иконку с tray ?
a6: Для удаления иконки вы должны знать ее id и дескриптор
окна-обработчика сообщений.

Для удаления иконки с tray надо вызвать функцию
shell_notifyicon() с параметром nim_delete и указателем на
экземпляр структуры notifyicondata, у которого должны быть
заполнены следующие поля: cbsize, hwnd, uid.
======================================================================

q7: Как мне узнать о воздействии мыши на иконку, находящуюся на tray ?
a7: При добавлении иконки на tray вы указывали окно — обработчик
сообщения и сообщение (callbackmessage). Теперь окно, указанное
вами будет при любых событиях мыши, происходящих над иконкой
получать сообщение, указанное при добавлении иконки. При этом
параметры lparam и wparam будут задействованы следующим образом:
(uint)wparam — содержит id иконки, над которой произошло
событие
(uint)lparam — содержит стандартное событие мыши, такое
как wm_mousemove или wm_lbuttondown.

При этом, информация о клавишах смены регистра, так же как и
местоположения события, передаваемые при стандартных «настоящих»
сообщениях мыши, теряются.
hо положение курсора можно узнать функцией getcursorpos(), а
состояние клавиш смены регистра — функцией getkeystate(),
описанных в winuser.h.
======================================================================

q8: Многие программы показывают pop-up меню при щелчке на их иконке,
помещенной на tray, как этого добиться ?
a8: Вы должны обрабатывать сообщение, указанное вами при добавлении
иконки на tray. При значении (uint)lparam, равном wm_rbuttondown
(это обычно дял pop-up меню по правой кнопке), или любому другому
необходимому вам, вы должны вызовом функции getcursorpos()
получить позицию курсора в момент события (вряд ли пользователь
успеет убрать мышь за время обработки сообщения, особенно если
он ожидает меню), получить вескриптор pop-up меню одним из многих
способов (loadmenu(), getsubmenu(), createmenu(), и т.д.) и
выполнить следующий код:

setforegroundwindow(hwnd);
trackpopupmenuex(hmenu,tpm_horizontal|tpm_leftalign,x, y,hwnd,
null);
destroymenu(hmenu);
postmessage(hwnd,wm_user,0,0);

где hwnd — дескриптор окна, которое будет обрабатывать команду
меню, hmenu — дескриптор меню, x и y — позиция курсора. Для
подробностей смотрите win32 sdk help по функции trackpopupmenuex.
======================================================================

q9: Многие программы минимизируясь, оказываются на tray, как это
сделать ?
a9: hа самом деле, не «программа оказывается на tray», а только
иконка помещается на tray, а главное окно программы скрывается.

Для достижения такого результата вам надо обрабатывать сообщение
wm_size, и при значении wparam, равном size_minimized вы должны
выполнить примерно следующую последовательность действий:
добавить иконку на tray и скрыть окно — вызвать showindow(hwnd,
sw_hide).

Когда произойдет действие, которое должго активировать вашу
программу — wm_lbuttondblclk или wm_lbuttondown (или то, что
нравится вам), вы должны удалить иконку и вызвать
showwindow(hwnd,sw_show) или showwindow(hwnd,sw_showmaximized).
======================================================================

q10: Всегда ли все вышесказанное будет работать ?
a10: hет ! Все вышенаписанное работает только при использовании в
операционных системах windows 95 и windows nt 4.0 оболочки
explorer, и при разрешенном system tray. В случае, если не
происходит запуска systray.exe (запускаетс автоматически
explorer»ом при старте) или используется другая оболочка
(dashboard, program manager, file manager), функция
shell_notifyicon() будет возвращать при вызове false и не
выполнять ни каких действий.

Еще раз повторю: system tray — это возможность оболочки, а не
операционной системы !
======================================================================

q11: А есть ли официальная информация по system tray ?
a11: Да, есть. Есть маленький пример в win32 sdk:
sdkrootsampleswin32win95traynot*.*
hу и конечно описание в документации функции shell_notifyicon()
и структуры notifyicondata.

Так же можно посмотреть microsoft knowledge base:
pss id number: q128129
pss id number: q134237
pss id number: q139408
======================================================================

q12: Как сделать пункт «по умолчанию» в pop-up меню выделенным ?
a12: Вообще-то, это вопрос не относящийся к system tray, а
относящийся к меню. hо можно ответить и на него.

Устанавливается пункт «по умолчанию» в любом меню функцией api
setmenudefaultitem(hmenu hmenu, uint uitem, uint fbypos),
подробности — в win32 sdk документации. Пункт «По умолчанию» не
влияет на работу меню — это чисто интерфейсное выделение пункта
меню полужирным (bold) шрифтом.