| Пакет | flash.desktop |
| Класс | public class DockIcon |
| Наследование | DockIcon  InteractiveIcon Icon EventDispatcher Object |
| Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Класс DockIcon можно использовать для изменения внешнего вида стандартных значков, например, для анимации значка или добавления информационных изображений. Вы также можете добавлять элементы в меню значка панели. Все добавленные элементы отображаются над стандартными элементами меню.
Создать экземпляр класса DockIcon нельзя. Объект, отвечающий за значок панели операционной системы, находится в NativeApplication.icon.
Поддержка значков панелей присутствуют не во всех операционных системах. Выполните проверку NativeApplication.supportsDockIcon, чтобы узнать, поддерживает ли текущая ОС значки панелей. Есть такая поддержка существует, то свойство NativeApplication.icon является типом класса DockIcon. В противном случае, тип NativeApplication.icon является другим подклассом класса InteractiveIcon (обычно SystemTrayIcon).
Важно: попытка применить метод класса DockIcon к объекту NativeApplication.icon в ОС, где AIR не обеспечивает поддержку работы со значками панелей, приводит к ошибке.
См. также
| Свойство | Определено | ||
|---|---|---|---|
 bitmaps : Array
Изображение значка в массиве объектов BitmapData различных размеров. | DockIcon | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| height : int [только для чтения]
Текущее значение высоты значка в пикселах. | DockIcon | ||
| menu : NativeMenu
Системное меню данного значка панели. | DockIcon | ||
| prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
| width : int [только для чтения]
Текущее значение ширины значка в пикселах. | DockIcon | ||
| Метод | Определено | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях. | EventDispatcher | |
Уведомляет пользователя о событии, требующим его внимания. | DockIcon | ||
|
Передает событие в поток событий. | EventDispatcher | |
|
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа. | EventDispatcher | |
| 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 не поддерживает прозрачность совсем.
public function get bitmaps():Array public function set bitmaps(value:Array):void| height | свойство |
height:int [только для чтения] | Версии среды выполнения: | AIR 1.0 |
Текущее значение высоты значка в пикселах.
Некоторые контексты значков поддерживают динамические размеры. Свойство height обозначает высоту значка, выбранного из массива bitmaps для данного контекста. Если в ОС было использовано масштабирование, то текущее значение высоты может отличаться.
public function get height():int| menu | свойство |
menu:NativeMenu [чтение и запись] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Системное меню данного значка панели.
Все элементы меню отображаются над стандартными. Стандартные элементы нельзя изменить или удалить.
public function get menu():NativeMenu public function set menu(value:NativeMenu):void| width | свойство |
width:int [только для чтения] | Версии среды выполнения: | AIR 1.0 |
Текущее значение ширины значка в пикселах.
Некоторые контексты значков поддерживают динамические размеры. Свойство width обозначает ширину значка, выбранного из массива bitmaps для данного контекста. Если в ОС было использовано масштабирование, то текущее значение ширины может отличаться.
public function get width():int| bounce | () | метод |
public function bounce(priority:String = "informational"):void| Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Уведомляет пользователя о событии, требующим его внимания.
Вызов этого метода приводит к колебанию значка панели только тогда, когда приложение работает в фоновом режиме. Если значением priority является NotificationType.Informational, то значок колеблется только один раз. Если значением priority является NotificationType.Critical, то значок колеблется до тех пор, пока приложение не станет активным.
Параметры
priority:String (default = "informational") |
См. также