SystemTrayIcon - Adobe ActionScript® 3 (AS3 )

Пакет	flash.desktop
Класс	public class SystemTrayIcon
Наследование	SystemTrayIcon InteractiveIcon Icon EventDispatcher Object

Язык версии:

ActionScript 3.0

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

AIR 1.0

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

Поддержка в профилях AIR: эта функция поддерживается в компьютерных операционных системах, но не поддерживается на мобильных устройствах или на устройствах AIR for TV. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».

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

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

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

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

Связанные элементы API

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

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		bitmaps : Array [переопределить] Изображение значка в массиве объектов BitmapData различных размеров.	SystemTrayIcon
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		height : int [переопределить] [только для чтения] Текущее значение высоты значка в пикселях.	SystemTrayIcon
		menu : NativeMenu Меню значка на панели задач.	SystemTrayIcon
		tooltip : String Всплывающая подсказка, которая появляется при выполнении определенного действия над значком на панели задач.	SystemTrayIcon
		width : int [переопределить] [только для чтения] Текущее значение ширины значка в пикселях.	SystemTrayIcon

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
click	Отправляется данным объектом SystemTrayIcon по щелчку левой кнопкой мыши.	SystemTrayIcon
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
mouseDown	Отправляется данным объектом SystemTrayIcon при нажатии левой кнопки мыши.	SystemTrayIcon
mouseUp	Отправляется данным объектом SystemTrayIcon при отпускании левой кнопки мыши.	SystemTrayIcon
rightClick	Отправляется данным объектом SystemTrayIcon по щелчку правой кнопкой мыши.	SystemTrayIcon
rightMouseDown	Отправляется данным объектом SystemTrayIcon при нажатии правой кнопки мыши.	SystemTrayIcon
rightMouseUp	Отправляется данным объектом SystemTrayIcon при отпускании правой кнопки мыши.	SystemTrayIcon

Общедоступные константы

	Константа		Определено
		MAX_TIP_LENGTH : Number = 63 [статические] Допустимая длина всплывающей подсказки значка на панели задач.	SystemTrayIcon

Сведения о свойстве

bitmaps

свойство

bitmaps:Array[переопределить]

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

AIR 1.0

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

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

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

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

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

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

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

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

Реализация
override public function get bitmaps():Array
override public function set bitmaps(value:Array):void

height

свойство

height:int [только для чтения] [переопределить]

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

AIR 1.0

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

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

Реализация
override public function get height():int

tooltip

свойство

tooltip:String

Язык версии:

ActionScript 3.0

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

AIR 1.0

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

Реализация
public function get tooltip():String
public function set tooltip(value:String):void

width

свойство

width:int [только для чтения] [переопределить]

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

AIR 1.0

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

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

Реализация
override public function get width():int

Сведения о событии

click

Событие

Тип объекта события: flash.events.ScreenMouseEvent
свойство ScreenMouseEvent.type = flash.events.ScreenMouseEvent.CLICK

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

AIR 1.0

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

Константа ScreenMouseEvent.CLICK определяет значение свойства type объекта события click.

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

Свойство	Значение
`buttonDown`	`true`, если нажата основная кнопка мыши; иначе — `false`.
`ctrlKey`	`true` в Windows или Linux, если клавиша Ctrl активна. `true` в Mac, если клавиша Ctrl или Command активна. В противном случае `false`.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`shiftKey`	`true`, если клавиша Shift активна; иначе — `false`.
`commandKey`	`true` в Mac, если клавиша Command активна; `false`, если неактивна. Всегда `false` в Windows.
`controlKey`	`true`, если клавиша Ctrl или Control активна; `false`, если неактивна.
`screenX`	Горизонтальная координата события в координатах экрана.
`screenY`	Вертикальная координата события в координатах экрана.
`target`	Объект SystemTrayIcon, находящийся под указывающим устройством.

mouseDown

Событие

Тип объекта события: flash.events.ScreenMouseEvent
свойство ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_DOWN

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

AIR 1.0

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

Константа ScreenMouseEvent.MOUSE_DOWN определяет значение свойства type объекта события mouseDown.

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

Свойство	Значение
`buttonDown`	`true`, если нажата основная кнопка мыши; иначе — `false`.
`ctrlKey`	`true` в Windows или Linux, если клавиша Ctrl активна. `true` в Mac, если клавиша Ctrl или Command активна. В противном случае `false`.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`shiftKey`	`true`, если клавиша Shift активна; иначе — `false`.
`commandKey`	`true` в Mac, если клавиша Command активна; `false`, если неактивна. Всегда `false` в Windows.
`controlKey`	`true`, если клавиша Ctrl или Control активна; `false`, если неактивна.
`screenX`	Горизонтальная координата события в координатах экрана.
`screenY`	Вертикальная координата события в координатах экрана.
`target`	Объект SystemTrayIcon, находящийся под указывающим устройством.

mouseUp

Событие

Тип объекта события: flash.events.ScreenMouseEvent
свойство ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_UP

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

AIR 1.0

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

Константа ScreenMouseEvent.MOUSE_UP определяет значение свойства type объекта события mouseUp.

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

Свойство	Значение
`buttonDown`	`true`, если нажата основная кнопка мыши; иначе — `false`.
`ctrlKey`	`true` в Windows или Linux, если клавиша Ctrl активна. `true` в Mac, если клавиша Ctrl или Command активна. В противном случае `false`.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`shiftKey`	`true`, если клавиша Shift активна; иначе — `false`.
`commandKey`	`true` в Mac, если клавиша Command активна; `false`, если неактивна. Всегда `false` в Windows.
`controlKey`	`true`, если клавиша Ctrl или Control активна; `false`, если неактивна.
`screenX`	Горизонтальная координата события в координатах экрана.
`screenY`	Вертикальная координата события в координатах экрана.
`target`	Объект SystemTrayIcon, находящийся под указывающим устройством.

rightClick

Событие

Тип объекта события: flash.events.ScreenMouseEvent
свойство ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_CLICK

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

AIR 1.0

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

Константа ScreenMouseEvent.RIGHT_CLICK определяет значение свойства type объекта события rightClick.

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

Свойство	Значение
`buttonDown`	`true`, если нажата основная кнопка мыши; иначе — `false`.
`ctrlKey`	`true` в Windows или Linux, если клавиша Ctrl активна. `true` в Mac, если клавиша Ctrl или Command активна. В противном случае `false`.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`shiftKey`	`true`, если клавиша Shift активна; иначе — `false`.
`commandKey`	`true` в Mac, если клавиша Command активна; `false`, если неактивна. Всегда `false` в Windows.
`controlKey`	`true`, если клавиша Ctrl или Control активна; `false`, если неактивна.
`screenX`	Горизонтальная координата события в координатах экрана.
`screenY`	Вертикальная координата события в координатах экрана.
`target`	Объект SystemTrayIcon, находящийся под указывающим устройством.

rightMouseDown

Событие

Тип объекта события: flash.events.ScreenMouseEvent
свойство ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN

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

AIR 1.0

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

Константа ScreenMouseEvent.RIGHT_MOUSE_DOWN определяет значение свойства type объекта события rightMouseDown.

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

Свойство	Значение
`buttonDown`	`true`, если нажата основная кнопка мыши; иначе — `false`.
`ctrlKey`	`true` в Windows или Linux, если клавиша Ctrl активна. `true` в Mac, если клавиша Ctrl или Command активна. В противном случае `false`.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`shiftKey`	`true`, если клавиша Shift активна; иначе — `false`.
`commandKey`	`true` в Mac, если клавиша Command активна; `false`, если неактивна. Всегда `false` в Windows.
`controlKey`	`true`, если клавиша Ctrl или Control активна; `false`, если неактивна.
`screenX`	Горизонтальная координата события в координатах экрана.
`screenY`	Вертикальная координата события в координатах экрана.
`target`	Объект SystemTrayIcon, находящийся под указывающим устройством.

rightMouseUp

Событие

Тип объекта события: flash.events.ScreenMouseEvent
свойство ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP

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

AIR 1.0

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

Константа ScreenMouseEvent.RIGHT_MOUSE_UP определяет значение свойства type объекта события rightMouseUp.

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

Свойство	Значение
`buttonDown`	`true`, если нажата основная кнопка мыши; иначе — `false`.
`ctrlKey`	`true` в Windows или Linux, если клавиша Ctrl активна. `true` в Mac, если клавиша Ctrl или Command активна. В противном случае `false`.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`shiftKey`	`true`, если клавиша Shift активна; иначе — `false`.
`commandKey`	`true` в Mac, если клавиша Command активна; `false`, если неактивна. Всегда `false` в Windows.
`controlKey`	`true`, если клавиша Ctrl или Control активна; `false`, если неактивна.
`screenX`	Горизонтальная координата события в координатах экрана.
`screenY`	Вертикальная координата события в координатах экрана.
`target`	Объект SystemTrayIcon, находящийся под указывающим устройством.

Сведения о константе

MAX_TIP_LENGTH

Константа

public static const MAX_TIP_LENGTH:Number = 63

Язык версии:

ActionScript 3.0

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

AIR 1.0

Допустимая длина всплывающей подсказки значка на панели задач.

Юридическая информация | Политика конфиденциальности онлайн

SystemTrayIcon - AS3

Классы x

bitmaps

height

menu

tooltip

width

click

mouseDown

mouseUp

rightClick

rightMouseDown

rightMouseUp

MAX_TIP_LENGTH