Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: AIR 30.0 или более ранней версии, Flash Player 30.0 или более ранней версии, Flash Lite 4
Flex 4.6 или более ранней версии, Flash Pro CS6 или более ранней версии
Скрыть фильтры
flash.display 

NativeWindow  - AS3

Пакетыx

Верхний уровень
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Элементы языка

Глобальные константы
Глобальные функции
Операторы
Инструкции, ключевые слова и директивы
Специальные типы

Приложения

Новые возможности
Ошибки компилятора
Предупреждения компилятора
Ошибки времени выполнения
Миграция ActionScript 3
Поддерживаемые наборы символов
Только MXML
Элементы движения XML
Теги Timed Text
устаревший_индекс
Константы реализации специальных возможностей
Использование примеров
Юридическая информация
Пакетflash.display
Классpublic class NativeWindow
НаследованиеNativeWindow Inheritance EventDispatcher Inheritance Object

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

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

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

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

var window:NativeWindow = displayObject.stage.nativeWindow;

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

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

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

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

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

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

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

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



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

active

свойство
active:Boolean  [только для чтения]

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

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

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



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

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

    

alwaysInFront

свойство 
alwaysInFront:Boolean

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

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

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

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

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

Примечания о вариантах поведения ОС

  • Некоторые диспетчеры окон Linux не отображают окна, свойству alwaysInFront которых задано значение , перед полноэкранными окнами.
  • В ОС Mac® OS X задание для alwaysInFront значения true не будет иметь силы, если свойству displayState рабочей области окна задано значение fullScreen или fullScreenInteractive.



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

Пример  ( Использование этого примера )
В следующих примерах окно принудительно отображается поверх всех других окон (которые не отображаются поверх других окон в принудительном порядке):
windowObj.alwaysInFront = true;
С помощью ссылки на экранный объект в рабочей области окна:
displayObject.stage.nativeWindow.alwaysInFront=true;
Из процедуры JavaScript, выполняющейся в объекте HTMLLoader окна (или корневом окне HTML):
window.nativeWindow.alwaysInFront = true;
    

bounds

свойство 
bounds:Rectangle

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

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

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

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

Событие resize отправляется при каждом изменении ширины или высоты окна. Подобным образом, событие move отправляется при каждом изменении исходной точки (х, у) окна. В Mac OS и Windows при задании свойства bounds напрямую событие moving или resizing не отправляется. Однако на Linux NativeWindow передает события moving и resizing, если установлено свойство bounds.

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

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

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

  • Свойства minSize и maxSize объекта NativeWindow
  • Максимально допустимое и минимально допустимые значения для операционной системы, являющиеся значениями NativeWindow.systemMinSize и NativeWindow.systemMaxSize.
  • Максимальное значение ширины и высоты окна в Adobe AIR, равное 4095 пикселям. (В AIR 1.5 и более ранних версиях максимальная ширина и высота окна составляет 2880 пикселей.)
  • Минимальные ширина и высота, требуемые для отображаемого системного Chrome.

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



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

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

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


Пример  ( Использование этого примера )
Следующие примеры задают границы окна с помощью ссылки на объект NativeWindow:
windowObj.bounds = new Rectangle(200, 200, 1000, 800);
С помощью ссылки на экранный объект в рабочей области окна:
displayObject.stage.nativeWindow.bounds = new Rectangle(20, 20, 800, 600);
Из процедуры JavaScript, выполняющейся в объекте HTMLLoader окна (или корневом окне HTML):
window.nativeWindow.bounds = new air.Rectangle(20, 20, 800, 600);
    

closed

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

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

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

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

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

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

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



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

Пример  ( Использование этого примера )
В следующем примере показано, как получить свойство closed окна:
var isWindowClosed:Boolean = windowObj.closed;
С помощью ссылки на экранный объект в рабочей области окна:
var isWindowClosed:Boolean = displayObject.stage.nativeWindow.closed;
Из процедуры JavaScript, выполняющейся в объекте HTMLLoader окна (или корневом окне HTML):
var isWindowClosed = window.nativeWindow.closed;
    

displayState

свойство 
displayState:String  [только для чтения]

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

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

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

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



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

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

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


Пример  ( Использование этого примера )
Следующий пример показывает, как получить текущее состояние отображения окна с помощью ссылки на объект окна:
var state:String = windowObj.displayState;
    

height

свойство 
height:Number

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

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

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

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

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

  • Свойства minSize.x и maxSize.x объекта NativeWindow
  • Минимально допустимое и максимально допустимое значения для операционный системы, являющиеся значениями NativeWindow.systemMinSize.x и NativeWindow.systemMaxSize.x.
  • Максимальная высота окна в Adobe AIR, которая составляет 4095 пикселей (2880 пикселей в AIR 1.5 и более ранних версиях).

В Linux установка свойства height является асинхронной операцией.

Чтобы узнать о завершении изменения высоты, прослушивайте событие resize, отправляемое на всех платформах.

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



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

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

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

    

isSupported

свойство 
isSupported:Boolean  [только для чтения]

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

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



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

maximizable

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

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

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

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

Примечание. Некоторые диспетчеры окон Linux разрешают пользователю разворачивать окна, даже когда свойству maximizable задано значение false.



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

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

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

    

maxSize

свойство 
maxSize:Point

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

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

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

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

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

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

  • Максимально допустимое значение для операционной системы, являющееся значением NativeWindow.systemMaxSize.
  • Максимальное значение ширины и высоты окна в Adobe AIR, равное 4095 пикселям. (В AIR 1.5 и более ранних версиях максимальная ширина и высота окна составляет 2880 пикселей.)

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



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

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

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


Пример  ( Использование этого примера )
Следующие примеры показывают, как задать максимальный допустимый размер окна.
windowObj.maxSize = new Point(1040,920);
С помощью ссылки на экранный объект в рабочей области окна:
displayObject.stage.nativeWindow.maxSize = new Point(800,600);
Из процедуры JavaScript, выполняющейся в объекте HTMLLoader окна (или корневом окне HTML):
window.nativeWindow.maxSize = new air.Point(960,960);
    

menu

свойство 
menu:NativeMenu

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

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

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

Примечание. Назначить меню для окна, когда NativeWindow.supportsMenu имеет значение false или когда свойство окна systemChrome имеет значение NativeWindowSystemChrome.NONE можно, но эта настройка не будет иметь силы. Свойство NativeWindow.supportsMenu позволяет определить, поддерживает ли операционная система оконные меню. Использование других средств (например, Capabilities.os) для определения поддержки может привести к ошибкам программирования (если некоторые целевые операционные системы не рассматриваются).



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

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

    

minimizable

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

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

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

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

Примечание. Некоторые диспетчеры окон Linux разрешают пользователю сворачивать окна, даже когда свойству minimizable задано значение false.



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

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

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

    

minSize

свойство 
minSize:Point

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

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

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

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

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

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



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

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

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


Пример  ( Использование этого примера )
Следующие примеры показывают, как задать минимальный допустимый размер окна:
windowObj.minSize = new Point(200,80);
С помощью ссылки на экранный объект в рабочей области окна:
displayObject.stage.nativeWindow.minSize = new Point(120,60);
Из процедуры JavaScript, выполняющейся в объекте HTMLLoader окна (или корневом окне HTML):
window.nativeWindow.minSize = new air.Point(80,60);
    

owner

свойство 
owner:NativeWindow  [только для чтения]

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

Объект NativeWindow, который владеет этим окном.

Собственность Окно установлена, когда окно создано и не может быть изменено. Чтобы создать окно, у которого есть владелец, устанавливает объект NativeWindow обладания как владелец свойства объекта NativeWindowInitOptions, использованного, чтобы создать находящееся в собственности окно.

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



Реализация
    public function get owner():NativeWindow

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

    

renderMode

свойство 
renderMode:String  [только для чтения]

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

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

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

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



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

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

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

    

resizable

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

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

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

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



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

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

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

    

stage

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

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

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

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



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

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


Пример  ( Использование этого примера )
В следующем примере показано, как задать свойства рабочей области для экземпляра NativeWindow:
import flash.display.StageAlign;

windowObj.stage.align = StageAlign.TOP_LEFT;
    

supportsMenu

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

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

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

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

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



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

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

    

supportsNotification

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

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

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

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

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



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

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

    

supportsTransparency

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

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

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

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

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



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

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

    

systemChrome

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

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

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

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

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



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

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

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


Пример  ( Использование этого примера )
В следующем примере показано, как получить тип системного Chrome для окна:
var sysChromeType:String = windowObj.systemChrome;
С помощью ссылки на экранный объект в рабочей области окна:
var sysChromeType:String = displayObject.stage.nativeWindow.systemChrome;
Из процедуры JavaScript, выполняющейся в объекте HTMLLoader окна (или корневом окне HTML):
var sysChromeType = window.nativeWindow.systemChrome;
Следующий пример показывает, как изменить видимый системный Chrome и параметры отображения прозрачных областей путем создания нового окна и перемещения всех дочерних экранных объектов в это новое окно:
import flash.display.NativeWindow;
import flash.display.NativeWindowSystemChrome;
import flash.display.NativeWindowInitOptions;

public function deChromeWindow(oldWindow:NativeWindow):NativeWindow{
    if(oldWindow.systemChrome != NativeWindowSystemChrome.NONE){
        var newOptions:NativeWindowInitOptions = new NativeWindowInitOptions();
        newOptions.systemChrome = NativeWindowSystemChrome.NONE;
        newOptions.transparent = true;
        
        var newWindow:NativeWindow = new NativeWindow(newOptions);
        newWindow.stage.stageWidth = oldWindow.stage.stageWidth;
        newWindow.stage.stageHeight = oldWindow.stage.stageHeight;
        newWindow.stage.align = oldWindow.stage.align;
        newWindow.stage.scaleMode = oldWindow.stage.scaleMode;
        
        for(var i:int = 0; i < oldWindow.stage.numChildren; i++){
            newWindow.stage.addChild(oldWindow.stage.getChildAt(i));
        }
        newWindow.activate();
        oldWindow.close();
        
        return newWindow;
    }
    return oldWindow;
}

    

systemMaxSize

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

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

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

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

В дополнение к ограничению размера операционной системы в AIR предусмотрен максимально допустимый размер окна, который составляет 4095 х 4095 пикселей (2880 х 2880 пикселей в AIR 1.5 и более ранних версиях). И для приложения может быть задано предельное значение с помощью свойства maxSize объекта NativeWindow.



Реализация
    public static function get systemMaxSize():Point
    

systemMinSize

свойство 
systemMinSize:Point  [только для чтения]

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

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

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



Реализация
    public static function get systemMinSize():Point
    

title

свойство 
title:String

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

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

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



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

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

Пример  ( Использование этого примера )
Следующий пример задает заголовок для объекта окна:
windowObj.title = "Window Title";
    

transparent

свойство 
transparent:Boolean  [только для чтения]

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

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

Свойство transparent нельзя изменить после создания окна. Прозрачность влияет на внешний вид окна и на поведение мыши в его границах. В Windows и Mac OS X окно не может выполнить захват событий мыши, если альфа-значение пикселя ниже определенного порогового значения, которое в зависимости от операционной системы варьируется между 0,06 и 0,01. В Linux окно будет захватывать события мыши в абсолютно прозрачных областях, тем самым предотвращая доступ пользователей к другим окнам и элементам рабочего стола.

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



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

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

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

    

type

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

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

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

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

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



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

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

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

    

visible

свойство 
visible:Boolean

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

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

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

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

Если у этого окна есть владелец, состояние видимости этого окна определяет отображение окна. Если окно с владельцем не отображается, значит все другие окна также не отображаются, даже если для параметра visible установлено значение true.

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



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

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

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


Пример  ( Использование этого примера )
В следующем примере показано, как получить свойство visible окна:
windowObj.visible = true;
С помощью ссылки на экранный объект в рабочей области окна:
displayObj.stage.nativeWindow.visible = true;
Из процедуры JavaScript, выполняющейся в объекте HTMLLoader окна (или корневом окне HTML):
window.nativeWindow.visible = true;
    

width

свойство 
width:Number

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

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

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

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

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

  • Свойства minSize.y и maxSize.y объекта NativeWindow
  • Минимально допустимое и максимально допустимое значения для операционный системы, являющиеся значениями NativeWindow.systemMinSize.y и NativeWindow.systemMaxSize.y.
  • Максимальная ширина окна в Adobe AIR, которая составляет 4095 пикселей (2880 пикселей в AIR 1.5 и более ранних версиях).

В Linux установка свойства width является асинхронной операцией.

Чтобы узнать о завершении изменения ширины, прослушивайте событие resize, отправляемое на всех платформах.

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



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

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

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

    

x

свойство 
x:Number

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

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

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

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

В Linux установка свойства x является асинхронной операцией.

Чтобы узнать о завершении изменения позиции, прослушивайте событие displayStateChange.

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



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

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

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

    

y

свойство 
y:Number

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

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

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

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

В Linux установка свойства y является асинхронной операцией.

Чтобы узнать о завершении изменения позиции, прослушивайте событие displayStateChange.

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



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

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

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

Сведения о конструкторе
    

NativeWindow

()Конструктор
public function NativeWindow(initOptions:NativeWindowInitOptions)

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

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

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

Размер окна по умолчанию определяется операционной системой, окна создаются в невидимом состоянии. Чтобы предотвратить явное изменение окна, не изменяйте значение его свойства visible на true и не вызывайте метод activate(), пока не завершится изменение окна.

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

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

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


Пример  ( Использование этого примера )

В следующем примере создается и активируется новый экземпляр NativeWindow:
import flash.display.NativeWindowInitOptions;
import flash.display.NativeWindowSystemChrome;
import flash.display.NativeWindowType;
import flash.display.NativeWindow;
import flash.display.StageAlign;
import flash.display.StageScaleMode;
import flash.geom.Rectangle;

var windowOptions:NativeWindowInitOptions = new NativeWindowInitOptions();
windowOptions.systemChrome = NativeWindowSystemChrome.STANDARD;
windowOptions.type = NativeWindowType.NORMAL;

var newWindow:NativeWindow = new NativeWindow(windowOptions);
newWindow.stage.scaleMode = StageScaleMode.NO_SCALE;
newWindow.stage.align = StageAlign.TOP_LEFT;
newWindow.bounds = new Rectangle(100, 100, 800, 800);

newWindow.activate();
Сведения о методе

    activate

()метод
public function activate():void

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

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

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

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

В Linux activate() является асинхронной операцией.

Объект NativeWindow отправляет событие activate во всех платформах.

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


Пример  ( Использование этого примера )

Следующий пример показывает, как сделать окно активным:

С помощью ссылки на экранный объект в рабочей области окна:

displayObject.stage.nativeWindow.activate();

С помощью ссылки на экземпляр класса NativeWindow:
windowObj.activate();

Из JavaScript на странице HTML, отображаемой в окне (где window является глобальным объектом окна JavaScript):
window.nativeWindow.activate();

    close

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

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

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

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

Когда окно закрывается, любые окна, которыми оно владеет, также закрываются. Находящиеся в собственности окна не отправляются закрытие события.

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

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

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

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

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


Пример  ( Использование этого примера )

Следующий пример показывает, как закрыть окно:

С помощью ссылки на экземпляр NativeWindow (windowObj):

windowObj.close();


С помощью ссылки на экранный объект в рабочей области окна:
displayObj.stage.nativeWindow.close();

Из процедуры JavaScript, выполняющейся в объекте HTMLLoader (или корневом окне HTML):
window.close(); //overriddable in HTMLHost

Или:
window.nativeWindow.close(); //not overriddable

Следующий пример показывает, как можно разрешить отмену операции закрытия (где windowObj является экземпляром NativeWindow, который нужно закрыть):
public function closeCommand():Boolean{
    var closeEvent:Event = new Event(Event.CLOSING,true,true);
    windowObj.dispatchEvent(closeEvent);
    if(!closeEvent.isDefaultPrevented()){
        windowObj.close();
        return true;
    } else {
      return false;
    }
}

Следующий пример показывает, как закрыть окно из процедуры JavaScript, выполняющейся в объекте HTMLLoader (или корневом окне HTML) с разрешением отмены этой операции:
<script src="AIRAliases.js" type="text/javascript"></script>
<script type="text/javascript">
    var dirtyData = false;
    function closeWindow(){
            var closingEvent = new air.Event(air.Event.CLOSING,true,true);
            window.nativeWindow.dispatchEvent(closingEvent);
               if(!closingEvent.isDefaultPrevented()){
                   window.nativeWindow.close();
                //or use: window.close(); 
               return true;
           } else {
               return false;
        }
    }
        
    function onClosing(event){
        if(dirtyData){
            event.preventDefault();
            //Save data...
        }
    }    

    window.nativeWindow.addEventListener(air.Event.CLOSING,onClosing);        
</script>

    globalToScreen

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

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

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

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

Параметры

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

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

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

    listOwnedWindows

()метод 
public function listOwnedWindows():Vector.<NativeWindow>

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

Возвращает список объектов NativeWindow, которыми владеет это окно.

Вы не можете изменить собственность NativeWindows, добавляя или удаляя объекты из возвращенного вектора. Собственность Окно не может быть изменена после того, как окно создано.

Возвращает
Vector.<NativeWindow>Vector.Объект <NativeWindow>, содержащий нуль или больше объектов NativeWindow, которые владеются этим экземпляром.

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

    maximize

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

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

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

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

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

Примечания о вариантах поведения ОС

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


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

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


Пример  ( Использование этого примера )

Следующий пример показывает, как можно разрешить отмену операции разворачивания:
public function maximizeWindow(nativeWin:NativeWindow):Boolean{
  if(nativeWin.displayState != NativeWindowDisplayState.MAXIMIZED){
    var beforeState:String = nativeWin.displayState;
    var afterState:String = NativeWindowDisplayState.MAXIMIZED;
    var displayStateEvent:NativeWindowDisplayStateEvent = 
        new NativeWindowDisplayStateEvent(NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
    nativeWin.dispatchEvent(displayStateEvent);
    if(!displayStateEvent.isDefaultPrevented()){
        nativeWin.maximize();
        return true;
    } else {
      return false;
    }
  }
  return false;
}

Следующий пример показывает, как можно разрешить отмену операции разворачивания окна из процедуры JavaScript, выполняющейся в объекте HTMLLoader (или окне HTML):
function maximizeWindow(nativeWin){
    if(nativeWin.displayState != air.NativeWindowDisplayState.MAXIMIZED){
        var beforeState = nativeWin.displayState;
        var afterState = air.NativeWindowDisplayState.MAXIMIZED;
        var displayStateEvent = 
            new air.NativeWindowDisplayStateEvent(air.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        nativeWin.dispatchEvent(displayStateEvent);
        if(!displayStateEvent.isDefaultPrevented()){
            nativeWin.maximize();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

    minimize

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

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

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

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

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

При сворачивании окна скрываются все окна, владельцем которых является это окно. Находящиеся в собственности окна не отправляют события displayStateChanging и displayStateChange.

Примечания.

  • В ОС Windows, если свернуть невидимое окно (visible == false), оно становится видимым.
  • Некоторые диспетчеры окон Linux запрещают сворачивание служебных окон.


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

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


Пример  ( Использование этого примера )

Следующий пример показывает, как разрешить отмену вызова метода minimize() путем отправки события displayStateChanging:
public function minimizeWindow(nativeWin:NativeWindow):Boolean{
    if(nativeWin.displayState != NativeWindowDisplayState.MINIMIZED){
        var beforeState:String = nativeWin.displayState;
        var afterState:String = NativeWindowDisplayState.MINIMIZED;
        var displayStateEvent:NativeWindowDisplayStateEvent = 
            new NativeWindowDisplayStateEvent(NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        nativeWin.dispatchEvent(displayStateEvent);
        if(!displayStateEvent.isDefaultPrevented()){
            nativeWin.minimize();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

Следующий пример показывает, как разрешить отмену вызова метода minimize() в сценарии JavaScript, выполняющемся в объекте HTMLLoader (или окне HTML):
 
function minimizeWindow(){
    if(window.nativeWindow.displayState != air.NativeWindowDisplayState.MINIMIZED){
        var beforeState = window.nativeWindow.displayState;
        var afterState = air.NativeWindowDisplayState.MINIMIZED;
        var displayStateEvent = 
            new air.NativeWindowDisplayStateEvent(air.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        window.nativeWindow.dispatchEvent(displayStateEvent);
        if(!displayStateEvent.isDefaultPrevented()){
            window.nativeWindow.minimize();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

    notifyUser

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

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

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

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

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

  • NotificationType.INFORMATIONAL
  • NotificationType.CRITICAL

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

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

Параметры

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

    orderInBackOf

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

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

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

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

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

Некоторые диспетчеры окон Linux запрещают размещение служебных окон под обычными окнами.

Параметры

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

Возвращает
Booleantrue, если это окно успешно выведено под остальные; false, если окно невидимо или свернуто.

Пример  ( Использование этого примера )

Следующие примеры показывают, как поместить окно позади другого окна с помощью ссылок на экземпляры NativeWindow:
windowBehind.orderInBackOf(windowFront);

С помощью ссылок на экранные объекты в рабочих областях окна:
displayObjBehind.stage.nativeWindow.orderInBackOf(displayObjectFront.stage.nativeWindow);


Из процедуры JavaScript, выполняющейся в объекте HTMLLoader (или корневом окне HTML), со ссылками на два объекта окна JavaScript:
jsWindowObjBehind.nativeWindow.orderInBackOf(jsWindowObjFront.nativeWindow);

    orderInFrontOf

()метод 
public function orderInFrontOf(window:NativeWindow):Boolean

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

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

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

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

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

Параметры

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

Возвращает
Booleantrue, если это окно успешно выведено поверх остальных; false, если окно невидимо или свернуто.

Пример  ( Использование этого примера )

Следующие примеры показывают, как поместить окно поверх другого окна с помощью ссылок на экземпляры NativeWindow:
windowFront.orderInFrontOf(windowBehind);

С помощью ссылок на экранные объекты в рабочих областях окна:
displayObjFront.stage.nativeWindow.orderInFrontOf(displayObjectBehind.stage.nativeWindow);


Из процедуры JavaScript, выполняющейся в объекте HTMLLoader (или корневом окне HTML), со ссылками на два объекта окна JavaScript:
jsWindowObjFront.nativeWindow.orderInFrontOf(jsWindowObjBehind.nativeWindow);

    orderToBack

()метод 
public function orderToBack():Boolean

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

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

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

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

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

Некоторые диспетчеры окон Linux запрещают размещение служебных окон под обычными окнами.

Возвращает
Booleantrue, если это окно успешно выведено под остальные; false, если окно невидимо или свернуто.

Пример  ( Использование этого примера )

Следующие примеры показывают, как поместить окно позади всех других окон приложения (с той же настройкой alwaysInFront):
windowObj.orderToBack();


С помощью ссылки на экранный объект в рабочей области окна:
displayObj.stage.nativeWindow.orderToBack();

Из процедуры JavaScript, выполняющейся в объекте HTMLLoader окна (или корневом окне HTML):
window.nativeWindow.orderToBack();

    orderToFront

()метод 
public function orderToFront():Boolean

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

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

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

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

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

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

Возвращает
Booleantrue, если это окно успешно выведено поверх остальных; false, если окно невидимо или свернуто.

Пример  ( Использование этого примера )

В следующих примерах показано, как поместить окно поверх всех других окон приложения (с той же настройкой alwaysInFront):
windowObj.orderToFront();


С помощью ссылки на экранный объект в рабочей области окна:
displayObj.stage.nativeWindow.orderToFront();

Из процедуры JavaScript, выполняющейся в объекте HTMLLoader окна (или корневом окне HTML):
window.nativeWindow.orderToFront();

    restore

()метод 
public function restore():void

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

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

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

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

Чтобы узнать о завершении изменения состояния, прослушивайте событие displayStateChange, которое отправляется на всех платформах.


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

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


Пример  ( Использование этого примера )

Следующий пример показывает, как можно разрешить отмену операции восстановления:
public function restoreWindow(nativeWin:NativeWindow):Boolean{
    if(nativeWin.displayState != NativeWindowDisplayState.NORMAL){
        var beforeState:String = nativeWin.displayState;
        var afterState:String = NativeWindowDisplayState.NORMAL;
        var displayStateChangingEvent:NativeWindowDisplayStateEvent = 
            new NativeWindowDisplayStateEvent(NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        nativeWin.dispatchEvent(displayStateChangingEvent);
        if(!displayStateChangingEvent.isDefaultPrevented()){
            nativeWin.restore();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

Следующий пример показывает, как можно разрешить отмену операции восстановления окна из процедуры JavaScript, выполняющейся в объекте HTMLLoader (или окне HTML):
function restoreWindow(nativeWin){
    if(window.nativeWindow.displayState != air.NativeWindowDisplayState.NORMAL){
        var beforeState = window.nativeWindow.displayState;
        var afterState = air.NativeWindowDisplayState.NORMAL;
        var displayStateEvent = 
            new air.NativeWindowDisplayStateEvent(air.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        window.nativeWindow.dispatchEvent(displayStateEvent);
        if(!displayStateEvent.isDefaultPrevented()){
            window.nativeWindow.restore();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

    startMove

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

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

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

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

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

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

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

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

Пример  ( Использование этого примера )

Следующий пример показывает, как переместить окно в ответ на событие mouseDown:
var initOpts:NativeWindowInitOptions = new NativeWindowInitOptions();
var win:NativeWindow = new NativeWindow(initOpts);
win.activate();
win.stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);

function mouseDownHandler(event:MouseEvent):void
{
    win.startMove();
}

    startResize

()метод 
public function startResize(edgeOrCorner:String = "BR"):Boolean

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

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

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

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

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

Параметры

edgeOrCorner:String (default = "BR") — Константа класса 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 — Если метод вызван после закрытия окна.

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


Пример  ( Использование этого примера )

Следующий пример показывает, как изменить размер окна в ответ на событие mouseDown:
stage.addEventListener(MouseEvent.MOUSE_DOWN, onResizeCommand);

function onResizeCommand(event:MouseEvent):void
{
    var win:NativeWindow = event.target.nativeWindow;
    var resizeFrom:String = "";
    if (event.stageY < win.height * .33)
    {
        resizeFrom = NativeWindowResize.TOP;
    }
    else if (event.stageY > win.height * .66)
    {
        resizeFrom = NativeWindowResize.BOTTOM;
    }
    if (event.stageX < win.width * .33)
    {
        resizeFrom += NativeWindowResize.LEFT;
    }
    else if (event.stageX > win.width * .66)
    {
        resizeFrom += NativeWindowResize.RIGHT;
    }
    win.startResize(resizeFrom);    
}
Сведения о событии
    

activate

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

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

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

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

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

На устройствах AIR for TV это событие никогда не отправляется автоматически. Однако его можно отправить вручную.

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

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetЛюбой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события activate.
    

close

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

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

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

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

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

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, для которого разорвано подключение.
    

closing

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

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

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

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

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

СвойствоЗначение
bubblesfalse
cancelabletrue; отмена данного объекта отменяет операцию закрытия.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, для которого подключение будет разорвано.
    

deactivate

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

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

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

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

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

На устройствах AIR for TV это событие никогда не отправляется автоматически. Однако его можно отправить вручную.

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

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetЛюбой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события deactivate.
    

displayStateChange

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

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

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

Не изменяйте размер окна или состояние его отображения в обработчике событий displayStateChange.

Задает значение свойства type для объекта события displayStateChange.

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

СвойстваЗначения
afterDisplayStateСтарое состояние отображения окна.
beforeDisplayStateНовое состояние отображения окна.
targetЭкземпляр NativeWindow, который только что изменил состояние.
bubblesНет.
currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
cancelablefalse; нет поведения по умолчанию для отмены.
    

displayStateChanging

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

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

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

Задает значение свойства type для объекта события displayStateChanging.

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

СвойстваЗначения
afterDisplayStateСостояние отображения окна до ожидаемого изменения.
beforeDisplayStateСостояние отображения окна после ожидаемого изменения.
targetЭкземпляр NativeWindow, который только что изменил состояние.
bubblesНет.
currentTargetУказывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
cancelabletrue; отмена события предотвратит изменение.

Пример  ( Использование этого примера )

Следующий пример иллюстрирует отмену события displayStateChanging.
function displayStateChanging_handler(displayStateEvent:NativeWindowDisplayStateEvent):void
{
  //shouldStopStateChange is an application-defined Boolean indicating 
  //that display state changes should be canceled
  if (displayStateEvent.type == NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING 
                                  &&    shouldStopStateChange)
  {
    displayStateEvent.preventDefault();
  }
}
    

move

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

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

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

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

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

Задает значение свойства type для объекта события move.

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

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

moving

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

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

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

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

Задает значение свойства type для объекта события moving.

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

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

Примечание. В ОС Linux для этого события не поддерживается метод preventDefault().

    

resize

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

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

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

Задает значение свойства type для объекта события Resize.

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

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

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

    

resizing

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

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

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

Задает значение свойства type для объекта события resizing.

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

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

Примечание. В ОС Linux для этого события не поддерживается метод preventDefault().


Пример  ( Использование этого примера )

Следующий пример иллюстрирует отмену события resizing.
function boundsChanging_handler(boundsEvent:NativeWindowBoundsEvent):void
{
  //shouldStopResize is an application-defined Boolean indicating 
  //that resize operations should be canceled
  if (boundsEvent.type == NativeWindowBoundsEvent.RESIZING && shouldStopResize)
  {
    boundsEvent.preventDefault();
  }
}




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.