Q: Hаиболее часто задаваемые вопросы по SystemTary.

                   Автор - Лев Серебряков (Lev Serebryakov),
                  2:5030/219.33@fidonet или lev@spb.runnet.ru
                                   Версия 1.1

 Часть 0. О чем.
        Данный  спиок  вопросов  и  ответов  на них содержит наиболее часто
   задаваемые  вопросы  по  использованию  в своих программах для 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:
         SDKRoot\Samples\Win32\Win95\TrayNot\*.*
      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) шрифтом.

ЗЫ Авторский текст сохранён полностью.
ЗЫ2 Если это "очень сложно", то пользyйтесь RXTrayIcon
ЗЫ3 При вопросе "а что такое Rx" - в морг...

======== Дополнение ========
Q11. При перезапуске Windows Explorer из System Tray пропадают
     вставленные туда значки. Как с этим бороться.
A11. Microsoft? Internet Explorer 4.0 оповещает приложения при
     создании таскбара. При создании он регистрирует сообщение
     функцией RegisterWindowMessage со строкой 'TaskbarCreated' и
     рассылает его всем top-level окнам. Когда Ваше приложение
     получает такое сообщение оно должно заново добавить значки в
     System Tray. Особенно полезно для сервисов.