ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: AIR 30.0 i wcześniejsze, Flash Player 30.0 i wcześniejsze, Flash Lite 4
Flex 4.6 i wcześniejsze, Flash Pro CS6 i wcześniejsze
Ukryj filtry
flash.display 

NativeWindow  - AS3

Pakietyx

Najwyższy poziom
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

Elementy językowe

Stałe globalne
Funkcje globalne
Operatory
Instrukcje, słowa kluczowe i dyrektywy
Typy specjalne

Dodatki

Nowości
Błędy kompilatora
Ostrzeżenia kompilatora
Błędy czasu wykonywania
Migracja kodu ActionScript 3
Obsługiwane zestawy znaków
Tylko MXML
Elementy XML dotyczące ruchu
Znaczniki tekstu z synchronizacją czasową
Przestarzały indeks
Stałe implementacji dostępności
Instrukcje dotyczące przykładów
Informacje prawne
Pakietflash.display
Klasapublic class NativeWindow
DziedziczenieNativeWindow Inheritance EventDispatcher Inheritance Object

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Klasa NativeWindow dostarcza interfejs do tworzenia i kontrolowania pulpitu macierzystego.

Obsługa profilów AIR: Ta funkcja jest obsługiwana we wszystkich systemach operacyjnych dla komputerów stacjonarnych, ale nie jest obsługiwana na urządzeniach przenośnych ani na urządzeniach telewizyjnych ze środowiskiem AIR. Obsługę tej funkcji można sprawdzić w czasie wykonywania na urządzeniach stacjonarnych, odczytując właściwość NativeWindow.isSupported. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.

Odwołanie do instancji NativeWindow jest zwracane przez konstruktora okien. Do odwołania do instancji NativeWindow można również uzyskać dostęp za pomocą właściwości stage.nativeWindow dowolnego obiektu wyświetlanego na stole montażowym okna:

var window:NativeWindow = displayObject.stage.nativeWindow;

Dostęp do właściwości instancji NativeWindow posiada tylko zawartość aplikacji. Jeżeli zawartość inna niż aplikacji będzie starała się uzyskać dostęp do obiektu NativeWindow, zostanie zgłoszony błąd zabezpieczeń.

Zawartość może zostać dodana do okna za pomocą metod DisplayObjectContainer obiektu Stage, takich jak addChild().

Do listy wyświetlania instancji NativeWindow nie można bezpośrednio dodawać składników Flex. Zamiast tego należy użyć składników Flex mx:WindowedApplication i mx:Window w celu tworzenia okien i dodawania innych składników Flex jako obiektów podrzędnych tych obiektów. Zawartość SWF bazującą na Flex można dodawać bezpośrednio do okna NativeWindow, pod warunkiem że plik SWF jest ładowany do własnej domeny aplikacji oraz zawartości aplikacji.

Aby utworzyć okno główne HTML w celu wyświetlania treści HTML z reguły łatwiej tego dokonać przy użyciu metody HTMLLoader.createRootWindow(). Okna utworzone w ten sposób będą miały moduł HTMLLoader dodany automatycznie. (Z kodu JavaScript można również wykorzystać funkcję JavaScript window.open(). Jednak ta metoda zapewnia mniejszą kontrolę nad wyglądem i działaniem okna).

Następujące operacje na obiektach NativeWindow są asynchroniczne: close(), maximize(), minimize(), restore() oraz bounds zmieniają się. Aplikacja jest w stanie wykryć, kiedy te operacje zostały zakończone, poprzez wykrywanie odpowiednich zdarzeń.

Jeżeli właściwość NativeApplication.autoExit ma wartość true, która jest domyślna, wówczas aplikacja zostanie zamknięta po zamknięciu ostatniego okna (oraz gdy wszystkie moduły obsługi zdarzeń close zostały zwrócone). Jeżeli parametr autoExit ma wartość false, wówczas metoda NativeApplication.nativeApplication.exit() musi zostać wywołana w celu zamknięcia aplikacji.

Obiekty NativeWindow nie będą poddawane zbieraniu elementów niepotrzebnych po wywołaniu konstruktora okien oraz przed wywołaniem metody close(). Aplikacja jest odpowiedzialna za zamknięcie własnych okien.

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
      active : Boolean
[tylko do odczytu] Wskazuje czy to okno jest oknem aktywnej aplikacji.
NativeWindow
      alwaysInFront : Boolean
Określa, czy to okno zawsze będzie znajdować się na przedzie pozostałych okien (włączając okna innych aplikacji).
NativeWindow
      bounds : Rectangle
Wielkość i położenie tego okna.
NativeWindow
      closed : Boolean
[tylko do odczytu] Wskazuje czy okno zostało zamknięte.
NativeWindow
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
      displayState : String
[tylko do odczytu] Stan wyświetlania okna.
NativeWindow
      height : Number
Wysokość tego okna w pikselach.
NativeWindow
      isSupported : Boolean
[statyczny] [tylko do odczytu] Wskazuje, czy w systemie klienckim są obsługiwane okna natywne.
NativeWindow
      maximizable : Boolean
[tylko do odczytu] Raportuje ustawienie możliwości maksymalizacji, wykorzystane przy utworzeniu tego okna.
NativeWindow
      maxSize : Point
Rozmiar maksymalny dla tego okna.
NativeWindow
      menu : NativeMenu
Macierzyste menu dla tego okna.
NativeWindow
      minimizable : Boolean
[tylko do odczytu] Informuje o ustawieniu możliwości minimalizacji użytym podczas tworzenia tego okna.
NativeWindow
      minSize : Point
Rozmiar minimalny dla tego okna.
NativeWindow
      owner : NativeWindow
[tylko do odczytu] Obiekt NativeWindow posiadający to okno.
NativeWindow
      renderMode : String
[tylko do odczytu] Zwraca ustawienie renderMode okna użyte przy tworzeniu tego okna.
NativeWindow
      resizable : Boolean
[tylko do odczytu] Raportuje ustawienie możliwości zmiany rozmiaru, wykorzystane przy utworzeniu tego okna.
NativeWindow
      stage : Stage
[tylko do odczytu] Obiekt Stage dla tego okna.
NativeWindow
      supportsMenu : Boolean
[statyczny] [tylko do odczytu] Wskazuje czy aplikacja AIR obsługuje menu okna macierzystego na obecnym systemie komputerowym.
NativeWindow
      supportsNotification : Boolean
[statyczny] [tylko do odczytu] Wskazuje czy aplikacja AIR obsługuje sygnalizację powiadomień okna na obecnym systemie komputerowym.
NativeWindow
      supportsTransparency : Boolean
[statyczny] [tylko do odczytu] Wskazuje, czy AIR obsługuje okna rodzime z pikselami przezroczystymi.
NativeWindow
      systemChrome : String
[tylko do odczytu] Informuje o ustawieniu możliwości użycia karnacji systemowej użytym podczas tworzenia tego okna.
NativeWindow
      systemMaxSize : Point
[statyczny] [tylko do odczytu] Największy rozmiar okna dozwolony przez system operacyjny.
NativeWindow
      systemMinSize : Point
[statyczny] [tylko do odczytu] Najmniejszy rozmiar okna dozwolony przez system operacyjny.
NativeWindow
      title : String
Tytuł okna.
NativeWindow
      transparent : Boolean
[tylko do odczytu] Informuje o ustawieniu przezroczystości użytym podczas tworzenia tego okna.
NativeWindow
      type : String
[tylko do odczytu] Raportuje ustawienie typu okna, wykorzystane przy utworzeniu tego okna.
NativeWindow
      visible : Boolean
Określa, czy okno jest widoczne.
NativeWindow
      width : Number
Szerokość tego okna w pikselach.
NativeWindow
      x : Number
Współrzędna osi poziomej górnego lewego rogu tego okna względem początku pulpitu systemu operacyjnego.
NativeWindow
      y : Number
Współrzędna osi pionowej górnego lewego rogu tego okna względem górnego lewego rogu pulpitu systemu operacyjnego.
NativeWindow
Metody publiczne
 MetodaZdefiniowane przez
  
Tworzy nową instancję NativeWindow oraz odpowiadające okno systemu operacyjnego.
NativeWindow
  
    activate():void
Aktywuje to okno.
NativeWindow
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.
EventDispatcher
  
    close():void
Zamyka to okno.
NativeWindow
 Inherited
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.
EventDispatcher
  
    globalToScreen(globalPoint:Point):Point
Konwertuje punkt we współrzędnych pikseli względem źródła stołu montażowego okna (punkt globalny w pojęciu listy wyświetlania), do punktu na pulpicie wirtualnym.
NativeWindow
 Inherited
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.
EventDispatcher
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
  
Zwraca listę obiektów NativeWindow posiadanych przez to okno.
NativeWindow
  
    maximize():void
Maksymalizuje okno.
NativeWindow
  
    minimize():void
Minimalizuje okno.
NativeWindow
  
    notifyUser(type:String):void
Wywołuje sygnalizację wizualną w systemie operacyjnym, która informuje o tym, że wystąpiło ważne zdarzenie.
NativeWindow
  
Wysyła to okno bezpośrednio za określone okno.
NativeWindow
  
Przesuwa to okno bezpośrednio na przód wybranego okna.
NativeWindow
  
Wysyła to okno pod inne widoczne okna.
NativeWindow
  
Przesuwa to okno na przód pozostałych widocznych okien.
NativeWindow
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Usuwa detektor z obiektu EventDispatcher.
EventDispatcher
  
    restore():void
Przywraca to okno do stanu zminimalizowanego lub zmaksymalizowanego.
NativeWindow
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
  
    startMove():Boolean
Rozpoczyna przesunięcie okna kontrolowane przez system.
NativeWindow
  
    startResize(edgeOrCorner:String = "BR"):Boolean
Rozpoczyna operację zmiany rozmiaru okna, kontrolowaną przez system.
NativeWindow
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
 Inherited
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.
EventDispatcher
Zdarzenia
 Zdarzenie Podsumowanie Zdefiniowane przez
  
    activate
Wywołane przez ten obiekt NativeWindow po aktywacji okna.NativeWindow
  
    close
Wywołane przez ten obiekt NativeWindow po zamknięciu okna.NativeWindow
  
    closing
Wywołane przez ten obiekt NativeWindow tuż przed zamknięciem okna.NativeWindow
  
    deactivate
Wywołane przez ten obiekt NativeWindow po dezaktywacji okna.NativeWindow
  Wywołane przez ten obiekt NativeWindow po zmianie właściwości displayState okna.NativeWindow
  Wywołane przez ten obiekt NativeWindow tuż przed zmianą stanu wyświetlania okna.NativeWindow
  
    move
Wywołane przez ten obiekt NativeWindow po przesunięciu okna na pulpit.NativeWindow
  
    moving
Wywołane przez ten obiekt NativeWindow tuż przed przesunięciem okna na pulpit.NativeWindow
  
    resize
Wywołane przez ten obiekt NativeWindow po zmianie rozmiaru okna.NativeWindow
  
    resizing
Wywołane przez ten obiekt NativeWindow tuż przed zmianą rozmiarów okna na pulpicie.NativeWindow
Szczegół właściwości
    

active

właściwość
active:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Wskazuje, czy to okno jest oknem aktywnej aplikacji.

Należy użyć metody activate() w celu aktywacji okna.



Implementacja
    public function get active():Boolean

Powiązane elementy interfejsu API

    

alwaysInFront

właściwość 
alwaysInFront:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Określa, czy to okno zawsze będzie znajdować się na przedzie względem pozostałych okien (włączając okna innych aplikacji).

Istnieją dwie grupy okien w kolejności głębokości systemu. Okna znajdujące się w grupie alwaysInFront są zawsze wyświetlane z przodu pozostałych okien. Ustawianie kolejności głębokości okien wewnątrz tej samej grupy jest określone normalnie. Innymi słowy aktywacja okna przeniesie je na przód pozostałych okien w grupie.

Zmiana właściwości alwaysInFront z false na true spowoduje przeniesienie okna na wierzch wszystkich innych okien. Zmiana właściwości z true na false spowoduje wysłanie okna do tyłu okien o właściwości "alwaysInFront", ale wciąż z przodu pozostałych okien. Ustawienie właściwości na jej obecną wartość nie zmieni kolejności głębokości okna. Ustawienie właściwości alwaysInFront okna mającego właściciela nie ma żadnych skutków.

Wartość true dla właściwości alwaysInFront powinna być stosowana sporadycznie, ponieważ okna, dla których określono to ustawienie, będą widoczne przed oknami innych aplikacji, nawet jeśli aktywne są inne aplikacje.

Uwagi o zachowaniu systemu operacyjnego:

  • Niektóre menedżery okien w systemie Linux nie wyświetlają okien z ustawioną właściwością alwaysInFront przed oknami w trybie pełnoekranowym.
  • W systemie operacyjnym Mac® OS X ustawienie alwaysInFront o wartości true nie odniesie skutku, gdy właściwość displayState stołu montażowego okna ma wartość fullScreen lub fullScreenInteractive.



Implementacja
    public function get alwaysInFront():Boolean
    public function set alwaysInFront(value:Boolean):void

Przykład  ( Sposób korzystania z tego przykładu )
W poniższych przykładach następuje wymuszenie wyświetlania okna nad wszystkimi pozostałymi oknami (z wyjątkiem tych, dla których także wymuszono wyświetlanie nad pozostałymi):
windowObj.alwaysInFront = true;
Przez odwołanie do obiektu wyświetlanego na stole montażowym okna:
displayObject.stage.nativeWindow.alwaysInFront=true;
Z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie głównym HTML):
window.nativeWindow.alwaysInFront = true;
    

bounds

właściwość 
bounds:Rectangle

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Wielkość i położenie tego okna.

Przy określaniu wymiarów okna uwzględniana jest karnacja systemu. Wymiary stołu montażowego okna są równe rozmiarom okna, minus rozmiary karnacji systemu. Zmiana szerokości i wysokości okna zmieni parametry stageWidth i stageHeight stołu montażowego. Mechanizm działa również w kierunku przeciwnym: zmiana wymiarów stołu montażowego zmieni rozmiar okna.

W oknie głównym HTML właściwości outerWidth i outerHeigth są odpowiednikami właściwości height i width okna. Właściwości innerWidth i innerHeight są równe właściwościom stage.stageWidth i stage.stageHeight minus grubość wszelkich automatycznych pasków przewijania wyświetlonych przez okno.

Zdarzenie resize jest wywoływane za każdym razem, gdy szerokość i wysokość tego okna jest zmieniana. I podobnie — zdarzenie move jest wywoływane zawsze, gdy zmianie ulega położenie początku (x,y) okna. W systemach Mac OS i Windows bezpośrednie ustawienie właściwości bounds nie spowoduje wywołania zdarzenia moving ani resizing. Jednak w systemie Linux obiekt NativeWindow wywołuje zdarzenia moving i resizing po ustawieniu właściwości bounds.

Ustawienie właściwości bounds okna jest odpowiednikiem ustawienia właściwości x, y, width oraz height. I podobnie — ustawienie dowolnego wymiaru jest równoważne ustawieniu właściwości bounds. Jeśli wszystkie wymiary są ustawiane jednocześnie za pomocą właściwości bounds, wywoływana jest mniejsza liczba zdarzeń.

Kolejność ustawiania poszczególnych wymiarów nie jest gwarantowana. W menedżerach okien systemu Linux, które nie zezwalają na to, by część okna znajdowała się poza pulpitem, zmiana określonej właściwości może być zablokowana nawet wówczas, gdy łączny skutek wszystkich zmian właściwości doprowadziłby do uzyskania poprawnego okna.

Jeśli podana szerokość lub wysokość będzie mniejsza od minimalnej lub większa od maksymalnej dozwolonej wartości, wówczas szerokość lub wysokość okna zostanie ustawiona na najbliższą jej wartość dozwoloną. Czynniki, od których zależy minimalna i maksymalna szerokość i wysokość, to:

  • Wartość właściwości minSize i maxSize obiektu NativeWindow.
  • Ograniczenia systemu operacyjnego, czyli wartości właściwości NativeWindow.systemMinSize i NativeWindow.systemMaxSize.
  • Maksymalna szerokość i wysokość okna w środowisku Adobe AIR, która wynosi 4095 pikseli. (W wersji AIR 1.5 i wersjach wcześniejszych maksymalna szerokość i wysokość okna wynosi 2880 pikseli).
  • Minimalna szerokość i wysokość wymagana przez aktualną karnację systemową.

W przypadku zmiany położenia lub wymiarów okna wartości pikseli są zaokrąglane do najbliższej liczby całkowitej.



Implementacja
    public function get bounds():Rectangle
    public function set bounds(value:Rectangle):void

Zgłasza
ArgumentError — Jeżeli prostokąt ma wartość null lub zawiera niepoprawne wartości.
 
IllegalOperationError — Jeżeli przeprowadzono próbę uzyskania dostępu do właściwości granic po zamknięciu okna.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
W poniższym przykładzie granice okna ustawiane są poprzez odwołanie do obiektu NativeWindow:
windowObj.bounds = new Rectangle(200, 200, 1000, 800);
Przez odwołanie do obiektu wyświetlanego na stole montażowym okna:
displayObject.stage.nativeWindow.bounds = new Rectangle(20, 20, 800, 600);
Z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie głównym HTML):
window.nativeWindow.bounds = new air.Rectangle(20, 20, 800, 600);
    

closed

właściwość 
closed:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Wskazuje, czy okno zostało zamknięte.

Uzyskanie dostępu do następujących właściwości w przypadku zamknięcia okna spowoduje zgłoszenie błędu niepoprawnej operacji:

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

I podobnie — wywołanie następujących metod w zamkniętym oknie również spowoduje wywołanie błędu niepoprawnej operacji:

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



Implementacja
    public function get closed():Boolean

Przykład  ( Sposób korzystania z tego przykładu )
Poniższe przykłady ilustrują dostęp do właściwości closed okna:
var isWindowClosed:Boolean = windowObj.closed;
Przez odniesienie do obiektu ekranowego na stole montażowym okna:
var isWindowClosed:Boolean = displayObject.stage.nativeWindow.closed;
Z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie głównym HTML):
var isWindowClosed = window.nativeWindow.closed;
    

displayState

właściwość 
displayState:String  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Stan wyświetlania okna.

Stałe możliwych wartości są zdefiniowane w klasie NativeWindowDisplayState:

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



Implementacja
    public function get displayState():String

Zgłasza
IllegalOperationError — Jeśli uzyskano dostęp do właściwości displayState po zamknięciu tego okna.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje odczytywanie bieżącego stanu wyświetlania okna, gdy znane jest odwołanie do obiektu okna:
var state:String = windowObj.displayState;
    

height

właściwość 
height:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Wysokość tego okna w pikselach.

Przy określaniu wymiarów okna uwzględniana jest wyświetlana karnacja okna systemu. Wysokość obszaru wyświetlania możliwego do użycia jest dostępna we właściwości Stage.stageHeight.

Zmiana właściwości height okna jest odpowiednikiem zmiany wysokości przez właściwość bounds.

Jeśli podana wysokość będzie mniejsza od minimalnej lub większa od maksymalnej dozwolonej wartości, wówczas wysokość okna zostanie ustawiona na najbliższą jej wartość dozwoloną. Czynniki, od których zależy minimalna i maksymalna wysokość, to:

  • Wartości właściwości minSize.x i maxSize.x obiektu NativeWindow.
  • Ograniczenia systemu operacyjnego, czyli wartości właściwości NativeWindow.systemMinSize.x i NativeWindow.systemMaxSize.x.
  • Maksymalna wysokość okna w środowisku Adobe AIR wynosi 4095 pikseli (2880 pikseli w wersji AIR 1.5 i wersjach wcześniejszych).

W systemie Linux ustawianie właściwości height jest operacją asynchroniczną.

Aby wykryć zakończenie zmiany wysokości, należy wykrywać zdarzenie resize, które jest wywoływane na wszystkich platformach.

W przypadku zmiany wysokości okna wartości pikseli są zaokrąglane do najbliższej liczby całkowitej.



Implementacja
    public function get height():Number
    public function set height(value:Number):void

Zgłasza
ArgumentError — Jeżeli ustawiona wartość wynosi null lub jest niepoprawna.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API

    

isSupported

właściwość 
isSupported:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 2.0

Wskazuje, czy natywne okna są obsługiwane na systemie klienckim.



Implementacja
    public static function get isSupported():Boolean
    

maximizable

właściwość 
maximizable:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Informuje o ustawieniu możliwości maksymalizacji użytym podczas tworzenia tego okna.

Ustawienie maximizable nie może zostać zmienione po utworzeniu okna.

Uwaga: Niektóre menedżery okien w systemie Linux zezwalają na maksymalizowanie okien przez użytkownika, nawet jeśli wartością właściwości maximizable jest false.



Implementacja
    public function get maximizable():Boolean

Zgłasza
SecurityError — W przypadku próby ustawienia wartości na false bez posiadania wystarczających uprawnień.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API

    

maxSize

właściwość 
maxSize:Point

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Rozmiar maksymalny dla tego okna.

Limit rozmiaru jest określony jako współrzędne obiektu Point. Właściwość x punktu odpowiada szerokości okna, natomiast właściwość y jego wysokości.

Ograniczenie maxSize jest narzucone dla operacji zmiany wielkości okien wywoływanych za pośrednictwem kodu ActionScript oraz systemu operacyjnego.

Ustawienie właściwości maxSize spowoduje zmianę granic okna, jeżeli obecne granice są większe niż nowy rozmiar maksymalny.

Jeśli podana szerokość lub wysokość będzie większa od maksymalnej dozwolonej wartości, wówczas szerokość lub wysokość okna zostanie ustawiona na najbliższą jej wartość dozwoloną. Czynniki, od których zależy minimalna i maksymalna szerokość i wysokość:

  • Ograniczenie systemu operacyjnego, czyli wartość właściwości NativeWindow.systemMaxSize.
  • Maksymalna szerokość i wysokość okna w środowisku Adobe AIR, która wynosi 4095 pikseli. (W wersji AIR 1.5 i wersjach wcześniejszych maksymalna szerokość i wysokość okna wynosi 2880 pikseli).

Uwaga: W niektórych systemach operacyjnych, takich jak Mac OS X, maksymalizacja okna spowoduje powiększenie go tylko do wartości maxSize, nawet jeśli tak powiększone okno będzie mniejsze od ekranu systemu operacyjnego. Okno wciąż będzie w stanie zmaksymalizowanego wyświetlania.



Implementacja
    public function get maxSize():Point
    public function set maxSize(value:Point):void

Zgłasza
IllegalOperationError — Jeżeli przypisany rozmiar nie znajduje się pomiędzy minimalnym a maksymalnym rozmiarem okna dla systemu operacyjnego.
 
SecurityError — Jeżeli rozmiar jest zabroniony dla obecnych uprawnień zawartości.
 
ArgumentError — Jeżeli rozmiar ma wartość null lub zawiera niepoprawne wartości.
 
IllegalOperationError — Jeśli uzyskano dostęp do właściwości maxSize po zamknięciu tego okna.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższe przykłady ilustrują ustawianie maksymalnego dozwolonego rozmiaru okna:
windowObj.maxSize = new Point(1040,920);
Przez odniesienie do obiektu ekranowego na stole montażowym okna:
displayObject.stage.nativeWindow.maxSize = new Point(800,600);
Z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie głównym HTML):
window.nativeWindow.maxSize = new air.Point(960,960);
    

menu

właściwość 
menu:NativeMenu

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Natywne menu dla tego okna.

Kiedy obiekt NativeMenu jest przypisany do właściwości okna menu, wówczas macierzyste menu zostanie wyświetlone dla okna, jeżeli właściwość NativeWindow.supportsMenu ma wartość true, chyba że właściwość systemChrome ma wartość NativeWindowSystemChrome.NONE.

Uwaga: Przypisanie menu do okna, gdy właściwość NativeWindow.supportsMenu ma wartość false, lub gdy właściwość okna systemChrome ma wartość NativeWindowSystemChrome.NONE jest dozwolone, lecz nie funkcjonuje. W celu ustalenia, czy system operacyjny obsługuje menu okien, należy koniecznie skorzystać z właściwości NativeWindow.supportsMenu. Użycie innych sposobów (na przykład właściwości Capabilities.os) do określenia możliwości obsługi może prowadzić do błędów programowania (jeśli niektóre docelowe systemy operacyjne nie zostaną uwzględnione).



Implementacja
    public function get menu():NativeMenu
    public function set menu(value:NativeMenu):void

Powiązane elementy interfejsu API

    

minimizable

właściwość 
minimizable:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Raportuje ustawienie możliwości minimalizacji, wykorzystane przy utworzeniu tego okna.

Ustawienie minimizable nie może zostać zmienione po utworzeniu tego okna.

Uwaga: Niektóre menedżery okien w systemie Linux zezwalają na maksymalizowanie okien przez użytkownika, nawet jeśli wartością właściwości minimizable jest false.



Implementacja
    public function get minimizable():Boolean

Zgłasza
SecurityError — W przypadku próby ustawienia wartości na false bez posiadania wystarczających uprawnień.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API

    

minSize

właściwość 
minSize:Point

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Rozmiar minimalny dla tego okna.

Limit rozmiaru jest określony jako współrzędne obiektu Point. Właściwość x punktu odpowiada szerokości okna, natomiast właściwość y jego wysokości.

Ustawienie właściwości minSize spowoduje zmianę granic okna, jeżeli obecne granice są mniejsze niż nowy rozmiar minimalny.

Ograniczenie minSize jest narzucone dla operacji zmiany wielkości okien wywoływanych za pośrednictwem kodu ActionScript oraz systemu operacyjnego.

Uwaga: Szerokość i wysokość dowolnej wyświetlonej karnacji systemu może uniemożliwić ustawienie okna na rozmiar tak mały, jak określony przez rozmiar minimalny.



Implementacja
    public function get minSize():Point
    public function set minSize(value:Point):void

Zgłasza
IllegalOperationError — Jeżeli przypisany rozmiar nie znajduje się pomiędzy minimalnym a maksymalnym rozmiarem okna dla systemu operacyjnego.
 
SecurityError — Jeżeli rozmiar jest zabroniony dla obecnych uprawnień zawartości.
 
ArgumentError — Jeżeli rozmiar ma wartość null lub zawiera niepoprawne wartości.
 
IllegalOperationError — Jeśli uzyskano dostęp do właściwości minSize po zamknięciu tego okna.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższe przykłady ilustrują ustawianie minimalnego dozwolonego rozmiaru okna:
windowObj.minSize = new Point(200,80);
Przez odniesienie do obiektu ekranowego na stole montażowym okna:
displayObject.stage.nativeWindow.minSize = new Point(120,60);
Z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie głównym HTML):
window.nativeWindow.minSize = new air.Point(80,60);
    

owner

właściwość 
owner:NativeWindow  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 2.6

Obiekt NativeWindow posiadający to okno.

Prawo własności do okna jest ustalane podczas tworzenia okna i nie można go zmieniać. Aby utworzyć okno mające właściciela, należy ustawić będący właścicielem obiekt NativeWindow jako właściwość owner obiektu NativeWindowInitOptions użytego do utworzenia posiadanego okna.

Uwaga: W systemie Linux niektóre menedżery okien nie wyświetlają posiadanych okien z przodu okna będącego właścicielem, gdy okno będące właścicielem działa w trybie pełnoekranowym.



Implementacja
    public function get owner():NativeWindow

Powiązane elementy interfejsu API

    

renderMode

właściwość 
renderMode:String  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 3.0

Zwraca ustawienie renderMode okna użyte przy tworzeniu tego okna.

Wartość zwrócona przez właściwość NativeWindow.renderMode będzie jedną ze stałych zdefiniowanych w klasie NativeWindowRenderMode.

Ustawienia renderMode nie można zmienić po utworzeniu okna.



Implementacja
    public function get renderMode():String

Zgłasza
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API

    

resizable

właściwość 
resizable:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Informuje o ustawieniu możliwości zmiany rozmiaru użytym podczas tworzenia tego okna.

Ustawienie resizable nie może zostać zmienione po utworzeniu tego okna.



Implementacja
    public function get resizable():Boolean

Zgłasza
SecurityError — W przypadku próby ustawienia wartości na false bez posiadania wystarczających uprawnień.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API

    

stage

właściwość 
stage:Stage  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Obiekt Stage dla tego okna. Obiekt Stage jest głównym obiektem architektury listy wyświetlanej używanym w zawartości SWF bazującej na języku ActionScript 3.0.

Stół montażowy jest początkowym obiektem listy wyświetlania dla okna. Można dodać obiekty wyświetlane wizualnego do okna poprzez dodanie ich do stołu montażowego lub innego obiektu, który jest już na liście wyświetlania tego stołu. Wymiary stołu montażowego są takie same, jak obszaru klienta okna, gdy okno wykorzystuje karnację systemu. Wymiary stołu montażowego są równe wymiarom okna, jeżeli karnacja systemu nie jest stosowana.



Implementacja
    public function get stage():Stage

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje ustawianie właściwości stołu montażowego dla instancji klasy NativeWindow:
import flash.display.StageAlign;

windowObj.stage.align = StageAlign.TOP_LEFT;
    

supportsMenu

właściwość 
supportsMenu:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Wskazuje, czy aplikacja AIR obsługuje natywne menu okien w obecnym systemie.

Jeśli właściwość NativeWindow.supportsMenu ma wartość true, wówczas menu natywne zostanie wyświetlone dla okna w momencie przypisania właściwości menu dla obiektu Nativemenu (chyba że właściwość systemChrome okna ma wartość NativeWindowSystemChrome.NONE). W celu ustalenia, czy system operacyjny obsługuje natywne menu okien, należy koniecznie skorzystać z właściwości NativeWindow.supportsMenu. Użycie innych sposobów (np. właściwości Capabilities.os) do określenia możliwości obsługi może prowadzić do błędów programowania (jeśli niektóre docelowe systemy operacyjne nie zostaną uwzględnione).

Uwaga: Przypisanie menu do okna, gdy właściwość NativeWindow.supportsMenu ma wartość false, lub gdy właściwość okna systemChrome ma wartość NativeWindowSystemChrome.NONE jest dozwolone, lecz nie funkcjonuje.



Implementacja
    public static function get supportsMenu():Boolean

Powiązane elementy interfejsu API

    

supportsNotification

właściwość 
supportsNotification:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Wskazuje, czy aplikacja AIR obsługuje sygnalizację powiadomień okna w obecnym systemie.

Kiedy właściwość NativeWindow.supportsNotification ma wartość true, wywoływanie metody notifyUser() okna będzie skutkować sygnalizacją wizualną dla użytkownika z informacją o tym, że wystąpiło ważne zdarzenie. Sygnalizacja wizualna będzie dostosowana do konwencji natywnego systemu operacyjnego. Na przykład: w systemie Windows® będzie migać ikona na pasku zadań.

Uwaga: wywoływanie metody notifyUser(), gdy właściwość NativeWindow.supportsNotification ma wartość false, jest dozwolone, ale nie przynosi żadnych widocznych skutków.



Implementacja
    public static function get supportsNotification():Boolean

Powiązane elementy interfejsu API

    

supportsTransparency

właściwość 
supportsTransparency:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.1

Wskazuje, czy środowisko AIR obsługuje okna natywne z pikselami przezroczystymi.

Jeśli parametr NativeWindow.supportsTransparency ma wartość true, będzie uwzględniana przezroczystość okna natywnego w pikselach, pod warunkiem że właściwość transparent ma wartość true. Przezroczystość wszystkich pikseli będzie ustawiona na 1, jeśli właściwość NativeWindow.supportsTransparency ma wartość false, bez względu na wartość właściwości transparent okna. Piksele całkowicie przezroczyste będą renderowane jako czarne, gdy właściwość NativeWindow.supportsTransparency ma wartość false. W celu ustalenia, czy system operacyjny obsługuje przezroczystość, należy koniecznie skorzystać z właściwości NativeWindow.supportsTransparency. Użycie innych sposobów (na przykład właściwości Capabilities.os) do określenia możliwości obsługi może prowadzić do błędów programowania (jeśli niektóre docelowe systemy operacyjne nie zostaną uwzględnione).

Uwaga: Wartość tej właściwości może ulec zmianie podczas działania aplikacji. Jest to uzależnione od preferencji użytkownika ustawionych w systemie operacyjnym.



Implementacja
    public static function get supportsTransparency():Boolean

Powiązane elementy interfejsu API

    

systemChrome

właściwość 
systemChrome:String  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Raportuje ustawienie karnacji systemu, wykorzystane przy utworzeniu tego okna.

Wartości zwrócone przez właściwość NativeWindow.systemChrome będą jednymi ze stałych zdefiniowanych w klasie NativeWindowSystemChrome.

Ustawienie karnacji systemu nie może zostać zmienione po utworzeniu okna.



Implementacja
    public function get systemChrome():String

Zgłasza
SecurityError — W przypadku próby ustawienia wartości na false bez posiadania wystarczających uprawnień.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje odczytywanie typu karnacji systemowej okna.
var sysChromeType:String = windowObj.systemChrome;
Przez odniesienie do obiektu ekranowego na stole montażowym okna:
var sysChromeType:String = displayObject.stage.nativeWindow.systemChrome;
Z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie głównym HTML):
var sysChromeType = window.nativeWindow.systemChrome;
Poniższy przykład ilustruje sposób zmiany widocznych ustawień karnacji systemowej i przezroczystości poprzez utworzenie nowego okna i przeniesienie wszystkich podrzędnych obiektów wyświetlanych do nowego okna:
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

właściwość 
systemMaxSize:Point  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Największy rozmiar okna dozwolony przez system operacyjny.

Limit rozmiaru jest określony jako współrzędne obiektu Point. Właściwość x punktu odpowiada szerokości okna, natomiast właściwość y jego wysokości.

Oprócz limitu rozmiaru, jaki definiuje system operacyjny, środowisko AIR określa limit maksymalnego rozmiaru okna wynoszący 4095 na 4095 pikseli (2880 na 2880 pikseli w wersji AIR 1.5 i wersjach wcześniejszych). Ponadto aplikacja może narzucić limit przy użyciu właściwości maxSize obiektu NativeWindow.



Implementacja
    public static function get systemMaxSize():Point
    

systemMinSize

właściwość 
systemMinSize:Point  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Najmniejszy rozmiar okna dozwolony przez system operacyjny.

Limit rozmiaru jest określony jako współrzędne obiektu Point. Właściwość x punktu odpowiada szerokości okna, natomiast właściwość y jego wysokości.



Implementacja
    public static function get systemMinSize():Point
    

title

właściwość 
title:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Tytuł okna.

Jeżeli zajdzie konieczność wyświetlenia, wówczas tytuł pojawi się w karnacji systemu dla tego okna oraz innych lokalizacjach zależnych od systemu (na przykład pasek zadań).



Implementacja
    public function get title():String
    public function set title(value:String):void

Zgłasza
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Przykład  ( Sposób korzystania z tego przykładu )
W poniższym przykładzie ustawiany jest tytuł obiektu okna:
windowObj.title = "Window Title";
    

transparent

właściwość 
transparent:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Raportuje ustawienie przezroczystości, wykorzystane przy utworzeniu tego okna.

Właściwość transparent nie może zostać zmieniona po utworzeniu okna. Przezroczystość wpływa zarówno na wygląd wizualny okna oraz zachowanie myszy. W systemach Windows i Mac OS X okno nie będzie przechwytywać zdarzeń myszy, gdy wartość alpha piksela pod wskaźnikiem jest niższa od określonego progu, przedziale między 0,01 i 0,06, w zależności od systemu operacyjnego. W systemie Linux okno będzie przechwytywać zdarzenia myszy nawet nad obszarami całkowicie przezroczystymi, a tym samym użytkownicy nie będą mieli dostępu do innych okien ani elementów na pulpicie.

Uwaga: Przezroczystość okien nie zawsze jest obsługiwana. Jeśli konfiguracja systemu operacyjnego użytkownika uniemożliwia stosowanie przezroczystości, okno zostanie utworzone bez tego efektu. Obszary, które byłyby przezroczyste, będą w kompozycji traktowane jako czarne. Właściwość NativeWindow.supportsTransparency umożliwia określenie, czy przezroczystość okien jest obsługiwana.



Implementacja
    public function get transparent():Boolean

Zgłasza
SecurityError — W przypadku próby ustawienia wartości na false bez posiadania wystarczających uprawnień.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API

    

type

właściwość 
type:String  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Raportuje ustawienie type okna wykorzystane podczas tworzenia tego okna.

Wartości zwrócone przez właściwość NativeWindow.type będą jednymi ze stałych zdefiniowanych w klasie NativeWindowType.

Ustawienie type nie może zostać zmienione po utworzeniu okna.



Implementacja
    public function get type():String

Zgłasza
SecurityError — W przypadku próby ustawienia wartości na false bez posiadania wystarczających uprawnień.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API

    

visible

właściwość 
visible:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Określa, czy okno jest widoczne.

Okno niewidoczne nie jest wyświetlane na pulpicie, ale wszelkie właściwości i metody okna są poprawne.

Domyślnie właściwość visible jest ustawiona na false. W celu wyświetlenia okna należy ustawić właściwość visible na wartość true lub wywołać metodę NativeWindow.activate().

Jeśli dane okno ma właściciela, to stan widoczności okna będącego właścicielem określa, czy dane okno jest wyświetlane. Jeśli dane okno nie jest wyświetlane, to nie są wyświetlane żadne okna, których jest ono właścicielem — nawet jeśli mają dla właściwości visible ustawioną wartość true.

Uwaga: W systemie operacyjnym Mac X, ustawienie właściwości visible=false przy zminimalizowanym oknie nie usunie ikony okna z doku. Jeżeli użytkownik ponownie kliknie ikonę doku, wówczas okno powróci do stanu widocznego i zostanie wyświetlone na pulpicie.



Implementacja
    public function get visible():Boolean
    public function set visible(value:Boolean):void

Zgłasza
SecurityError — W przypadku próby ustawienia wartości na false bez posiadania wystarczających uprawnień.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższe przykłady ilustrują dostęp do właściwości visible okna:
windowObj.visible = true;
Przez odniesienie do obiektu ekranowego na stole montażowym okna:
displayObj.stage.nativeWindow.visible = true;
Z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie głównym HTML):
window.nativeWindow.visible = true;
    

width

właściwość 
width:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Szerokość tego okna w pikselach.

Wymiary zgłaszane dla okna rodzimego zawierają dowolne karnacje okna systemu, jakie są wyświetlane. Szerokość obszaru wyświetlania możliwego do użycia jest dostępna we właściwości Stage.stageWidth.

Zmiana właściwości width okna jest odpowiednikiem zmiany szerokości przez właściwość bounds.

Jeśli podana szerokość będzie mniejsza od minimalnej lub większa od maksymalnej dozwolonej wartości, wówczas szerokość okna zostanie ustawiona na najbliższą jej wartość dozwoloną. Czynniki, od których zależy minimalna i maksymalna szerokość, to:

  • Wartości właściwości minSize.y i maxSize.y obiektu NativeWindow.
  • Ograniczenia systemu operacyjnego, czyli wartości właściwości NativeWindow.systemMinSize.y i NativeWindow.systemMaxSize.y.
  • Maksymalna szerokość okna w środowisku Adobe AIR wynosi 4095 pikseli (2880 pikseli w wersji AIR 1.5 i wersjach wcześniejszych).

W systemie Linux ustawianie właściwości width jest operacją asynchroniczną.

Aby wykryć zakończenie zmiany szerokości, należy wykrywać zdarzenie resize, które jest wywoływane na wszystkich platformach.

W przypadku zmiany szerokości okna wartości pikseli są zaokrąglane do najbliższej liczby całkowitej.



Implementacja
    public function get width():Number
    public function set width(value:Number):void

Zgłasza
ArgumentError — Jeżeli ustawiona wartość wynosi null lub jest niepoprawna.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API

    

x

właściwość 
x:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Współrzędna osi poziomej górnego lewego rogu tego okna względem początku układu współrzędnych pulpitu systemu operacyjnego.

W systemach, w których stosowana jest większa liczba monitorów, wartość x może być ujemna. Jeśli wartość zostanie zapisana — np. w celu przywrócenia okna do poprzedniego położenia, należy się zawsze upewnić, że okno zostało ustawione w użytecznym miejscu, gdy położenie zostanie przywrócone. Zmiany rozdzielczości ekranu lub ustawień monitora mogą spowodować przesunięcie okna poza ekran. W celu uzyskania informacji o geometrii pulpitu należy użyć klasy Screen.

Zmiana właściwości x okna jest odpowiednikiem zmiany położenia przez właściwość bounds.

W systemie Linux ustawianie właściwości x jest operacją asynchroniczną.

Aby wykryć zakończenie zmiany pozycji, należy wykrywać zdarzenie move, które jest wywoływane na wszystkich platformach.

W przypadku zmiany współrzędnej x okna wartości pikseli są zaokrąglane do najbliższej liczby całkowitej.



Implementacja
    public function get x():Number
    public function set x(value:Number):void

Zgłasza
ArgumentError — Jeżeli ustawiona wartość wynosi null lub jest niepoprawna.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API

    

y

właściwość 
y:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Współrzędna osi pionowej górnego lewego rogu tego okna względem górnego lewego rogu pulpitu systemu operacyjnego.

W systemach, w których stosowana jest większa liczba monitorów, wartość y może być ujemna. Jeśli wartość zostanie zapisana — np. w celu przywrócenia okna do poprzedniego położenia, należy się zawsze upewnić, że okno zostało ustawione w użytecznym miejscu, gdy położenie zostanie przywrócone. Zmiany rozdzielczości ekranu lub ustawień monitora mogą spowodować przesunięcie okna poza ekran. W celu uzyskania informacji o geometrii pulpitu należy użyć klasy Screen.

Zmiana właściwości y okna jest odpowiednikiem zmiany położenia przez właściwość bounds.

W systemie Linux ustawianie właściwości y jest operacją asynchroniczną.

Aby wykryć zakończenie zmiany pozycji, należy wykrywać zdarzenie move, które jest wywoływane na wszystkich platformach.

W przypadku zmiany współrzędnej y okna wartości pikseli są zaokrąglane do najbliższej liczby całkowitej.



Implementacja
    public function get y():Number
    public function set y(value:Number):void

Zgłasza
ArgumentError — Jeżeli ustawiona wartość wynosi null lub jest niepoprawna.
 
IllegalOperationError — Jeżeli wykonano próbę uzyskania dostępu po zamknięciu okna.

Powiązane elementy interfejsu API

Konstruktor Szczegół
    

NativeWindow

()Konstruktor
public function NativeWindow(initOptions:NativeWindowInitOptions)

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Tworzy nowe wystąpienie klasy NativeWindow oraz odpowiadające mu okno systemu operacyjnego.

Ustawienia zdefiniowane w parametrze initOptions nie mogą zostać zmienione po utworzeniu okna. Niepoprawne ustawienia initOptions spowodują zgłoszenie błędu dotyczącego niepoprawnej operacji. Ustawienia, które są prawidłowe ale nie są dostępne w bieżącym systemie, nie zgłoszą wyjątku. Opcje okna konkretne dla bieżącego systemu operacyjnego mogą zostać wykryte w razie potrzeby przy użyciu statycznych członków NativeWindow, jak na przykład systemMaxSize.

Domyślny rozmiar okna jest określany przez system operacyjny, a tworzone okna są niewidoczne. Aby nie dopuścić do tego, aby zmiany w oknie były widoczne, nie należy zmieniać właściwości visible okna na true ani wywoływać metody activate() do czasu zakończenia zmian okna.

Parametry
initOptions:NativeWindowInitOptions — Obiekt zawierający właściwości inicjalizujące dla tego okna.

Zgłasza
IllegalOperationError — Jeżeli parametr initOptions jest nieprawidłowy.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład tworzy i aktywuje nową instancję klasy 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();
Szczegół metody

    activate

()metoda
public function activate():void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Aktywuje to okno.

Aktywacja okna spowoduje:

  • Okno stanie się widoczne
  • Okno zostanie przesunięte na przód
  • Okno stanie się aktywne dla klawiatury i myszy

W systemie Linux metoda activate() jest wykonywana jako operacja asynchroniczna.

Obiekt NativeWindow wywołuje zdarzenie activate na wszystkich platformach.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższe przykłady ilustrują sposoby aktywowania okna:

Przez odniesienie do obiektu ekranowego na stole montażowym okna:

displayObject.stage.nativeWindow.activate();

Przez odwołanie do instancji klasy NativeWindow:
windowObj.activate();

Z kodu JavaScript na stronie HTML renderowanej w oknie (gdzie window jest globalnym obiektem okna JavaScript):
window.nativeWindow.activate();

    close

()metoda 
public function close():void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Zamyka to okno.

Zdarzenie close jest wywoływane tuż po zakończeniu operacji zamykania. Zdarzenie closing nie będzie wywoływane. W sytuacji gdy dozwolone jest anulowanie operacji zamykania, należy wywołać zdarzenie closing oraz sprawdzić, czy zarejestrowane detektory anulują domyślne zachowanie przed wywołaniem metody close().

W momencie zamknięcia okna zostają zamknięte wszystkie okna posiadane przez to okno. Posiadane okna nie wywołują zdarzeń closing.

Jeżeli do instancji obiektów wyświetlanych widocznych obecnie w oknie nie istnieją odwołania nigdzie indziej, zostaną one zebrane jako elementy niepotrzebne i zniszczone — z wyjątkiem wstępnego okna aplikacji utworzonego przez AIR. Aby umożliwić gromadzenie (niepotrzebnych) obiektów wyświetlanych w oknie początkowym, należy usunąć je ze stołu montażowego okna.

Po zamknięciu obiekt NativeWindow jest wciąż prawidłowym odwołaniem, ale próby uzyskania dostępu do większości właściwości i metod spowodują zgłoszenie błędu niepoprawnej operacji.

Okna zamknięte nie mogą być ponownie otworzone. Jeżeli okno jest już zamknięte, wówczas nie jest podejmowana żadna akcji ani nie są wywoływane zdarzenia.

Uwaga: aby ukryć okno, nie zamykając go, należy ustawić właściwość okna visible na wartość false.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższe przykłady ilustrują sposoby zamykania okna:

Przez odwołanie do instancji klasy NativeWindow (windowObj):

windowObj.close();


Przez odniesienie do obiektu ekranowego na stole montażowym okna:
displayObj.stage.nativeWindow.close();

Z procedury JavaScript działającej w obiekcie HTMLLoader (lub głównym oknie HTML):
window.close(); //overriddable in HTMLHost

Lub:
window.nativeWindow.close(); //not overriddable

Poniższy przykład ilustruje zezwolenie na anulowanie operacji zamykania (gdzie windowObj jest instancją klasy NativeWindow przeznaczoną do zamknięcia):
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;
    }
}

Poniższy przykład ilustruje zamknięcie okna z procedury JavaScript działającej w obiekcie HTMLLoader (lub oknie głównym HTML), z jednoczesnym zezwoleniem na anulowanie operacji:
<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

()metoda 
public function globalToScreen(globalPoint:Point):Point

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Konwertuje punkt we współrzędnych pikseli względem źródła stołu montażowego okna (punkt globalny w pojęciu listy wyświetlania), do punktu na pulpicie wirtualnym.

Współrzędne pulpitu wirtualnego są względne wobec górnego, lewego rogu głównego monitora.

Parametry

globalPoint:Point — Punkt na stole montażowym do konwersji na punkt na ekranie.

Zwraca
Point — Określony punkt globalny względem pulpitu.

Powiązane elementy interfejsu API

    listOwnedWindows

()metoda 
public function listOwnedWindows():Vector.<NativeWindow>

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 2.6

Zwraca listę obiektów NativeWindow posiadanych przez to okno.

Nie można zmieniać praw własności do obiektów NativeWindow przez dodawanie lub usuwanie obiektów ze zwróconego wektora. Po utworzeniu danego okna nie można zmieniać prawa własności do okna.

Zwraca
Vector.<NativeWindow> — Obiekt Vector.<NativeWindow> zawierający zero lub więcej obiektów NativeWindow, których to wystąpienie jest posiadaczem.

Powiązane elementy interfejsu API

    maximize

()metoda 
public function maximize():void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Maksymalizuje okno.

Wywołanie metody maximize()powoduje wywołanie zdarzenia displayStateChange oraz, jeśli to możliwe, zdarzenia move i resize. Karnacja systemu wywoła zdarzenie displayStateChanging, które może zostać anulowane gdy polecenie maksymalizacji jest wydane przez użytkownika, jednakże w takim przypadku logika maksymalizacji ustawiona przez użytkownika musi implementować takie zachowanie.

Metoda maximize() jest wykonywana asynchronicznie. Aby wykryć zakończenie zmiany stanu, należy wykrywać zdarzenie displayStateChange. Jeżeli okno jest już zmaksymalizowane, wówczas nie jest podejmowane żadne działanie ani nie są wywoływane zdarzenia.

Uwagi o zachowaniu systemu operacyjnego:

  • W systemach operacyjnych, jak np. Mac OS X, w którym maksymalizacja okna nie zapobiega zmianie jego rozmiarów, wywołanie metody maximize() spowoduje powiększenie okna w celu wypełnienia ekranu, ale nie uniemożliwi kolejnych zmian rozmiaru okna. Zmiana rozmiaru powiększonego okna przywróci również stan wyświetlania.
  • W niektórych systemach operacyjnych, takich jak Mac OS X, a także w niektórych menedżerach okien systemu Linux, maksymalizacja okna nie spowoduje powiększenia go ponad szerokość i wysokość określoną we właściwości maxSize. W innych systemach okno zostanie powiększone na cały ekran, nawet jeśli ekran jest większy niż maxSize.
  • Niektóre menedżery okien w systemie Linux nie zezwalają na maksymalizowanie okien narzędziowych.


Zgłasza
IllegalOperationError — Jeżeli ta metoda zostanie wywołana po zamknięciu okna.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zezwolenie na anulowanie operacji maksymalizacji:
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;
}

Poniższy przykład ilustruje zezwolenie na anulowanie operacji maksymalizacji z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie 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

()metoda 
public function minimize():void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Minimalizuje okno.

Wywołanie metody minimize()powoduje wywołanie zdarzenia displayStateChange oraz, jeśli to możliwe, zdarzenia move i resize. Karnacja systemu wywoła zdarzenie displayStateChanging, które może zostać anulowane, gdy użytkownik wyda polecenie minimalizacji. Jednak bezpośrednie wywoływanie metody minimize() tego nie spowoduje. Logika minimalizacji ustawiona przez użytkownika może zaimplementować takie zachowanie w razie potrzeby.

Metoda minimize() jest wykonywana asynchronicznie. Aby wykryć zakończenie zmiany stanu, należy wykrywać zdarzenie displayStateChange, które jest wywoływane na wszystkich platformach. Jeżeli okno jest już zminimalizowane, wówczas nie jest podejmowane żadne działanie ani nie są wywoływane zdarzenia.

Wszystkie okna posiadane przez to okno są ukrywane podczas jego minimalizowania. Posiadane okna nie wywołują zdarzeń displayStateChanging ani displayStateChange.

Uwagi:

  • W systemie Windows zminimalizowanie niewidocznego oka a(visible == false) spowoduje uwidocznienie okna.
  • Niektóre menedżery okien w systemie Linux nie zezwalają na minimalizowanie okien narzędziowych.


Zgłasza
IllegalOperationError — Jeżeli ta metoda zostanie wywołana po zamknięciu okna.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zezwolenie na anulowanie wywołania minimize() poprzez wywołanie zdarzenia 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;
}

Poniższy przykład ilustruje zezwolenie na anulowanie wywołania minimize() w kodzie JavaScript działającym w obiekcie HTMLLoader (lub oknie 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

()metoda 
public function notifyUser(type:String):void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Wywołuje sygnalizację wizualną w systemie operacyjnym, która informuje o tym, że wystąpiło ważne zdarzenie.

Gdy właściwość NativeWindow.supportsNotification ma wartość true, wówczas sygnalizacja wizualna będzie dostosowana do konwencji rodzimego systemu operacyjnego. Przykładowo w systemie Windows pasek zadań zacznie migać.

Parametr type określa intensywność sygnalizacji. Stałe dla dozwolonych wartości są zdefiniowane w klasie NotificationType i mogą to być:

  • NotificationType.INFORMATIONAL
  • NotificationType.CRITICAL

Sygnalizacje związane z powiadomieniami informacyjnymi trwają krótko; sygnalizacje związane z powiadomieniami krytycznymi będą trwały do momentu aktywacji okna przez użytkownika. Nie wszystkie menedżery okien systemu Linux obsługują dwa poziomy powiadomień. W przypadku takich menedżerów okien wywołanie metody notifyUser() odniesie zawsze taki sam skutek, niezależnie od wybranej opcji.

Uwaga: Wywoływanie metody notifyUser(), gdy właściwość NativeWindow.supportsNotification ma wartość false jest dozwolone, ale nie przynosi żadnych widocznych skutków.

Parametry

type:String — Ciąg znaków reprezentuje stopień ważności powiadomienia.

    orderInBackOf

()metoda 
public function orderInBackOf(window:NativeWindow):Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Wysyła to okno bezpośrednio za określone okno.

Nie aktywuje ani nie otrzymuje fokusu dla okna lub aplikacji. Okna zminimalizowane lub ukryte (wartość visible to false) nie mogą mieć zmienionej kolejności.

Posiadane okno nie może nigdy zostać umieszczone za swoim właścicielem. Jeśli to okno ma właściciela, wówczas następuje ustawienie właściciela i innych posiadanych przez niego okien również za oknem docelowym. Jeśli okno docelowe ma właściciela, wówczas to okno zostaje ustawione za właścicielem okna docelowego.

Niektóre menedżery okien systemu Linux nie zezwalają na umieszczanie okien narzędziowych za oknami zwykłymi.

Parametry

window:NativeWindow — Okno aplikacji.

Zwraca
Boolean — Wartość true w przypadku udanego przeniesienia na tył. Wartość false, jeżeli to okno jest niewidoczne lub zminimalizowane.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższe przykłady ilustrują przeniesienie okna bezpośrednio pod inne okno, przy wykorzystaniu odwołań do instancji NativeWindow:
windowBehind.orderInBackOf(windowFront);

Za pomocą odniesień do obiektów ekranowych na stołach montażowych okien:
displayObjBehind.stage.nativeWindow.orderInBackOf(displayObjectFront.stage.nativeWindow);


Z procedury JavaScript działającej w obiekcie HTMLLoader (lub w głównym oknie HTML) przy użyciu odwołań do dwóch obiektów okien JavaScript:
jsWindowObjBehind.nativeWindow.orderInBackOf(jsWindowObjFront.nativeWindow);

    orderInFrontOf

()metoda 
public function orderInFrontOf(window:NativeWindow):Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Przesuwa to okno bezpośrednio na przód wybranego okna.

Nie aktywuje ani nie otrzymuje fokusu dla okna lub aplikacji. Okna zminimalizowane lub ukryte (wartość visible to false) nie mogą mieć zmienionej kolejności.

Nigdy nie można ustawić okna przed oknem posiadanym przez dane okno. Jeśli to okno ma właściciela, wówczas następuje ustawienie właściciela i innych posiadanych przez niego okien również przed oknem docelowym. Jeśli okno docelowe ma właściciela, wówczas to okno zostaje również umieszczone przed innymi oknami mającymi tego samego właściciela co okno docelowe.

Niektóre menedżery okien w systemie Linux nie zezwalają na umieszczanie zwykłych okien nad oknami narzędziowymi.

Parametry

window:NativeWindow — Okno aplikacji.

Zwraca
Boolean — Wartość true w przypadku udanego przeniesienia na przód. Wartość false, jeżeli to okno jest niewidoczne lub zminimalizowane.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższe przykłady ilustrują przeniesienie okna bezpośrednio nad inne okno, przy wykorzystaniu odwołań do instancji NativeWindow:
windowFront.orderInFrontOf(windowBehind);

Przy wykorzystaniu odwołań do obiektów wyświetlanych na stołach montażowych okien:
displayObjFront.stage.nativeWindow.orderInFrontOf(displayObjectBehind.stage.nativeWindow);


Z procedury JavaScript działającej w obiekcie HTMLLoader (lub w głównym oknie HTML) przy użyciu odwołań do dwóch obiektów okien JavaScript:
jsWindowObjFront.nativeWindow.orderInFrontOf(jsWindowObjBehind.nativeWindow);

    orderToBack

()metoda 
public function orderToBack():Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Wysyła to okno pod inne widoczne okna.

Nie aktywuje ani nie otrzymuje fokusu dla tego okna lub aplikacji. Okna zminimalizowane lub ukryte (wartość visible to false) nie mogą mieć zmienionej kolejności.

Jeżeli dla wartości alwaysInFront ustawiono true, wówczas wywoływanie tej metody nie wyśle tego okna na tył innych okien, posiadających wartość alwaysInFront, dla której ustawiono false.

Posiadane okno nie może nigdy zostać umieszczone za swoim właścicielem. Jeśli to okno ma właściciela, wówczas następuje ustawienie właściciela i innych posiadanych przez niego okien również na spodzie listy wyświetlania okien. To okno zostanie przesunięte za wszystkie inne okna posiadane przez to samo okno. Jeśli to okno posiada inne okna, wówczas te okna zostaną przesunięte do tyłu z zachowaniem ich kolejności względem siebie.

Niektóre menedżery okien systemu Linux nie zezwalają na umieszczanie okien narzędziowych za oknami zwykłymi.

Zwraca
Boolean — Wartość true w przypadku udanego przeniesienia na tył. Wartość false, jeżeli to okno jest niewidoczne lub zminimalizowane.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje przeniesienie okna za wszystkie pozostałe okna w aplikacji (z tym samym ustawieniem alwaysInFront):
windowObj.orderToBack();


Przez odwołanie do obiektu wyświetlanego na stole montażowym okna:
displayObj.stage.nativeWindow.orderToBack();

Z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie głównym HTML):
window.nativeWindow.orderToBack();

    orderToFront

()metoda 
public function orderToFront():Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Przesuwa to okno na przód względem pozostałych widocznych okien.

Nie aktywuje ani nie otrzymuje fokusu dla tego okna lub aplikacji. Okna zminimalizowane lub ukryte (wartość visible to false) nie mogą mieć zmienionej kolejności.

Jeśli dla alwaysInFront ustawiono wartość false, wówczas wywołanie tej metody nie spowoduje wysłania tego okna na przód innych okien, dla których dla parametru alwaysInFront ustawiono wartość true.

Nigdy nie można ustawić okna przed oknem posiadanym przez dane okno. Jeśli to okno posiada inne okna, wówczas te okna zostaną przesunięte do przodu z zachowaniem ich kolejności względem siebie. Jeśli to okno ma właściciela, wówczas następuje ustawienie właściciela i wszystkich posiadanych przez niego okien również z przodu w kolejności wyświetlania okien. To okno zostaje przesunięte przed inne okna mające tego samego właściciela.

Niektóre menedżery okien w systemie Linux nie zezwalają na umieszczanie zwykłych okien nad oknami narzędziowymi.

Zwraca
Boolean — Wartość true w przypadku udanego przeniesienia na przód. Wartość false, jeżeli to okno jest niewidoczne lub zminimalizowane.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje przeniesienie okna przed wszystkie pozostałe okna w aplikacji (z tym samym ustawieniem alwaysInFront):
windowObj.orderToFront();


Przez odwołanie do obiektu wyświetlanego na stole montażowym okna:
displayObj.stage.nativeWindow.orderToFront();

Z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie głównym HTML):
window.nativeWindow.orderToFront();

    restore

()metoda 
public function restore():void

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Przywraca to okno ze stanu zminimalizowanego lub zmaksymalizowanego.

Wywołanie metody restore()powoduje wywołanie zdarzenia displayStateChange oraz, jeśli to możliwe, zdarzenia move i resize. Karnacja systemu wywoła zdarzenie displayStateChanging, które może zostać anulowane gdy polecenie przywracania jest wydane przez użytkownika, jednakże w takim przypadku logika przywracania ustawiona przez użytkownika musi implementować takie zachowanie.

Jeżeli okno jest już w stanie NativeWindowDisplayState.NORMAL,wówczas nie jest podejmowana żadna akcja ani nie są wywoływane zdarzenia.

Aby wykryć zakończenie zmiany stanu, należy wykrywać zdarzenie displayStateChange, które jest wywoływane na wszystkich platformach.


Zgłasza
IllegalOperationError — Jeżeli ta metoda zostanie wywołana po zamknięciu okna.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zezwolenie na anulowanie operacji przywracania:
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;
}

Poniższy przykład ilustruje zezwolenie na anulowanie operacji przywracania z procedury JavaScript działającej w obiekcie HTMLLoader w oknie (lub w oknie 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

()metoda 
public function startMove():Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Rozpoczyna przesunięcie okna kontrolowane przez system.

W przypadku wywołania ze zdarzenia mouseDown, ta metoda rozpoczyna się sekwencją przesuwania sterowaną myszą, która jest kontynuowana do momentu wystąpienia zdarzenia mouseUp.

W przypadku wywołania z innego kodu, ta metoda rozpoczyna się sekwencją przesuwania sterowaną klawiaturą lub myszą zgodną z domyślną sekwencją systemu operacyjnego.

W trakcie sekwencji przesuwania zostaną wywołane serie zdarzeń zgodnie z ruchem okna źródłowego. Dla każdego ruchu przyrostowego najpierw wywoływane jest zdarzenie moving, a następnie (jeżeli zdarzenie moving nie zostało anulowane) aktualizowane jest położenie okna oraz wywoływane jest zdarzenie typu move. Jeśli zdarzenie moving zostało anulowane, sekwencja przesuwania zostaje natychmiast zakończona.

Zwraca
Boolean — Wartość true w przypadku pomyślnego zainicjowania przeniesienia. Wartośćfalse, jeżeli okno jest zmaksymalizowane.

Zgłasza
IllegalOperationError — Jeżeli ta metoda zostanie wywołana po zamknięciu okna.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje przemieszczanie okna w odpowiedzi na zdarzenie 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

()metoda 
public function startResize(edgeOrCorner:String = "BR"):Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0

Rozpoczyna operację zmiany rozmiarów okna, kontrolowaną przez system.

W przypadku wywołania z modułu obsługi zdarzeń mouseDown, ta metoda rozpoczyna się sekwencją zmiany rozmiarów sterowaną myszą, która jest kontynuowana do momentu wystąpienia zdarzenia mouseUp.

W przypadku wywołania z innego kodu, ta metoda rozpoczyna się sekwencją zmiany rozmiarów sterowaną klawiaturą lub myszą, zgodną z domyślną sekwencją systemu operacyjnego.

W trakcie sekwencji zmiany rozmiarów zostaną wywołane serie zdarzeń zgodnie ze zmianą rozmiarów okna. Dla każdego ruchu przyrostowego najpierw wywoływane jest zdarzenie resizing, a następnie (jeżeli zdarzenie resizing nie zostało anulowane) aktualizowane jest położenie okna oraz wywoływane jest zdarzenie typu resize. Jeżeli zdarzenie resizing zostało anulowane, wówczas sekwencja zmiany rozmiarów zostaje natychmiast zakończona.

Parametry

edgeOrCorner:String (default = "BR") — Stała z klasy NativeWindowResize określa krawędź lub róg, których rozmiary należy zmienić. Poniżej podano prawidłowe wartości:

WartośćWyrównanie pionoweWyrównanie poziome
NativeWindowResize.TOPW góręDo środka
NativeWindowResize.BOTTOMW dółDo środka
NativeWindowResize.LEFTWyśrodkujW lewo
NativeWindowResize.RIGHTDo środkaW prawo
NativeWindowResize.TOP_LEFTGóraW lewo
NativeWindowResize.TOP_RIGHTW góręW prawo
NativeWindowResize.BOTTOM_LEFTDółW lewo
NativeWindowResize.BOTTOM_RIGHTW dółW prawo
NativeWindowResize.NONE----

Zwraca
Boolean — Wartość true w przypadku pomyślnego zainicjowania zmiany rozmiaru. Wartośćfalse, jeżeli okno jest zmaksymalizowane.

Zgłasza
IllegalOperationError — Jeżeli ta metoda zostanie wywołana po zamknięciu okna.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zmienianie rozmiaru okna w odpowiedzi na zdarzenie 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);    
}
Szczegół zdarzenia
    

activate

Zdarzenie
Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.ACTIVATE

Wersje środowiska wykonawczego: AIR 1.0

Wywołane przez ten obiekt NativeWindow po aktywacji okna.

Stała ACTIVATE definiuje wartość właściwości type obiektu zdarzenia activate.

Uwaga: to zdarzenie nie zawiera fazy „przechwytywania” ani „propagacji”, co oznacza, że detektory zdarzeń muszą być dodawane bezpośrednio do każdego potencjalnego obiektu docelowego — niezależnie od tego, czy obiekt znajduje się na liście wyświetlania.

To zdarzenie nie jest nigdy automatycznie wywoływane na urządzeniach telewizyjnych ze środowiskiem AIR. Można wywołać je ręcznie.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetDowolna instancja klasy DisplayObject z detektorem zarejestrowanym dla zdarzenia activate.
    

close

Zdarzenie  
Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.CLOSE

Wersje środowiska wykonawczego: AIR 1.0

Wywołane przez ten obiekt NativeWindow po zamknięciu okna.

Stała Event.CLOSE definiuje wartość właściwości type obiektu zdarzenia close.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt, którego połączenie zostało zamknięte.
    

closing

Zdarzenie  
Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.CLOSING

Wersje środowiska wykonawczego: AIR 1.0

Wywołane przez ten obiekt NativeWindow tuż przed zamknięciem okna. To zdarzenie może zostać anulowane, aby zapobiec zamknięciu okna.

Stała Event.CLOSING definiuje wartość właściwości type obiektu zdarzenia closing.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelabletrue; anulowanie tego zdarzenia zatrzymuje operację zamykania.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt, którego połączenie ma zostać zamknięte.
    

deactivate

Zdarzenie  
Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.DEACTIVATE

Wersje środowiska wykonawczego: AIR 1.0

Wywołane przez ten obiekt NativeWindow po dezaktywacji okna.

Stała Event.DEACTIVATE definiuje wartość właściwości type obiektu zdarzenia deactivate.

Uwaga: to zdarzenie nie zawiera fazy „przechwytywania” ani „propagacji”, co oznacza, że detektory zdarzeń muszą być dodawane bezpośrednio do każdego potencjalnego obiektu docelowego — niezależnie od tego, czy obiekt znajduje się na liście wyświetlania.

To zdarzenie nie jest nigdy automatycznie wywoływane na urządzeniach telewizyjnych ze środowiskiem AIR. Można wywołać je ręcznie.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetDowolna instancja klasy DisplayObject z detektorem zarejestrowanym dla zdarzenia deactivate.
    

displayStateChange

Zdarzenie  
Typ obiektu zdarzenia: flash.events.NativeWindowDisplayStateEvent
właściwość NativeWindowDisplayStateEvent.type = flash.events.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGE

Wersje środowiska wykonawczego: AIR 1.0

Wywołane przez ten obiekt NativeWindow po zmianie właściwości displayState okna.

Nie należy zmieniać rozmiaru okna ani jego stanu wyświetlania w funkcji obsługi zdarzenia displayStateChange.

Definiuje wartość właściwości type obiektu zdarzenia displayStateChange.

To zdarzenie ma następujące właściwości:

WłaściwościWartości
afterDisplayStateDotychczasowy stan wyświetlania okna.
beforeDisplayStateNowy stan wyświetlania okna.
targetInstancja NativeWindow, której stan właśnie uległ zmianie.
bubblesNie.
currentTargetOkreśla obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
    

displayStateChanging

Zdarzenie  
Typ obiektu zdarzenia: flash.events.NativeWindowDisplayStateEvent
właściwość NativeWindowDisplayStateEvent.type = flash.events.NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING

Wersje środowiska wykonawczego: AIR 1.0

Wywołane przez ten obiekt NativeWindow tuż przed zmianą stanu wyświetlania okna. Zdarzenie można anulować, aby zapobiec zmianie.

Definiuje wartość właściwości type obiektu zdarzenia displayStateChanging.

To zdarzenie ma następujące właściwości:

WłaściwościWartości
afterDisplayStateStan wyświetlania okna przed oczekującą zmianą.
beforeDisplayStateStan wyświetlania okna po oczekującej zmianie.
targetInstancja NativeWindow, której stan właśnie uległ zmianie.
bubblesNie.
currentTargetOkreśla obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
cancelabletrue; anulowanie zdarzenia uniemożliwi zmianę.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje sposób anulowania zdarzenia 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

Zdarzenie  
Typ obiektu zdarzenia: flash.events.NativeWindowBoundsEvent
właściwość NativeWindowBoundsEvent.type = flash.events.NativeWindowBoundsEvent.MOVE

Wersje środowiska wykonawczego: AIR 1.0

Wywołane przez ten obiekt NativeWindow po przesunięciu okna na pulpit.

Zdarzenie move jest wywoływane, gdy źródło (właściwości x lub y) okna ulegnie zmianie, co może się zdarzyć z powodu przesunięcia okna kontrolowanego przez system; minimalizacji, maksymalizacji, przywracania okna lub zmiany pozycji okna poprzez ustawienie właściwości x, y lub bounds.

Uwaga: Należy unikać akcji, które mogą otwierać jednocześnie okna dialogowe systemu operacyjnego w funkcjach modułu obsługi dla zdarzeń moving i move obiektu NativeWindow. Może się tak zdarzyć, gdy np. oba moduły obsługi zgłoszą błąd. Jeżeli do tego dojdzie, drugie otworzone okno dialogowe nie będzie rejestrowało kliknięć myszy i konieczne będzie jego zamknięcie za pomocą klawiatury.

Definiuje wartość właściwości type obiektu zdarzenia move.

To zdarzenie ma następujące właściwości:

WłaściwościWartości
afterBoundsNowe granice okna.
beforeBoundsDotychczasowe granice okna.
targetObiekt NativeWindow, którego stan właśnie uległ zmianie.
bubblesNie.
currentTargetOkreśla obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
    

moving

Zdarzenie  
Typ obiektu zdarzenia: flash.events.NativeWindowBoundsEvent
właściwość NativeWindowBoundsEvent.type = flash.events.NativeWindowBoundsEvent.MOVING

Wersje środowiska wykonawczego: AIR 1.0

Wywołane przez ten obiekt NativeWindow tuż przed przesunięciem okna na pulpit. Zdarzenie może zostać anulowane, aby zapobiec lub zmodyfikować przesunięcie.

Uwaga: Należy unikać akcji, które mogą otwierać jednocześnie okna dialogowe systemu operacyjnego w funkcjach modułu obsługi dla zdarzeń moving i move obiektu NativeWindow. Może się tak zdarzyć, gdy np. oba moduły obsługi zgłoszą błąd. Jeżeli do tego dojdzie, drugie otworzone okno dialogowe nie będzie rejestrowało kliknięć myszy i konieczne będzie jego zamknięcie za pomocą klawiatury.

Definiuje wartość właściwości type obiektu zdarzenia moving.

To zdarzenie ma następujące właściwości:

WłaściwościWartości
afterBoundsGranice okna po oczekującej zmianie.
beforeBoundsGranice okna przed oczekującą zmianą.
bubblesNie.
cancelabletrue; anulowanie zdarzenia uniemożliwi przemieszczenie okna.
currentTargetOkreśla obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt NativeWindow, którego stan właśnie uległ zmianie.

Uwaga: W systemie Linux metoda preventDefault() nie jest obsługiwana dla tego zdarzenia.

    

resize

Zdarzenie  
Typ obiektu zdarzenia: flash.events.NativeWindowBoundsEvent
właściwość NativeWindowBoundsEvent.type = flash.events.NativeWindowBoundsEvent.RESIZE

Wersje środowiska wykonawczego: AIR 1.0

Wywołane przez ten obiekt NativeWindow po zmianie rozmiaru okna. Zdarzenie resize jest wywoływane zawsze, gdy dojdzie do zmiany wielkości (właściwości width i height) okna, do której może dojść na skutek zmiany wielkości okna kontrolowanej przez system; minimalizowania, maksymalizowania lub przywracania okna; a także na skutek zmiany wielkości okna po ustawieniu właściwości width, height lub bounds. Zdarzenia NativeWindow resize są wywoływane podczas pętli zmiany wielkości kontrolowanych przez system. Natomiast zdarzenia resize obiektu Stage są wywoływane w momencie, gdy obiekt Stage jest gotowy do rysowania.

Definiuje wartość właściwości type obiektu zdarzenia resize.

To zdarzenie ma następujące właściwości:

WłaściwościWartości
afterBoundsNowe granice okna.
beforeBoundsDotychczasowe granice okna.
targetObiekt NativeWindow, którego stan właśnie uległ zmianie.
bubblesNie.
currentTargetOkreśla obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.

Powiązane elementy interfejsu API

    

resizing

Zdarzenie  
Typ obiektu zdarzenia: flash.events.NativeWindowBoundsEvent
właściwość NativeWindowBoundsEvent.type = flash.events.NativeWindowBoundsEvent.RESIZING

Wersje środowiska wykonawczego: AIR 1.0

Wywołane przez ten obiekt NativeWindow tuż przed zmianą rozmiarów okna na pulpicie. Zdarzenie może zostać anulowane, aby zapobiec lub zmodyfikować zmianę rozmiarów.

Definiuje wartość właściwości type obiektu zdarzenia resizing.

To zdarzenie ma następujące właściwości:

WłaściwościWartości
afterBoundsGranice okna po oczekującej zmianie.
beforeBoundsGranice okna przed oczekującą zmianą.
targetObiekt NativeWindow, którego stan właśnie uległ zmianie.
bubblesNie.
currentTargetOkreśla obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
cancelabletrue; anulowanie zdarzenia uniemożliwi przemieszczenie okna.

Uwaga: W systemie Linux metoda preventDefault() nie jest obsługiwana dla tego zdarzenia.


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje sposób anulowania zdarzenia 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 ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.