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

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

Класс DockIcon отвечает за отображение значка панели в стиле MacOS X®.

Класс DockIcon можно использовать для изменения внешнего вида стандартных значков, например, для анимации значка или добавления информационных изображений. Вы также можете добавлять элементы в меню значка панели. Все добавленные элементы отображаются над стандартными элементами меню.

Создать экземпляр класса DockIcon нельзя. Объект, отвечающий за значок панели операционной системы, находится в NativeApplication.icon.

Поддержка значков панелей присутствуют не во всех операционных системах. Выполните проверку NativeApplication.supportsDockIcon, чтобы узнать, поддерживает ли текущая ОС значки панелей. Есть такая поддержка существует, то свойство NativeApplication.icon является типом класса DockIcon. В противном случае, тип NativeApplication.icon является другим подклассом класса InteractiveIcon (обычно SystemTrayIcon).

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

См. также

flash.desktop.NativeApplication.icon
flash.desktop.NativeApplication.supportsDockIcon
flash.desktop.SystemTrayIcon


Общедоступные свойства
 СвойствоОпределено
  AIR-only bitmaps : Array
Изображение значка в массиве объектов BitmapData различных размеров.
DockIcon
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  AIR-only height : int
[только для чтения] Текущее значение высоты значка в пикселах.
DockIcon
  AIR-only menu : NativeMenu
Системное меню данного значка панели.
DockIcon
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  AIR-only width : int
[только для чтения] Текущее значение ширины значка в пикселах.
DockIcon
Общедоступные методы
 МетодОпределено
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
  
AIR-only bounce(priority:String = "informational"):void
Уведомляет пользователя о событии, требующем его внимания.
DockIcon
 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
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
Сведения о свойстве
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 widthсвойство 
width:int  [только для чтения]

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

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

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



Реализация
    public function get width():int
Сведения о методе
AIR-only bounce()метод
public function bounce(priority:String = "informational"):void

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

Уведомляет пользователя о событии, требующем его внимания.

Вызов этого метода приводит к колебанию значка панели только тогда, когда приложение работает в фоновом режиме. Если значением priority является NotificationType.Informational, то значок колеблется только один раз. Если значением priority является NotificationType.Critical, то значок колеблется до тех пор, пока приложение не станет активным.

Параметры

priority:String (default = "informational") — Срочность колебания панели.

См. также