Главная / Action Script 3
(Только AIR)
Пакетflash.desktop
Классpublic class SystemTrayIcon
НаследованиеSystemTrayIcon Inheritance InteractiveIcon Inheritance Icon Inheritance EventDispatcher Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Класс SystemTrayIcon представляет собой стиль значка, используемого в области уведомлений панели задач Windows taskbar®.

Значки на панели задач поддерживаются не всеми операционными системами. Выполните проверку NativeApplication.supportsSystemTrayIcon, чтобы узнать, поддерживает ли текущая ОС значки на панели задач.

Создать экземпляр класса SystemTrayIcon нельзя. Получите объект, представляющий значок на панели задач, из свойства icon "глобального" объекта NativeApplication.

Если поддержка значков на панели задач есть, то значок является типом SystemTrayIcon. В противном случае, тип icon является другим подклассом класса InteractiveIcon (обычно DockIcon).

Важно: попытка применить метод класса SystemTrayIcon к объекту NativeApplication.icon в ОС, где AIR не поддерживает работу со значками на панелях задач, приводит к ошибке.

См. также

flash.desktop.NativeApplication.icon
flash.desktop.NativeApplication.supportsSystemTrayIcon
flash.desktop.DockIcon


Общедоступные свойства
 СвойствоОпределено
  AIR-only bitmaps : Array
Изображение значка в массиве объектов BitmapData различных размеров.
SystemTrayIcon
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  AIR-only height : int
[только для чтения] Текущее значение высоты значка в пикселах.
SystemTrayIcon
  AIR-only menu : NativeMenu
Меню значка на панели задач.
SystemTrayIcon
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  AIR-only tooltip : String
Строка-подсказка, которая появляется при выполнении определенного действия над значок на панели задач.
SystemTrayIcon
  AIR-only width : int
[только для чтения] Текущее значение ширины значка в пикселах.
SystemTrayIcon
Общедоступные методы
 МетодОпределено
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
 Inherited
Передает событие в поток событий.
EventDispatcher
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
  Отправляется данным объектом SystemTrayIcon по щелчку левой кнопкой мыши.SystemTrayIcon
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
  Отправляется данным объектом SystemTrayIcon при нажатии левой кнопки мыши.SystemTrayIcon
  Отправляется данным объектом SystemTrayIcon при отпускании левой кнопки мыши.SystemTrayIcon
  Отправляется данным объектом SystemTrayIcon по щелчку правой кнопкой мыши.SystemTrayIcon
  Отправляется данным объектом SystemTrayIcon при нажатии правой кнопки мыши.SystemTrayIcon
  Отправляется данным объектом SystemTrayIcon при отпускании правой кнопки мыши.SystemTrayIcon
Общедоступные константы
 Константа Определено
  AIR-only MAX_TIP_LENGTH : Number = 63
[статические] Допустимая длина строки-подсказки значка на панели задач.
SystemTrayIcon
Сведения о свойстве
AIR-only bitmapsсвойство
bitmaps:Array  [чтение и запись]

Версии среды выполнения:  1.0

Изображение значка в массиве объектов BitmapData различных размеров.

При отображении значка в контексте конкретной ОС из массива выбирается изображение, размер которого в максимальной степени подходит под текущий размер экрана (при необходимости масштабируется). Обычные размеры включают: 16x16, 32x32, 48x48 и 128x128. (В ближайшем будущем в некоторых ОС могут использоваться значки размером 512x512 пикселов.)

В некоторых контекстах, если свойству bitmaps ничего присвоено не было, может использоваться значок ОС по умолчанию. В остальных контекстах значок не отображается.

Чтобы изменить вид значка, присвойте свойству bitmaps массив объектов BitmapData.

  icon.bitmaps = new Array(icon16x16.bitmapData, icon128x128.bitmapData);
  

Прямая модификация массива bitmaps ни к чему не приведет.

Чтобы убрать изображение значка, присвойте свойству bitmaps пустой массив.

Примечание. Загружайте файлы изображений для значков в формате PNG, так как этот формат обеспечивает наилучшее альфа-смешивание. Формат GIF не поддерживает сопряжение, а только включение или отключение прозрачности. Формат JPG не поддерживает прозрачность совсем.



Реализация
    public function get bitmaps():Array
    public function set bitmaps(value:Array):void
AIR-only heightсвойство 
height:int  [только для чтения]

Версии среды выполнения:  1.0

Текущее значение высоты значка в пикселах.

Некоторые контексты значков поддерживают динамические размеры. Свойство height обозначает высоту значка, выбранного из массива bitmaps для данного контекста. Если в ОС было использовано масштабирование, то текущее значение высоты может отличаться.



Реализация
    public function get height():int
AIR-only menuсвойство 
menu:NativeMenu  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Меню значка на панели задач.



Реализация
    public function get menu():NativeMenu
    public function set menu(value:NativeMenu):void
AIR-only tooltipсвойство 
tooltip:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Строка-подсказка, которая появляется при выполнении определенного действия над значок на панели задач. Если длина строки превышает значение, указанное в SystemTrayIcon.MAX_TIP_LENGTH, подсказка усекается.



Реализация
    public function get tooltip():String
    public function set tooltip(value:String):void
AIR-only widthсвойство 
width:int  [только для чтения]

Версии среды выполнения:  1.0

Текущее значение ширины значка в пикселах.

Некоторые контексты значков поддерживают динамические размеры. Свойство width обозначает ширину значка, выбранного из массива bitmaps для данного контекста. Если в ОС было использовано масштабирование, то текущее значение ширины может отличаться.



Реализация
    public function get width():int
Сведения о событии
AIR-only click Событие
Тип объекта события: flash.events.MouseEvent
свойство MouseEvent.type = flash.events.MouseEvent.CLICK

Версии среды выполнения:  1.0

Отправляется данным объектом SystemTrayIcon по щелчку левой кнопкой мыши.

Задает значение свойства type для объекта события click.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; нет поведения по умолчанию для отмены.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.
AIR-only mouseDown Событие  
Тип объекта события: flash.events.MouseEvent
свойство MouseEvent.type = flash.events.MouseEvent.MOUSE_DOWN

Версии среды выполнения:  1.0

Отправляется данным объектом SystemTrayIcon при нажатии левой кнопки мыши.

Задает значение свойства type для объекта события mouseDown.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; поведение по умолчанию отменить нельзя.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.
AIR-only mouseUp Событие  
Тип объекта события: flash.events.MouseEvent
свойство MouseEvent.type = flash.events.MouseEvent.MOUSE_UP

Версии среды выполнения:  1.0

Отправляется данным объектом SystemTrayIcon при отпускании левой кнопки мыши.

Задает значение свойства type объекта события mouseUp.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; поведение по умолчанию отменить нельзя.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.
AIR-only rightClick Событие  
Тип объекта события: flash.events.MouseEvent
свойство MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_CLICK

Версии среды выполнения:  1.0

Отправляется данным объектом SystemTrayIcon по щелчку правой кнопкой мыши.

AIR-only rightMouseDown Событие  
Тип объекта события: flash.events.MouseEvent
свойство MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_DOWN

Версии среды выполнения:  1.0

Отправляется данным объектом SystemTrayIcon при нажатии правой кнопки мыши.

AIR-only rightMouseUp Событие  
Тип объекта события: flash.events.MouseEvent
свойство MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_UP

Версии среды выполнения:  1.0

Отправляется данным объектом SystemTrayIcon при отпускании правой кнопки мыши.

Сведения о константе
AIR-only MAX_TIP_LENGTHКонстанта
public static const MAX_TIP_LENGTH:Number = 63

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Допустимая длина строки-подсказки значка на панели задач.