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

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

См. также

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

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

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

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

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

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

Размеры окна включают системный хром. Размеры рабочей области окна равны размерам окна минус размер системного хрома. Изменение ширины и высоты окна приведет к изменению свойств 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 окна или минимальными и максимальными ограничениями операционной системы, то размеры окна изменятся до ближайшего допустимого размера. Минимальная ширина и высота отображаемого системного хрома также может привести к превышению заданного размера окна.

См. также

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

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

• title
• bounds
• x, y, width, height
• displayState
• visible

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

• minimize()
• maximize()
• restore()
• startResize()
• startMove()

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

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

• NativeWindowDisplayState.NORMAL
• NativeWindowDisplayState.MINIMIZED
• NativeWindowDisplayState.MAXIMIZED

См. также

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

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

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

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

См. также

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

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

См. также

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

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

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

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

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

См. также

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

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

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

См. также

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

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

См. также

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

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

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

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

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

См. также

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

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

См. также

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

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

См. также

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

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

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

См. также

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

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

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

См. также

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

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

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

См. также

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

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

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

См. также

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

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

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

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

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

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

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

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

См. также

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

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

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

См. также

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

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

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

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

См. также

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

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

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

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

См. также

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

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

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

См. также

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

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

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

См. также

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

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

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

См. также

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

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

• делает окно видимым;
• выводит его поверх остальных окон;
• помещает его в фокус клавиатуры или мыши.

См. также

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

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

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

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

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

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

См. также

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

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

Параметры

См. также

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

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

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

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

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

См. также

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

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

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

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

См. также

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

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

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

• NotificationType.INFORMATIONAL
• NotificationType.CRITICAL

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

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

Параметры

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

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

Параметры

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

См. также

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

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

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

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

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

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