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

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

Класс NativeWindow обеспечивает интерфейс для создания собственных окон рабочего стола и управления ими.

Ссылка на экземпляр NativeWindow возвращается конструктором окон. Ссылка на экземпляр NativeWindow также доступна через свойство stage.nativeWindow любого экранного объекта в рабочей области окна:

var window:NativeWindow = displayObject.stage.nativeWindow;

Ссылка на экземпляр NativeWindow возвращается конструктором окон. Код JavaScript на странице HTML может ссылаться на экземпляр NativeWindow с использованием свойства window.nativeWindow.

Свойства экземпляра NativeWindow может получать только содержимое приложения. Если содержимое не из приложения попытается обратиться к объекту NativeWindow, будет отправлена ошибка системы безопасности.

Содержимое можно добавить в окно с помощью методов DisplayObjectContainer объекта Stage, таких как addChild().

Невозможно добавить компоненты Flex непосредственно в список отображения экземпляра NativeWindow. Вместо этого используйте компоненты Flex mx:WindowedApplication и mx:Window для создания окон и добавления других компонентов Flex в качестве дочерних объектов. Можно добавить SWF-содержимое на основе Flex непосредственно в окно NativeWindow, если SWF-файл загружен в собственный домен приложений и является содержимым приложения.

Чтобы создать корневое HTML-окно для отображения HTML-содержимого обычно достаточно создать окно с помощью метода HTMLLoader.createRootContent(). В окна, созданные таким способом, автоматически добавляется объект HTMLLoader. (Из кода JavaScript также можно использовать функцию window.open(). Однако этот метод дает меньше возможностей управления внешним видом и поведением окон.)

Далее перечислены асинхронные операции над объектами NativeWindow: close(), maximize(), minimize(), restore() и изменение границ. Приложение может выявить выполнение этих операций, прослушивая соответствующие события.

Если свойство NativeApplication.autoExit имеет значение true, используемое по умолчанию, приложение закроется при закрытии последнего окна (и возврате всех обработчиков события close). Если autoExit имеет значение false, тогда для завершения работы приложения необходимо вызвать метод NativeApplication.nativeApplication.exit().

Объекты NativeWindow не очищаются после вызова конструктора окон и перед вызовом close(). Приложение должно самостоятельно закрывать свои окна.

См. также

flash.display.Stage.nativeWindow
flash.display.NativeWindowInitOptions
flash.desktop.NativeApplication
flash.system.ApplicationDomain
flash.html.HTMLLoader.createRootWindow()


Общедоступные свойства
 СвойствоОпределено
  AIR-only active : Boolean
[только для чтения] Указывает, принадлежит ли окно активному приложению.
NativeWindow
  AIR-only alwaysInFront : Boolean
Задает, будет ли это окно всегда отображаться поверх всех остальных окон (включая окна других приложений).
NativeWindow
  AIR-only bounds : Rectangle
Размер и местоположение окна.
NativeWindow
  AIR-only closed : Boolean
[только для чтения] Указывает, закрыто ли окно.
NativeWindow
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  AIR-only displayState : String
[только для чтения] Состояние отображения окна.
NativeWindow
  AIR-only height : Number
Высота окна в пикселах.
NativeWindow
  AIR-only maximizable : Boolean
[только для чтения] Сообщает параметр разворачивания, использованный для создания данного окна.
NativeWindow
  AIR-only maxSize : Point
Максимальный размер окна.
NativeWindow
  AIR-only menu : NativeMenu
Собственное меню для данного окна.
NativeWindow
  AIR-only minimizable : Boolean
[только для чтения] Сообщает параметр сворачивания, использованный для создания данного окна.
NativeWindow
  AIR-only minSize : Point
Минимальный размер окна.
NativeWindow
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  AIR-only resizable : Boolean
[только для чтения] Сообщает параметр изменения размера, использованный для создания данного окна.
NativeWindow
  AIR-only stage : Stage
[только для чтения] Объект Stage для данного окна.
NativeWindow
  AIR-only supportsMenu : Boolean
[статические] [только для чтения] Указывает, поддерживает ли AIR меню собственного окна в текущей операционной системе.
NativeWindow
  AIR-only supportsNotification : Boolean
[статические] [только для чтения] Указывает, поддерживает ли AIR сигналы оповещения окна в текущей операционной системе.
NativeWindow
  AIR-only supportsTransparency : Boolean
[статические] [только для чтения] Указывает, поддерживает ли AIR собственные окна с прозрачными пикселами.
NativeWindow
  AIR-only systemChrome : String
[только для чтения] Сообщает параметр системного хрома, использованный для создания данного окна.
NativeWindow
  AIR-only systemMaxSize : Point
[статические] [только для чтения] Наибольший размер окна, разрешенный операционной системой.
NativeWindow
  AIR-only systemMinSize : Point
[статические] [только для чтения] Наименьший размер окна, разрешенный операционной системой.
NativeWindow
  AIR-only title : String
Заголовок окна.
NativeWindow
  AIR-only transparent : Boolean
[только для чтения] Сообщает параметр прозрачности, использованный для создания данного окна.
NativeWindow
  AIR-only type : String
[только для чтения] Сообщает параметр типа окна, использованный для создания данного окна.
NativeWindow
  AIR-only visible : Boolean
Указывает, видимо ли окно.
NativeWindow
  AIR-only width : Number
Ширина окна в пикселах.
NativeWindow
  AIR-only x : Number
Координата горизонтальной оси верхнего левого угла этого окна относительно исходной точки рабочего стола операционной системы.
NativeWindow
  AIR-only y : Number
Координата вертикальной оси верхнего левого угла этого окна относительно верхнего левого угла рабочего стола операционной системы.
NativeWindow
Общедоступные методы
 МетодОпределено
  
Создает новый экземпляр NativeWindow и соответствующее окно операционной системы.
NativeWindow
  
Активирует данное окно.
NativeWindow
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
  
Закрывает окно.
NativeWindow
 Inherited
Передает событие в поток событий.
EventDispatcher
  
AIR-only globalToScreen(globalPoint:Point):Point
Преобразует точку в координатах пикселов относительно исходной точки в рабочей области окна (глобальной точки списка отображения) в точку на виртуальном рабочем столе.
NativeWindow
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
Разворачивает данное окно.
NativeWindow
  
Сворачивает данное окно.
NativeWindow
  
Запускает через операционную систему визуальный сигнал о том, что произошло событие, представляющее интерес.
NativeWindow
  
Отправляет это окно непосредственно под заданное окно.
NativeWindow
  
Помещает данное окно непосредственно над заданным окном.
NativeWindow
  
Отправляет это окно под все остальные видимые окна.
NativeWindow
  
Выводит это окно поверх всех остальных видимых окон.
NativeWindow
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
Восстанавливает окно из свернутого или развернутого состояния.
NativeWindow
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
Запускает перемещение данного окна системой.
NativeWindow
  
AIR-only startResize(edgeOrCorner:String):Boolean
Запускает изменение размеров данного окна под управлением системы.
NativeWindow
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
События
 Событие Сводка Определено
  Отправляется данным объектом NativeWindow после активации окна.NativeWindow
  Отправляется данным объектом NativeWindow после закрытия окна.NativeWindow
  Отправляется этим объектом NativeMenu object непосредственно перед закрытием окна.NativeWindow
  Отправляется данным объектом NativeWindow после деактивации окна.NativeWindow
  Отправляется данным объектом NativeWindow после изменения свойства displayState окна.NativeWindow
  Отправляется данным объектом NativeWindow непосредственно перед изменением состояния отображения окна.NativeWindow
  Отправляется данным объектом NativeWindow после перемещения окна на рабочем столе.NativeWindow
  Отправляется этим объектом NativeMenu object непосредственно перед перемещением окна на рабочем столе.NativeWindow
  Отправляется данным объектом NativeWindow после изменения размеров окна.NativeWindow
  Отправляется этим объектом NativeMenu object непосредственно перед изменением размеров окна на рабочем столе.NativeWindow
Сведения о свойстве
AIR-only activeсвойство
active:Boolean  [только для чтения]

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

Указывает, принадлежит ли окно активному приложению.

Используйте метод activate() для активации окна.



Реализация
    public function get active():Boolean

См. также

AIR-only alwaysInFrontсвойство 
alwaysInFront:Boolean  [чтение и запись]

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

Задает, будет ли это окно всегда отображаться поверх всех остальных окон (включая окна других приложений).

В системном порядке глубины есть две группы окон. Окна группы alwaysInFront всегда отображаются поверх всех остальных окон. Порядок глубины окон одной группы определяется в обычном порядке. Другими словами, активация окна будет выводить его поверх остальных окон в той же группе.

Изменение значения alwaysInFront с false на true выведет окно поверх всех остальных окон. При изменении значения с true на false отправит окно под окна, всегда отображаемые поверх остальных, но над окнами другой группы. При настройке текущего значения свойства, порядок глубины окон не изменится.

Свойству alwaysInFront следует задавать значение true лишь в редких случаях, так как окна с таким параметром будут отображаться над окнами других приложений, даже если такое приложение активно.

Примечание. В ОС Mac® OS X задание для alwaysInFront значения true не будет иметь силы, если свойству displayState рабочей области окна задано значение fullScreen или fullScreenInteractive.



Реализация
    public function get alwaysInFront():Boolean
    public function set alwaysInFront(value:Boolean):void
AIR-only boundsсвойство 
bounds:Rectangle  [чтение и запись]

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

Размер и местоположение окна.

Размеры окна включают системный хром. Размеры рабочей области окна равны размерам окна минус размер системного хрома. Изменение ширины и высоты окна приведет к изменению свойств stageWidth и stageHeight рабочей области. И наоборот, изменение размеров рабочей области приведет к изменению размеров окна.

В корневом HTML-окне свойства outerWidth и outerHeigth эквиваленты свойствам height и width окна. Свойства innerWidth и innerHeight равны свойствам stage.stageWidth и stage.stageHeight минус толщина автоматических полос прокрутки, отображаемых в окне.

Событие resize отправляется при каждом изменении ширины или высоты окна. Подобным образом, событие move отправляется при каждом изменении исходной точки (х, у) окна. Непосредственное задание свойства bounds не приведет к отправке события moving или resizing. Чтобы разрешить другим компонентам готовить или отменять будущую операцию перемещения или изменения размеров, логика изменения границ может отправлять события moving и resizing вместе с методом dispatchEvent() объекта NativeWindow, а затем проверить, отменено ли событие зарегистрированным прослушивателем.

Задание свойства bounds окна эквиваленто заданию его свойств x, y, width и height. Подобным образом, задание индивидуальных размеров равносильно заданию свойства bounds. При настройке всех размеров одновременно с использованием свойства bounds отправляется меньше событий.

Если заданные ширина и высота меньше минимального или больше максимального допустимого размера, определенными свойствами minSize и maxSize окна или минимальными и максимальными ограничениями операционной системы, то размеры окна изменятся до ближайшего допустимого размера. Минимальная ширина и высота отображаемого системного хрома также может привести к превышению заданного размера окна.



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

Выдает
ArgumentError — Если прямоугольник имеет значение null или содержит недопустимые значения.
 
IllegalOperationError — Если свойство bounds получено после закрытия окна.

См. также

AIR-only closedсвойство 
closed:Boolean  [только для чтения]

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

Указывает, закрыто ли окно.

Попытка получить следующие свойства закрытого окна приведет к появлению ошибки о недопустимой операции:

Подобным образом, попытка вызвать следующие методы для закрытого окна приведет к появлению ошибки о недопустимой операции:



Реализация
    public function get closed():Boolean
AIR-only displayStateсвойство 
displayState:String  [только для чтения]

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

Состояние отображения окна.

Константы для возможных значений определяются классом NativeWindowDisplayState:



Реализация
    public function get displayState():String

Выдает
IllegalOperationError — Если свойство displayState получено после закрытия окна.

См. также

AIR-only heightсвойство 
height:Number  [чтение и запись]

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

Высота окна в пикселах.

Размеры окна включают примененный к нему системный хром. Высота доступной для использования области экрана внутри окна указывается в свойстве Stage.stageHeight.

Изменение свойства окна height равносильно изменению высоты через свойство bounds.

Если заданная высота меньше минимального или больше максимального допустимого размера, определенными свойствами minSize и maxSize окна или минимальными и максимальными ограничениями операционной системы, то высота окна изменится до ближайшего допустимого размера.



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

Выдает
ArgumentError — Если задано недопустимое значение или null.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

AIR-only maximizableсвойство 
maximizable:Boolean  [только для чтения]

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

Сообщает параметр разворачивания, использованный для создания данного окна.

Параметр maximizable нельзя изменить после создания окна.



Реализация
    public function get maximizable():Boolean

Выдает
SecurityError — При попытке задать значение false без необходимых полномочий.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

AIR-only maxSizeсвойство 
maxSize:Point  [чтение и запись]

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

Максимальный размер окна.

Предельный размер определяется как координаты объекта Point. Свойство точки х соответствует ширине окна, а свойство у — высоте окна.

Ограничение maxSize применяется для операций изменения размера окна, вызываемых как посредством кода ActionScript JavaScript, так и посредством операционной системы.

При задании maxSize границы окна изменятся, если текущие границы больше нового максимального размера.

Примечание. При развертывании окно увеличится только до значения maxSize, даже если развернутое окно будет меньше экрана операционной системы. Несмотря на это окно будет находиться в состоянии развернутого отображения.



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

Выдает
IllegalOperationError — Если назначенный размер находится за рамками минимального и максимального размеров окна.
 
SecurityError — Если размер запрещен для текущих полномочий содержимого.
 
ArgumentError — Если размер имеет значение null или содержит недопустимые значения.
 
IllegalOperationError — Если свойство maxSize получено после закрытия окна.

См. также

AIR-only menuсвойство 
menu:NativeMenu  [чтение и запись]

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

Собственное меню для данного окна.

Когда объект NativeMenu назначается свойству окна menu, для этого окна будет отображаться собственное меню, если NativeWindow.supportsMenu имеет значение true и если свойство systemChrome не имеет значение NativeWindowSystemChrome.NONE.

Примечание. Назначить меню для окна, когда NativeWindow.supportsMenu имеет значение false или когда свойство окна systemChrome имеет значение NativeWindowSystemChrome.NONE можно, но эта настройка не будет иметь силы.



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

См. также

AIR-only minimizableсвойство 
minimizable:Boolean  [только для чтения]

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

Сообщает параметр сворачивания, использованный для создания данного окна.

Параметр minimizable нельзя изменить после создания окна.



Реализация
    public function get minimizable():Boolean

Выдает
SecurityError — При попытке задать значение false без необходимых полномочий.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

AIR-only minSizeсвойство 
minSize:Point  [чтение и запись]

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

Минимальный размер окна.

Предельный размер определяется как координаты объекта Point. Свойство точки х соответствует ширине окна, а свойство у — высоте окна.

При задании minSize границы окна изменятся, если текущие границы меньше нового минимального размера.

Ограничение minSize применяется для операций изменения размера окна, вызываемых как посредством кода ActionScript JavaScript, так и посредством операционной системы.

Примечание. Ширина и высота любого отображаемого системного хрома может препятствовать уменьшению окна до заданного минимального размера.



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

Выдает
IllegalOperationError — Если назначенный размер находится за рамками минимального и максимального размеров окна.
 
SecurityError — Если размер запрещен для текущих полномочий содержимого.
 
ArgumentError — Если размер имеет значение null или содержит недопустимые значения.
 
IllegalOperationError — Если свойство minSize получено после закрытия окна.

См. также

AIR-only resizableсвойство 
resizable:Boolean  [только для чтения]

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

Сообщает параметр resizable для изменения размера, использованный для создания данного окна.

Параметр resizable нельзя изменить после создания окна.



Реализация
    public function get resizable():Boolean

Выдает
SecurityError — При попытке задать значение false без необходимых полномочий.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

AIR-only stageсвойство 
stage:Stage  [только для чтения]

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

Объект Stage для данного окна. Объект Stage является корневым объектом в архитектуре экранных объектов, используемой в SWF-содержимом на базе ActionScript 3.0.

Рабочая область находится в корне списка отображения для данного окна. Добавьте визуальные экранные объекты в окно путем добавления в рабочую область или в другой объект, уже находящийся в списке отображения данного рабочей области. Размеры рабочей области соответствуют размеру области клиента окна, когда оно использует системный хром. Если же системный хром не используется, размеры рабочей области равны размерам окна.

Класс HTMLLoader, который позволяет отобразить содержимое HTML, является единственным листом в дереве списка отображения. Экранные объекты ActionScript могут находится выше или ниже HTMLLoader в порядке рисования, но не между визуальными элементами, отображаемыми классом HTMLLoader.



Реализация
    public function get stage():Stage

См. также

AIR-only supportsMenuсвойство 
supportsMenu:Boolean  [только для чтения]

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

Указывает, поддерживает ли AIR меню собственного окна в текущей операционной системе.

Когда NativeWindow.supportsMenu имеет значение true, для окна будет отображаться собственное меню, когда свойству окна menu назначается объект NativeMenu (если свойство окна systemChrome имеет значение NativeWindowSystemChrome.NONE).

Примечание. Назначить меню для окна, когда NativeWindow.supportsMenu имеет значение false или когда свойство окна systemChrome имеет значение NativeWindowSystemChrome.NONE можно, но эта настройка не будет иметь силы.



Реализация
    public static function get supportsMenu():Boolean

См. также

AIR-only supportsNotificationсвойство 
supportsNotification:Boolean  [только для чтения]

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

Указывает, поддерживает ли AIR сигналы оповещения окна в текущей операционной системе.

Когда NativeWindow.supportsNotification имеет значение true, вызов метода окна notify() приведет к отображению визуального сигнала о том, что произошло интересующее пользователя событие. Визуальный сигнал будет соответствовать правилам установленной операционной системы. Например, в Windows® мигает значок на панели задач.

Примечание. Вызов метода notify(), когда NativeWindow.supportsNotification имеет значение false разрешен, но не выполняет никаких действий.



Реализация
    public static function get supportsNotification():Boolean

См. также

AIR-only supportsTransparencyсвойство 
supportsTransparency:Boolean  [только для чтения]

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

Указывает, поддерживает ли AIR собственные окна с прозрачными пикселами.

Если NativeWindow.supportsTransparency имеет значение true, прозрачность пикселов собственного окна будет поддерживаться при условии, что свойство окна transparent имеет значение true. Непрозрачность всех пикселов будет установлена на значение 1, если NativeWindow.supportsTransparency имеет значение false, независимо от значения свойства окна transparent. Полностью прозрачные пикселы будут отображаться черным, если NativeWindow.supportsTransparency имеет значение false.

Примечание. Значение данного свойства может измениться во время работы приложения в зависимости от предпочтений пользователя.



Реализация
    public static function get supportsTransparency():Boolean

См. также

AIR-only systemChromeсвойство 
systemChrome:String  [только для чтения]

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

Сообщает параметр системного хрома, использованный для создания данного окна.

Значения, возвращенные NativeWindow.systemChrome, будут входить в число констант, определенных в классе NativeWindowSystemChrome.

Параметр системного хрома нельзя изменить после создания окна.



Реализация
    public function get systemChrome():String

Выдает
SecurityError — При попытке задать значение false без необходимых полномочий.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

AIR-only systemMaxSizeсвойство 
systemMaxSize:Point  [только для чтения]

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

Наибольший размер окна, разрешенный операционной системой.

Предельный размер определяется как координаты объекта Point. Свойство точки х соответствует ширине окна, а свойство у — высоте окна.

con



Реализация
    public static function get systemMaxSize():Point
AIR-only systemMinSizeсвойство 
systemMinSize:Point  [только для чтения]

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

Наименьший размер окна, разрешенный операционной системой.

Предельный размер определяется как координаты объекта Point. Свойство точки х соответствует ширине окна, а свойство у — высоте окна.

con



Реализация
    public static function get systemMinSize():Point
AIR-only titleсвойство 
title:String  [чтение и запись]

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

Заголовок окна.

Если заголовок отображается, он появится в системном хроме для окна, а также в других системных местоположениях (например, на панели задач).



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

Выдает
IllegalOperationError — Если свойство получено после закрытия окна.
AIR-only transparentсвойство 
transparent:Boolean  [только для чтения]

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

Сообщает параметр прозрачности, использованный для создания данного окна.

Свойство transparent нельзя изменить после создания окна. Прозрачность влияет на внешний вид окна и на поведение мыши в его границах. Если значение альфа-канала пиксела опускается ниже определенного порога, который варьируется от 0,06 до 0,01 в зависимости от операционной системы, окно не будет реагировать на мышь в данном пикселе.



Реализация
    public function get transparent():Boolean

Выдает
SecurityError — При попытке задать значение false без необходимых полномочий.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

AIR-only typeсвойство 
type:String  [только для чтения]

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

Сообщает параметр типа окна, использованный для создания данного окна.

Значения, возвращенные NativeWindow.type, будут входить в число констант, определенных в классе NativeWindowType.

Параметр type нельзя изменить после создания окна.



Реализация
    public function get type():String

Выдает
SecurityError — При попытке задать значение false без необходимых полномочий.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

AIR-only visibleсвойство 
visible:Boolean  [чтение и запись]

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

Указывает, видимо ли окно.

Невидимое окно не отображается на рабочем столе, но все его свойства и методы остаются действительными.

По умолчанию visible имеет значение false. Чтобы отобразить окно, нужно задать visible значение true или вызвать методNativeWindow.activate().

Примечание. В Mac OS X параметр visible=false для свернутого окна не приведет к удалению значка окна с панели рабочего стола. Если потом пользователь щелкнет значок на панели, окно снова станет видимым и отобразится на рабочем столе.



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

Выдает
SecurityError — При попытке задать значение false без необходимых полномочий.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

AIR-only widthсвойство 
width:Number  [чтение и запись]

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

Ширина окна в пикселах.

Отображаемые размеры собственного окна включают примененный к нему системный хром. Ширина доступной для использования области экрана внутри окна указывается в свойстве Stage.stageWidth.

Изменение свойства окна width равносильно изменению ширины через свойство bounds.

Если заданная ширина меньше минимального или больше максимального допустимого размера, определенными свойствами minSize и maxSize окна или минимальными и максимальными ограничениями операционной системы, то ширина окна изменится до ближайшего допустимого размера.



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

Выдает
ArgumentError — Если задано недопустимое значение или null.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

AIR-only xсвойство 
x:Number  [чтение и запись]

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

Координата горизонтальной оси верхнего левого угла этого окна относительно исходной точки рабочего стола операционной системы.

На системах с несколькими мониторами х может иметь отрицательное значение. Если вы сохраняете значение, допустим для возвращения окна в предыдущее местоположение, необходимо всегда следить, чтобы во время восстановления окно находилось в пригодном для использования местоположении. Изменение разрешения экрана или организации мониторов может привести к тому, что окно попадет за пределы области экрана. Используйте класс Screen для получения информации о геометрии рабочего стола.

Изменение свойства окна х равносильно изменению местоположения через свойство bounds.



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

Выдает
ArgumentError — Если задано недопустимое значение или null.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

AIR-only yсвойство 
y:Number  [чтение и запись]

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

Координата вертикальной оси верхнего левого угла этого окна относительно верхнего левого угла рабочего стола операционной системы.

На системах с несколькими мониторами у может иметь отрицательное значение. Если вы сохраняете значение, допустим для возвращения окна в предыдущее местоположение, необходимо всегда следить, чтобы во время восстановления окно находилось в пригодном для использования местоположении. Изменение разрешения экрана или организации мониторов может привести к тому, что окно попадет за пределы области экрана. Используйте класс Screen для получения информации о геометрии рабочего стола.

Изменение свойства окна у равносильно изменению местоположения через свойство bounds.



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

Выдает
ArgumentError — Если задано недопустимое значение или null.
 
IllegalOperationError — Если свойство получено после закрытия окна.

См. также

Сведения о конструкторе
AIR-only NativeWindow()Конструктор
public function NativeWindow(initOptions:NativeWindowInitOptions)

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

Создает новый экземпляр NativeWindow и соответствующее окно операционной системы.

Настройки, определенные параметром initOptions, нельзя изменять после создания окна. Недействительные параметры initOptions приведут к появлению ошибки о недопустимой операции. Действительные параметры, которые недоступны в текущей системе, вызовут создание исключения. При желании возможности, специфические для текущей операционной системы, можно определить с помощью статических членов NativeWindow, таких как systemMaxSize.

Размеры окна по умолчанию определяются операционной системой, но их можно изменить путем задания границ окна. Это изменение не будет видимым, если свойство окна visible имеет значение false.

Параметры
initOptions:NativeWindowInitOptions — Объект, содержащий свойства инициализации для данного окна.

Выдает
IllegalOperationError — Если параметр initOptions недействительный.

См. также

Сведения о методе
AIR-only activate()метод
public function activate():void

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

Активирует данное окно.

Активация окна:

См. также

AIR-only close()метод 
public function close():void

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

Закрывает окно.

Событие close отправляется сразу после завершения операции закрытия. Событие closing не отправляется. Если необходимо разрешить отмену операции закрытия, отправьте событие closing и проверьте, отменят ли зарегистрированные прослушиватели поведение по умолчанию перед вызовом метода close().

Если на отображаемые в окне экземпляры экранных объектов нет других ссылок, они будут очищены и уничтожены, за исключением начального окна приложения, созданного в AIR. Чтобы разрешить очистку экранных объектов на начальном окне, удалите их из рабочей области окна.

После закрытия объект NativeWindow все еще доступен для ссылок, но обращение к большинству свойств и методов приведет к появлению ошибки о недопустимой операции.

Закрытые окна нельзя открыть повторно. Если окно уже закрыто, никакие действия не предпринимаются и события не отправляются.

Примечание. Чтобы скрыть окно, не закрывая его, задайте свойству visible окна значение false.

См. также

AIR-only globalToScreen()метод 
public function globalToScreen(globalPoint:Point):Point

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

Преобразует точку в координатах пикселов относительно исходной точки в рабочей области окна (глобальной точки списка отображения) в точку на виртуальном рабочем столе.

Координаты виртуального рабочего стола строятся относительно верхнего левого угла главного монитора.

Параметры

globalPoint:Point — Точка в рабочей области, преобразуемая в точку на экране.

Возвращает
Point — Заданная глобальная точка относительно рабочего стола.

См. также

AIR-only maximize()метод 
public function maximize():void

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

Разворачивает данное окно.

Вызов метода maximize() отправляет событие displayStateChange и, когда применимо, события move и resize. Системный хром отправляет событие displayStateChanging, которое можно отменить, когда пользователь инициирует команду "развернуть". При желании можно внедрить такое поведение логики разворачивания.

Метод maximize() выполняется асинхронно. Чтобы узнать о завершении изменения состояния, прослушивайте событие displayStateChange.

Если окно уже развернуто, никакие действия не предпринимаются и события не отправляются.

Примечание. В операционных системах, таких как Mac OS X, где разворачивание окна не предотвращает изменения размеров, вызов метода maximize() приведет к увеличению окна на весь экран, но не предотвратит последующего изменения его размеров. Изменение размеров развернутого окна также приведет к восстановлению состояния отображения.


Выдает
IllegalOperationError — Если свойство maximizable этого окна имеет значение false или если метод вызывается после закрытия данного окна.

См. также

AIR-only minimize()метод 
public function minimize():void

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

Сворачивает данное окно.

Вызов метода minimize() отправляет событие displayStateChange и, когда применимо, события move и resize. Тогда как системный хром отправляет событие displayStateChanging, которое можно отменить, когда пользователь инициирует команду "свернуть", этого не происходит при вызове minimize() напрямую. При желании для логики сворачивания можно внедрить такое поведение.

Метод minimize() выполняется асинхронно. Чтобы узнать о завершении изменения состояния, прослушивайте событие displayStateChange.

Если окно уже свернуто, никакие действия не предпринимаются и события не отправляются.


Выдает
IllegalOperationError — Если свойство minimizable этого окна имеет значение false или если метод вызывается после закрытия данного окна.

См. также

AIR-only notifyUser()метод 
public function notifyUser(type:String):void

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

Запускает через операционную систему визуальный сигнал о том, что произошло событие, представляющее интерес.

Когда NativeWindow.supportsNotification имеет значение true, визуальный сигнал соответствует правилам собственной операционной системы. Например, в Windows мигает значок на панели задач.

Параметр type определяет интенсивность сигнала. Константы для разрешенных значений определены в классе NotificationType и могут быть следующими:

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

Примечание. Вызов метода notifyUser(), когда NativeWindow.supportsNotification имеет значение false разрешен, но не выполняет никаких действий.

Параметры

type:String — Строка, описывающая срочность оповещения.

AIR-only orderInBackOf()метод 
public function orderInBackOf(window:NativeWindow):Boolean

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

Отправляет это окно непосредственно под заданное окно.

Не активирует окно или приложение и не переводит его в фокус. Порядок свернутых или скрытых окон (visible имеет значение false) изменить нельзя.

Параметры

window:NativeWindow — Окно приложения.

Возвращает
Booleantrue, если это окно успешно выведено под остальные; false, если окно невидимо или свернуто.
AIR-only orderInFrontOf()метод 
public function orderInFrontOf(window:NativeWindow):Boolean

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

Помещает данное окно непосредственно над заданным окном.

Не активирует окно или приложение и не переводит его в фокус. Порядок свернутых или скрытых окон (visible имеет значение false) изменить нельзя.

Параметры

window:NativeWindow — Окно приложения.

Возвращает
Booleantrue, если это окно успешно выведено поверх остальных; false, если окно невидимо или свернуто.
AIR-only orderToBack()метод 
public function orderToBack():Boolean

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

Отправляет это окно под все остальные видимые окна.

Не активирует это окно или приложение и не переводит его в фокус. Порядок свернутых или скрытых окон (visible имеет значение false) изменить нельзя.

Если alwaysInFront имеет значение true, то вызов этого метода не переместит это окно поверх тех окон, для которыхalwaysInFront имеет значение false.

Возвращает
Booleantrue, если это окно успешно выведено под остальные; false, если окно невидимо или свернуто.
AIR-only orderToFront()метод 
public function orderToFront():Boolean

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

Выводит это окно поверх всех остальных видимых окон.

Не активирует это окно или приложение и не переводит его в фокус. Порядок свернутых или скрытых окон (visible имеет значение false) изменить нельзя.

Если alwaysInFront имеет значение false, то вызов этого метода не переместит это окно поверх тех окон, для которыхalwaysInFront имеет значение true.

Возвращает
Booleantrue, если это окно успешно выведено поверх остальных; false, если окно невидимо или свернуто.
AIR-only restore()метод 
public function restore():void

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

Восстанавливает окно из свернутого или развернутого состояния.

Вызов метода restore() отправляет событие displayStateChange и, когда применимо, события move и resize. Системный хром отправляет событие displayStateChanging, которое можно отменить, когда пользователь инициирует команду "восстановить". При желании можно внедрить такое поведение логики разворачивания.

Метод restore() выполняется асинхронно. Чтобы узнать о завершении изменения состояния, прослушивайте событие displayStateChange.

Если окно уже находится в состоянии NativeWindowDisplayState.NORMAL, никакие действия не предпринимается и события не отправляются.


Выдает
IllegalOperationError — Если метод вызван после закрытия окна.

См. также

AIR-only startMove()метод 
public function startMove():Boolean

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

Запускает перемещение данного окна системой.

При вызове из события mouseDown этот метод начинает последовательность перемещения мышью, которая продолжается до получения события mouseUp.

При вызове из другого кода этот метод начинает последовательность перемещения с помощью клавиатуры или мыши в соответствии с последовательностью, используемой по умолчанию в операционной системе.

Во время выполнения последовательности будет отправляться серия событий по ходу перемещения окна. Для каждого добавочного перемещения отправляется событие moving, а затем, если moving не отменяется, обновляется местоположение окна и отправляется событие move. Если событие moving отменено, последовательность перемещения немедленно прекращается.

Возвращает
Booleantrue, если перемещение инициировано успешно, и false, если окно развернуто.

Выдает
IllegalOperationError — Если метод вызван после закрытия окна.
AIR-only startResize()метод 
public function startResize(edgeOrCorner:String):Boolean

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

Запускает изменение размеров данного окна под управлением системы.

При вызове из обработчика события mouseDown этот метод начинает последовательность изменения размеров мышью, которая продолжается до получения события mouseUp.

При вызове из другого кода этот метод начинает последовательность изменения размеров с помощью клавиатуры или мыши в соответствии с последовательностью, используемой по умолчанию в операционной системе.

Во время выполнения последовательности будет отправляться серия событий по ходу изменения размеров окна. Для каждого добавочного изменения отправляется событие resizing, а затем, если resizing не отменяется, обновляется местоположение окна и отправляется событие resize. Если событие resizing отменено, последовательность перемещения немедленно прекращается.

Параметры

edgeOrCorner:String (default = NaN) — Константа класса NativeWindowResize, задающая край или угол окна для изменения размеров. Ниже приводятся допустимые значения.

ЗначениеВыравнивание по вертикалиВыравнивание по горизонтали
NativeWindowResize.TOPВерхний крайЦентр
NativeWindowResize.BOTTOMНижний крайЦентр
NativeWindowResize.LEFTЦентрСлева
NativeWindowResize.RIGHTЦентрСправа
NativeWindowResize.TOP_LEFTВерхний крайСлева
NativeWindowResize.TOP_RIGHTВерхний крайСправа
NativeWindowResize.BOTTOM_LEFTНижний крайСлева
NativeWindowResize.BOTTOM_RIGHTНижний крайСправа
NativeWindowResize.NONEНижний крайСправа

Возвращает
Booleantrue, если изменение размеров инициировано успешно, и false, если окно развернуто.

Выдает
IllegalOperationError — Если метод вызван после закрытия окна.
Сведения о событии
AIR-only activate Событие
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.ACTIVATE

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

Отправляется данным объектом NativeWindow после активации окна.

Константа Event.ACTIVATE определяет значение свойства type объекта события Activitate.

Примечание. Это событие не имеет фазы захвата и фазы пузырей, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

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

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetЛюбой экземпляр EventDispatcher, для которого зарегистрирован прослушиватель события ACTIVATE.
AIR-only close Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.CLOSE

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

Отправляется данным объектом NativeWindow после закрытия окна.

Константа Event.CLOSE определяет значение свойства type объекта события close.

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

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, для которого разорвано подключение.
AIR-only closing Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.CLOSING

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

Отправляется этим объектом NativeMenu object непосредственно перед закрытием окна. Это событие можно отменить, чтобы предотвратить закрытие окна.

Константа Event.CLOSING определяет значение свойства type объекта события closing.

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

СвойствоЗначение
bubblesfalse
cancelabletrue; отмена данного объекта отменяет операцию закрытия.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, для которого подключение будет разорвано.
AIR-only deactivate Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.DEACTIVATE

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

Отправляется данным объектом NativeWindow после деактивации окна.

Константа Event.DEACTIVATE определяет значение свойства type объекта событияdeactivate.

Примечание. Это событие не имеет фазы захвата и фазы пузырей, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

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

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetЛюбой экземпляр EventDispatcher, для которого зарегистрирован прослушиватель события DEACTIVATE.
AIR-only displayStateChange Событие  
Тип объекта события: flash.events.NativeWindowDisplayStateEvent
свойство NativeWindowDisplayStateEvent.type = flash.events.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGE

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

Отправляется данным объектом NativeWindow после изменения свойства displayState окна.

Задает значение свойства type для объекта события displayStateChange. Данное событие имеет следующие свойства.
СвойстваЗначения
afterDisplayStateСтарое состояние отображения окна.
beforeDisplayStateНовое состояние отображения окна.
targetЭкземпляр NativeWindow, который только что изменил состояние.
bubblesНет.
currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
cancelablefalse; нет поведения по умолчанию для отмены.
AIR-only displayStateChanging Событие  
Тип объекта события: flash.events.NativeWindowDisplayStateEvent
свойство NativeWindowDisplayStateEvent.type = flash.events.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING

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

Отправляется данным объектом NativeWindow непосредственно перед изменением состояния отображения окна. Это событие можно отменить, чтобы предотвратить изменение.

Задает значение свойства type для объекта события displayStateChanging. Данное событие имеет следующие свойства.
СвойстваЗначения
afterDisplayStateСостояние отображения окна до ожидаемого изменения.
beforeDisplayStateСостояние отображения окна после ожидаемого изменения.
targetЭкземпляр NativeWindow, который только что изменил состояние.
bubblesНет.
currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
cancelabletrue; отмена события предотвратит изменение.
AIR-only move Событие  
Тип объекта события: flash.events.NativeWindowBoundsEvent
свойство NativeWindowBoundsEvent.type = flash.events.NativeWindowBoundsEvent.MOVE

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

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

Событие move отправляется при каждом изменении размеров (свойств х или у) окна, что может происходить вследствие перемещения окна под управлением системы; свертывания, развертывания или восстановления окна; или изменения местоположения окна путем задания свойств х, у или bounds.

Примечание. Избегайте действий, которые могут открыть одновременные диалоговые окна операционной системы в функциях обработчиков для событий moving и move объекта NativeWindow. К примеру, такое может произойти, если обе функции обработчиков выдают ошибки. Если это произойдет, второе открытое диалоговое окно не будет отвечать на щелчки мыши, его придется закрыть с клавиатуры.

Задает значение свойства type для объекта события move. Данное событие имеет следующие свойства.
СвойстваЗначения
afterBoundsНовые границы окна.
beforeBoundsСтарые границы окна.
targetОбъект NativeWindow, который только что изменил состояние.
bubblesНет.
currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
cancelablefalse; нет поведения по умолчанию для отмены.
AIR-only moving Событие  
Тип объекта события: flash.events.NativeWindowBoundsEvent
свойство NativeWindowBoundsEvent.type = flash.events.NativeWindowBoundsEvent.MOVING

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

Отправляется этим объектом NativeMenu object непосредственно перед перемещением окна на рабочем столе. Это событие можно отменить, чтобы предотвратить перемещение или модифицировать его свойства.

Примечание. Избегайте действий, которые могут открыть одновременные диалоговые окна операционной системы в функциях обработчиков для событий moving и move объекта NativeWindow. К примеру, такое может произойти, если обе функции обработчиков выдают ошибки. Если это произойдет, второе открытое диалоговое окно не будет отвечать на щелчки мыши, его придется закрыть с клавиатуры.

Задает значение свойства type для объекта события moving. Данное событие имеет следующие свойства.
СвойстваЗначения
afterBoundsГраницы окна после ожидаемого изменения.
beforeBoundsГраницы окна до ожидаемого изменения.
bubblesНет.
cancelabletrue; отмена события предотвращает перемещение окна.
currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект NativeWindow, который только что изменил состояние.
AIR-only resize Событие  
Тип объекта события: flash.events.NativeWindowBoundsEvent
свойство NativeWindowBoundsEvent.type = flash.events.NativeWindowBoundsEvent.RESIZE

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

Отправляется данным объектом NativeWindow после изменения размеров окна. Событие resize отправляется при каждом изменении размеров (свойств width или height) окна, что может происходить вследствие изменения размеров окна под управлением системы; свертывания, развертывания или восстановления окна; или изменения размеров окна путем задания свойств width, height или bounds. События resize объекта NativeWindow отправляются во время циклов изменения размеров под управлением системы. Напротив, события resize объекта Stage отправляются, когда рабочая область готова для рисования.

Задает значение свойства type для объекта события Resize. Данное событие имеет следующие свойства.
СвойстваЗначения
afterBoundsНовые границы окна.
beforeBoundsСтарые границы окна.
targetОбъект NativeWindow, который только что изменил состояние.
bubblesНет.
currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
cancelablefalse; нет поведения по умолчанию для отмены.

См. также

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

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

Отправляется этим объектом NativeMenu object непосредственно перед изменением размеров окна на рабочем столе. Это событие можно отменить, чтобы предотвратить изменение размеров или изменить его свойства.

Задает значение свойства type для объекта события resizing. Данное событие имеет следующие свойства.
СвойстваЗначения
afterBoundsГраницы окна после ожидаемого изменения.
beforeBoundsГраницы окна до ожидаемого изменения.
targetОбъект NativeWindow, который только что изменил состояние.
bubblesНет.
currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
cancelabletrue; отмена события предотвращает перемещение окна.