NativeWindow  - AS3

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

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

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

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

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

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

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

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

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

windowObj.alwaysInFront = true;

displayObject.stage.nativeWindow.alwaysInFront=true;

window.nativeWindow.alwaysInFront = true;

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

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

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

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

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

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

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

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

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

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

windowObj.bounds = new Rectangle(200, 200, 1000, 800);

displayObject.stage.nativeWindow.bounds = new Rectangle(20, 20, 800, 600);

window.nativeWindow.bounds = new air.Rectangle(20, 20, 800, 600);

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

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

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

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

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

var isWindowClosed:Boolean = windowObj.closed;

var isWindowClosed:Boolean = displayObject.stage.nativeWindow.closed;

var isWindowClosed = window.nativeWindow.closed;

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

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

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

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

var state:String = windowObj.displayState;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

windowObj.maxSize = new Point(1040,920);

displayObject.stage.nativeWindow.maxSize = new Point(800,600);

window.nativeWindow.maxSize = new air.Point(960,960);

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

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

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

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

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

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

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

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

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

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

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

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

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

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

windowObj.minSize = new Point(200,80);

displayObject.stage.nativeWindow.minSize = new Point(120,60);

window.nativeWindow.minSize = new air.Point(80,60);

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

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

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

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

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

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

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

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

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

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

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

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

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

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

import flash.display.StageAlign;

windowObj.stage.align = StageAlign.TOP_LEFT;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

var sysChromeType:String = windowObj.systemChrome;

var sysChromeType:String = displayObject.stage.nativeWindow.systemChrome;

var sysChromeType = window.nativeWindow.systemChrome;

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;
}

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

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

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

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

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

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

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

windowObj.title = "Window Title";

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

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

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

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

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

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

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

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

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

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

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

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

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

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

windowObj.visible = true;

displayObj.stage.nativeWindow.visible = true;

window.nativeWindow.visible = true;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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();

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

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

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

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

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

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

displayObject.stage.nativeWindow.activate();

windowObj.activate();

window.nativeWindow.activate();

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

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

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

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

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

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

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

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

windowObj.close();

displayObj.stage.nativeWindow.close();

window.close(); //overriddable in HTMLHost

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

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;
    }
}

<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>

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

public function maximizeWindow(nativeWin:NativeWindow):Boolean{
  if(nativeWin.displayState != NativeWindowDisplayState.MAXIMIZED){
    var beforeState:String = nativeWin.displayState;
    var afterState:String = NativeWindowDisplayState.MAXIMIZED;
    var displayStateEvent:NativeWindowDisplayStateEvent = 
        new NativeWindowDisplayStateEvent(NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
    nativeWin.dispatchEvent(displayStateEvent);
    if(!displayStateEvent.isDefaultPrevented()){
        nativeWin.maximize();
        return true;
    } else {
      return false;
    }
  }
  return false;
}

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

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

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

Примечания.

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

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

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;
}

 
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;
}

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

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

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

• NotificationType.INFORMATIONAL
• NotificationType.CRITICAL

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

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

Параметры

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

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

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

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

Параметры

windowBehind.orderInBackOf(windowFront);

displayObjBehind.stage.nativeWindow.orderInBackOf(displayObjectFront.stage.nativeWindow);

jsWindowObjBehind.nativeWindow.orderInBackOf(jsWindowObjFront.nativeWindow);

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

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

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

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

Параметры

windowFront.orderInFrontOf(windowBehind);

displayObjFront.stage.nativeWindow.orderInFrontOf(displayObjectBehind.stage.nativeWindow);

jsWindowObjFront.nativeWindow.orderInFrontOf(jsWindowObjBehind.nativeWindow);

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

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

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

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

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

windowObj.orderToBack();

displayObj.stage.nativeWindow.orderToBack();

window.nativeWindow.orderToBack();

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

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

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

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

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

windowObj.orderToFront();

displayObj.stage.nativeWindow.orderToFront();

window.nativeWindow.orderToFront();

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

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

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

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

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

public function restoreWindow(nativeWin:NativeWindow):Boolean{
    if(nativeWin.displayState != NativeWindowDisplayState.NORMAL){
        var beforeState:String = nativeWin.displayState;
        var afterState:String = NativeWindowDisplayState.NORMAL;
        var displayStateChangingEvent:NativeWindowDisplayStateEvent = 
            new NativeWindowDisplayStateEvent(NativeWindowDisplayStateEvent.DISPLAY_STATE_CHANGING,
                                              true,true,beforeState,afterState);
        nativeWin.dispatchEvent(displayStateChangingEvent);
        if(!displayStateChangingEvent.isDefaultPrevented()){
            nativeWin.restore();
            return true;
        } else {
          return false;
        }
     }
     return false;
}

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;
}

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

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

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

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

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();
}

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

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

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

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

Параметры

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

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);    
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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();
  }
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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();
  }
}