AddSysTrayIcon()

Синтаксис

Result = AddSysTrayIcon(#SysTrayIcon , WindowID , ImageID)

Описание

Добавляет значок в область SysTray.

Параметры

#SysTrayIcon	Номер для идентификации нового значка SysTray. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
WindowID	Идентификатор Окна, на котором будут обрабатываться события SysTray. Корректный идентификатор 'WindowID' можно получить с помощью функции WindowID().
ImageID	Идентификатор используемого для значка изображения, ранее загруженного с помощью функции LoadImage() или с помощью функции CatchImage(). Иконки как тип изображений (.ico) поддерживаются только в Windows, в Linux рекомендуется использовать изображения в формате PNG (чтобы иметь слой прозрачности). Идентификатор изображения можно получить с помощью функции ImageID().

Возвращаемое значение

Возвращает не нулевое значение, если значок в SysTray был успешно добавлен, в противном случае 0.

Комментарии

Когда с каким-либо значком в SysTray происходит событие, возвращается событие #PB_Event_SysTray. Узнать, какой конкретно значок задействован, можно с помощью функции EventGadget(). Также эта функция пополняет список событий функции EventType().

При завершении программы, все оставшиеся значки в SysTray будут удалены автоматически.

Пример (Фран)

If OpenWindow(0, 100, 150, 300, 100, "Область уведомлений (SysTray)", #PB_Window_SystemMenu)

    UsePNGImageDecoder()

    Icone$ = #PB_Compiler_Home + "examples/sources/Data/world.png"

    ; Добавление значка в область уведомлений (SysTray)
    AddSysTrayIcon(0, WindowID(0), LoadImage(0, Icone$))

    Repeat
        Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow

EndIf

См. также

RemoveSysTrayIcon(), ChangeSysTrayIcon()

Поддерживаемые OS

Все