Пакет | flash.display |
Класс | public class Stage |
Наследование | Stage DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Для SWF-содержимого, выполняемого в обозревателе (в Flash® Player), Stage представляет собой всю область отображения содержимого Flash. Для содержимого, выполняемого в программе AIR в компьютерных операционных системах, каждый объект NativeWindow имеет соответствующий объект Stage.
К объекту Stage нет глобального доступа. Доступ к нему осуществляется через свойство stage
экземпляра DisplayObject.
Класс Stage имеет несколько классов предшественников — DisplayObjectContainer, InteractiveObject, DisplayObject и EventDispatcher —от которых он наследует свойства и методы. Многие из этих свойств и методов либо неприменимы к объектам Stage, либо требуют проверки безопасности, когда используются для объекта Stage. Свойства и методы, требующие проверки безопасности, записаны как часть класса Stage.
Следующие наследуемые свойства также неприменимы к объектам Stage. При попытке задать для них значения выдается ошибка IllegalOperationError. Эти свойства можно считывать, но, так как для них невозможно задать значение, они всегда имеют значения по умолчанию.
-
accessibilityProperties
-
alpha
-
blendMode
-
cacheAsBitmap
-
contextMenu
-
filters
-
focusRect
-
loaderInfo
-
mask
-
mouseEnabled
-
name
-
opaqueBackground
-
rotation
-
scale9Grid
-
scaleX
-
scaleY
-
scrollRect
-
tabEnabled
-
tabIndex
-
transform
-
visible
-
x
-
y
Некоторые события, которые, казалось бы, являются частью класса Stage, например enterFrame
, exitFrame
, frameConstructed
и render
, не могут быть событиями класса Stage, так как существование ссылки на объект Stage не гарантируется в каждой ситуации, в которой используются данные события. Так как эти события не могут быть отправлены объектом Stage, они отправляются каждым экземпляром DisplayObject, что означает, что вы можете добавить прослушиватель событий к любому экземпляру DisplayObject для прослушивания этих событий. Такие события, являющиеся частью класса DisplayObject, называются многоадресными и отличаются от событий, нацеленных на конкретный экземпляр DisplayObject. Два других многоадресных события, activate
и deactivate
, принадлежат к суперклассу DisplayObject, EventDispatcher. Поведение событий activate
и deactivate
схоже с поведением многоадресных событий DisplayObject, за исключением того, что эти два события отправляются не только всеми экземплярами DisplayObject, но также всеми экземплярами EventDispatcher и экземплярами других подклассов EventDispatcher. Дополнительные сведения о многоадресных событиях см. в описании класса DisplayObject.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | ||
align : String
Значение класса StageAlign, задающее выравнивание рабочей области в проигрывателе Flash Player или обозревателе. | Stage | ||
allowsFullScreen : Boolean [только для чтения]
Указывает, разрешает ли эта рабочая область использование режима целый экран
| Stage | ||
allowsFullScreenInteractive : Boolean [только для чтения]
Указывает, разрешено ли в рабочей области использовать весь экран в режиме ввода текста
| Stage | ||
alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | ||
autoOrients : Boolean
Указывает, изменяется ли ориентация рабочей области автоматически при изменении ориентации устройства. | Stage | ||
blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | ||
blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | ||
browserZoomFactor : Number [только для чтения]
Определяет коэффициент масштабирования браузера. | Stage | ||
cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true. | DisplayObject | ||
color : uint
Цвет фона SWF. | Stage | ||
colorCorrection : String
Управление цветокоррекцией для дисплеев в среде выполнения Flash. | Stage | ||
colorCorrectionSupport : String [только для чтения]
Указывает, работает ли среда выполнения Flash в операционной системе, поддерживающей цветокоррекцию, и имеется ли возможность чтения и распознавания цветового профиля главного (основного) монитора средой выполнения Flash. | Stage | ||
constructor : * | Stage | ||
contentsScaleFactor : Number [только для чтения]
Указывает эффективный коэффициент масштабирования пикселей рабочей области. | Stage | ||
contextMenu : NativeMenu
Определяет контекстное меню, связанное с данным объектом. | InteractiveObject | ||
deviceOrientation : String [только для чтения]
Физическая ориентация устройства. | Stage | ||
displayState : String
Значение класса StageDisplayState, задающее состояние отображения. | Stage | ||
doubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick. | InteractiveObject | ||
filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | ||
focus : InteractiveObject
Интерактивный объект с фокусом клавиатуры, либо null, если фокус не установлен, а также если объект с фокусом принадлежит к изолированной программной среде безопасности, доступ к которой отсутствует у вызывающего объекта. | Stage | ||
focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | InteractiveObject | ||
frameRate : Number
Получает и задает частоту кадров монтажного стола. | Stage | ||
fullScreenHeight : uint [только для чтения]
Возвращает ту высоту монитора, которая будет использована при мгновенном переходе в полноэкранный режим. | Stage | ||
fullScreenSourceRect : Rectangle
Среда выполнения Flash масштабирует конкретный участок рабочей области в полноэкранный режим. | Stage | ||
fullScreenWidth : uint [только для чтения]
Возвращает ту ширину монитора, которая будет использована при мгновенном переходе в полноэкранный режим. | Stage | ||
height : Number [переопределить]
Указывает высоту экранного объекта в пикселях. | Stage | ||
loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | ||
mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | DisplayObject | ||
metaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4. | DisplayObject | ||
mouseChildren : Boolean [переопределить]
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. | Stage | ||
mouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. | InteractiveObject | ||
mouseLock : Boolean
Установите значение true, чтобы включить блокировку мыши. | Stage | ||
mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | ||
mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | ||
name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | ||
nativeWindow : NativeWindow [только для чтения]
Ссылка на объект NativeWindow, содержащий данную рабочую область. | Stage | ||
needsSoftKeyboard : Boolean
Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус. | InteractiveObject | ||
numChildren : int [переопределить] [только для чтения]
Возвращает число дочерних элементов данного объекта. | Stage | ||
opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | ||
orientation : String [только для чтения]
Текущая ориентация рабочей области. | Stage | ||
parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | ||
quality : String
Значение класса StageQuality, определяющее, какое качество визуализации следует применять. | Stage | ||
root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | ||
rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | DisplayObject | ||
rotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному вышестоящему контейнеру. | DisplayObject | ||
rotationY : Number
Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | ||
rotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject от исходной ориентации относительно трехмерного родительского контейнера. | DisplayObject | ||
scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | ||
scaleMode : String
Значение класса StageScaleMode, задающее режим масштабирования. | Stage | ||
scaleX : Number
Указывает горизонтальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | ||
scaleY : Number
Указывает вертикальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | ||
scaleZ : Number
Указывает глубину масштабирования объекта (в процентах) относительно точки регистрации этого объекта. | DisplayObject | ||
scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | ||
showDefaultContextMenu : Boolean
Задает отображение или скрытие элементов по умолчанию в контекстном меню среды выполнения Flash. | Stage | ||
softKeyboard : String
Управляет внешним видом программной клавиатуры. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS). | InteractiveObject | ||
softKeyboardRect : Rectangle [только для чтения]
Прямоугольник, указывающий область рабочей область, которая в настоящее время охвачена мягкой клавиатурой. | Stage | ||
stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | ||
stage3Ds : Vector.<Stage3D> [только для чтения]
Список объектов Stage3D, доступных для отображения трехмерного содержимого. | Stage | ||
stageFocusRect : Boolean
Определяет, должна ли отображаться светящаяся рамка вокруг объектов в фокусе. | Stage | ||
stageHeight : int
Текущая высота объекта Stage в пикселях. | Stage | ||
stageVideos : Vector.<StageVideo> [только для чтения]
Список объектов StageVideo, доступных для воспроизведения внешних видеофайлов. | Stage | ||
stageWidth : int
Задает текущую ширину объекта Stage в пикселях. | Stage | ||
supportedOrientations : Vector.<String> [только для чтения]
Ориентации поддержаны текущим устройством. | Stage | ||
supportsOrientationChange : Boolean [статические] [только для чтения]
Поддерживает ли приложение изменения ориентации рабочей области (и поворот устройства). | Stage | ||
tabChildren : Boolean [переопределить]
Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab. | Stage | ||
tabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. | InteractiveObject | ||
tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [переопределить] [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | Stage | ||
transform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | ||
visible : Boolean
Определяет видимость экранного объекта. | DisplayObject | ||
vsyncEnabled : Boolean
Это отражает текущее состояние vsync базового графического решения. Мы можем включить или отключить vsync, чтобы сразу перейти к рендерингу, не дожидаясь активации следующего состояния VSYNC. | Stage | ||
width : Number [переопределить]
Указывает ширину экранного объекта в пикселях. | Stage | ||
wmodeGPU : Boolean [только для чтения]
Указывает, доступен ли композитинг GPU и используется ли он в данный момент. | Stage | ||
x : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | DisplayObject | ||
y : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | DisplayObject | ||
z : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера. | DisplayObject |
Метод | Определено | ||
---|---|---|---|
[переопределить]
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. | Stage | ||
[переопределить]
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. | Stage | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [переопределить]
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | Stage | ||
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой point. | DisplayObjectContainer | ||
Устанавливает фокус клавиатуры на интерактивном объекте, указанном в objectToFocus. Направление фокуса устанавливается параметром direction. | Stage | ||
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | ||
[переопределить]
Посылает событие в поток событий. | Stage | ||
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | ||
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса. | DisplayObjectContainer | ||
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | ||
Возвращает позицию индекса для экземпляра DisplayObject child. | DisplayObjectContainer | ||
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | ||
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | ||
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | ||
[переопределить]
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | Stage | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | ||
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | ||
Вызов метода invalidate() предписывает среде выполнения Flash оповестить экранные объекты о следующей возможности визуализации списка отображения (например, когда точка воспроизведения приближается к новому кадру). | Stage | ||
Определяет, должно ли свойство Stage.focus возвращать значение null по соображениям безопасности. | Stage | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | ||
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Удаляет заданный объект child DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
[переопределить]
Удаляет дочерний DisplayObject из заданной позиции индекса в списке дочерних элементов DisplayObjectContainer. | Stage | ||
Удаляет все дочерние экземпляры DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Вызывает виртуальную клавиатуру. | InteractiveObject | ||
Готовит почву к ориентации с указанными пропорциями. | Stage | ||
[переопределить]
Изменяет положение существующего дочернего элемента в DisplayObjectContainer. | Stage | ||
Устанавливает рабочую область в указанную ориентацию. | Stage | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Рекурсивно останавливает выполнение временной шкалы всех фрагментов MovieClip, размещенных в корне этого объекта. | DisplayObjectContainer | ||
Меняет местами (в порядке «от начала к концу») два заданных дочерних объекта. | DisplayObjectContainer | ||
[переопределить]
Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних элементов. | Stage | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object | ||
[переопределить]
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | Stage |
Событие | Сводка | Определено | ||
---|---|---|---|---|
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | |||
Отправляется, когда экранный объект добавляется в список отображения. | DisplayObject | |||
Отправляется, когда экранный объект добавляется к списку отображения на монтажном столе либо непосредственно, либо путем добавления поддерева, содержащего экранный объект. | DisplayObject | |||
Отправляется при изменении свойства browserZoomFactor для объекта Stage. | Stage | |||
Отправляется, когда пользователь выбирает команду «Удалить» из контекстного меню текста. | InteractiveObject | |||
Отправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject. | InteractiveObject | |||
Отправляется, когда жест пользователя вызывает контекстное меню, связанное с данным интерактивным объектом в приложении AIR. | InteractiveObject | |||
Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Копировать», или выбирает команду «Копировать» из контекстного меню. | InteractiveObject | |||
Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Вырезать», или выбирает команду «Вырезать» из контекстного меню. | InteractiveObject | |||
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | |||
Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true. | InteractiveObject | |||
[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр. | DisplayObject | |||
[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр. | DisplayObject | |||
Отправляется после того, как экранный объект перемещается в фокус. | InteractiveObject | |||
Отправляется после того, как экранный объект теряет фокус. | InteractiveObject | |||
[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра. | DisplayObject | |||
Отправляется, когда объект Stage переходит в полноэкранный режим или выходит из этого режима. | Stage | |||
Отправляется, когда пользователь создает точку контакта вдоль края сенсорной поверхности с помощью экземпляра InteractiveObject (например, нажатие по краю сенсорной поверхности на пульте Siri Remote для Apple TV). Некоторые устройства также могут интерпретировать этот контакт как комбинацию нескольких событий касания. | InteractiveObject | |||
Отправляется, когда пользователь наживает две точки контакта над одним экземпляром InteractiveObject на устройстве с сенсорным экраном (например, двумя пальцами нажимает точки над экранным объектом и отпускает их при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь перемещает точку контакта с экземпляром InteractiveObject на устройстве с сенсорным экраном (например, касается пальцем и проводит им слева направо над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь выполняет жест поворота в точке контакта с экземпляром InteractiveObject (например, касание двумя пальцами и их вращение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь выполняет жест выделения в точке контакта с экземпляром InteractiveObject (например, касание экрана тремя пальцами и их параллельное перемещение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь создает точку контакта с экземпляром InteractiveObject, а затем касается сенсорного экрана (например, касается экранного объекта несколькими пальцами, чтобы открыть меню, а затем касается одним пальцем для выбора нужного элемента меню при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь выполняет жест увеличения в точке контакта с экземпляром InteractiveObject (например, касание экрана двумя пальцами и их быстрое разведение в стороны над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Это событие отправляется любой клиентской программе, которая поддерживает линейный ввод с помощью IME. | InteractiveObject | |||
Отправляется, когда пользователь нажимает клавишу. | InteractiveObject | |||
Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры. | InteractiveObject | |||
Отправляется, когда пользователь отпускает клавишу. | InteractiveObject | |||
Отправляется, когда пользователь нажимает и отпускает среднюю кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь нажимает среднюю кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства. | InteractiveObject | |||
Отправляется объектом Stage, когда указатель покидает рабочую область. | Stage | |||
Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется при прокрутке колеса мыши над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется инициатором перетаскивания InteractiveObject, когда пользователь завершает жест перетаскивания. | InteractiveObject | |||
Отправляется целевым объектом InteractiveObject при принятии перетаскиваемого объекта вызовом метода DragManager.acceptDragDrop(). | InteractiveObject | |||
Отправляется объектом InteractiveObject, когда жест перетаскивания входит в его границы. | InteractiveObject | |||
Отправляется объектом InteractiveObject, когда жест перетаскивания выходит за границы этого объекта. | InteractiveObject | |||
Постоянно отправляется объектом InteractiveObject, пока жест перетаскивания остается в пределах его границ. | InteractiveObject | |||
Отправляется в начале операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | |||
Отправляется во время операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | |||
Отправляется объектом Stage при изменении ориентации рабочей области. | Stage | |||
Отправляется объектом Stage, когда начинается изменение ориентации рабочей области. | Stage | |||
Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Вставить», или выбирает команду «Вставить» из контекстного меню. | InteractiveObject | |||
Отправляется, когда пользователь опускает активное перо ниже установленного для экрана порога обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь поднимает активное перо, превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь наводит активное перо на экран, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь переводит активное перо от этого объекта InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь наводит активное перо непосредственно на этот объект InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь перемещает активное перо от этого объекта InteractiveObject и любого из его дочерних объектов, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | |||
Отправляется, когда пользователь переводит активное перо на этот объект InteractiveObject из внешней части дерева потомков в списке отображения (не превышая установленный для экрана порог обнаружения близости). | InteractiveObject | |||
Отправляется, когда пользователь отпускает кнопку позиционирующего устройства после ее нажатия над экземпляром InteractiveObject и последующего перемещения позиционирующего устройства с экземпляра InteractiveObject. | InteractiveObject | |||
Отправляется перед удалением экранного объекта из списка отображения. | DisplayObject | |||
Отправляется перед удалением экранного объекта из списка отображения либо напрямую, либо путем удаления поддерева, содержащего экранный объект. | DisplayObject | |||
[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения. | DisplayObject | |||
Отправляется, когда свойство scaleMode объекта Stage установлено в значение StageScaleMode.NO_SCALE и изменяется размер SWF-файла. | Stage | |||
Отправляется, когда пользователь нажимает и отпускает правую кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | |||
Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Выделить все», или выбирает команду «Выделить все» из контекстного меню. | InteractiveObject | |||
Отправляется сразу после того, как программная клавиатура вызывается. | InteractiveObject | |||
Передается немедленно перед тем, как программная клавиатура появляется на экране. | InteractiveObject | |||
Передается немедленно после того, как программная клавиатура убирается с экрана. | InteractiveObject | |||
Отправленный объектом Stage, когда состояние stageVideos изменений свойств. | Stage | |||
Отправляется, когда изменяется значение свойства tabChildren объекта. | InteractiveObject | |||
Отправляется при изменении флага tabEnabled объекта. | InteractiveObject | |||
Отправляется, когда изменяется значение свойства tabIndex объекта. | InteractiveObject | |||
Передается, если пользователь вводит один или несколько символов текста. | InteractiveObject | |||
Отправляется, когда пользователь впервые создает точку контакта с сенсорным экраном устройства (например, касается сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | |||
Отправляется, когда пользователь убирает точку контакта с сенсорным экраном устройства (например, поднимает палец с сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | |||
Отправляется, когда пользователь касается устройства, и продолжает отправляться до тех пор, пока точка контакта не будет удалена. | InteractiveObject | |||
Отправляется, когда пользователь перемещает точку контакта от экземпляра InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с одного экранного объекта на другой при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь удаляет точку контакта из экземпляра InteractiveObject на сенсорном устройстве (например, переводит палец из положения над экранным объектом в точку за пределами экранного объекта на мобильном телефоне или планшете с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправляется, когда пользователь поднимает точку контакта над тем же экземпляром InteractiveObject, с которым был установлен первичный контакт на сенсорном экране (например, нажимает точку на экранном объекте и поднимает палец с той же точки при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | |||
Отправлено объектом Stage при изменении состояния свойства vsync. | Stage |
align | свойство |
align:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Значение класса StageAlign, задающее выравнивание рабочей области в проигрывателе Flash Player или обозревателе. Ниже приводятся допустимые значения.
Значение | Выравнивание по вертикали | По горизонтали |
---|---|---|
StageAlign.TOP | Верхний край | Центр |
StageAlign.BOTTOM | Нижний край | Центр |
StageAlign.LEFT | Центр | Слева |
StageAlign.RIGHT | Центр | Справа |
StageAlign.TOP_LEFT | Верхний край | Слева |
StageAlign.TOP_RIGHT | Верхний край | Справа |
StageAlign.BOTTOM_LEFT | Нижний край | Слева |
StageAlign.BOTTOM_RIGHT | Нижний край | Справа |
Свойство align
доступно только для объекта, находящегося в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain()
или метода Security.allowInsecureDomain()
. Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
Реализация
public function get align():String
public function set align(value:String):void
Связанные элементы API
allowsFullScreen | свойство |
allowsFullScreenInteractive | свойство |
autoOrients | свойство |
autoOrients:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2 |
Указывает, изменяется ли ориентация рабочей области автоматически при изменении ориентации устройства.
Начальное значение этих свойств получено от элемента autoOrients
дескриптора программы и имеет значение по умолчанию false
. Если для свойства установлено значение false
, его поведение не может быть гарантировано. На некоторых устройствах рабочая область сохраняет текущую ориентацию. На других устанавливается «стандартная» ориентация, определенная устройством, после чего ориентация рабочей области больше не изменяется.
Поддержка в профилях AIR: эта функция поддерживается на мобильных устройствах, но не поддерживается в компьютерных операционных системах или на устройствах AIR for TV. Используйте свойство Stage.supportsOrientantionChange
, чтобы проверить наличие поддержки в среде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».
Реализация
public function get autoOrients():Boolean
public function set autoOrients(value:Boolean):void
Связанные элементы API
browserZoomFactor | свойство |
browserZoomFactor:Number
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 15 |
Определяет коэффициент масштабирования браузера. Изменение в коэффициенте масштабирования браузера влияет на масштабирование рабочей области.
Реализация
public function get browserZoomFactor():Number
color | свойство |
colorCorrection | свойство |
colorCorrection:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Управление цветокоррекцией для дисплеев в среде выполнения Flash. Коррекция цвета срабатывает, только если главному монитору назначен действительный профиль ICC, задающий конкретные цветовые атрибуты устройства. По умолчанию среда выполнения Flash предпринимает попытку сопоставления цветокоррекции хоста (обычно браузера).
Используйте свойство Stage.colorCorrectionSupport
для определения доступности коррекции цвета в текущей системе и состоянии по умолчанию. Если коррекция цвета доступна, все цвета в рабочей области должны находиться в пространстве цветов sRGB, которое на данный момент является наиболее распространенным. Во время цветовой коррекции исходные профили устройств ввода игнорируются. Коррекция цветов на вводе не применяется. На цветовой профиль IIC главного монитора накладывается только вывод рабочей области.
Как правило, активация управления цветом делает передачу цвета более точной, улучшает преобразование, позволяет точнее осуществлять цветопробу и эффективно отображать цвета независимо от программного материала. Имейте в виду, что управление цветом не делает преобразование идеальным, так как цветовые гаммы различных устройств расходятся между собой и отличаются от палитр исходных изображений. Подобным образом, при использовании управления цветом не исключается необходимость использовать пользовательские или измененные профили. Профили цветов зависят от обозревателей, операционных систем (ОС), расширений ОС, устройств вывода и поддержки со стороны приложения.
При применении коррекции цвета производительность среды выполнения Flash снижается. В среде выполнения Flash коррекция цвета реализована в качестве цветокоррекции стиля документа, так как все ролики SWF являются документами со встроенными профилями sRGB. Используйте свойство Stage.colorCorrectionSupport
, чтобы сообщить среде выполнения Flash о необходимости корректировать цвета при отображении SWF-файла (документа) в соответствии с цветовым пространством дисплея. Среда выполнения Flash может компенсировать различия между мониторами, но не между устройствами ввода (такими как камера/сканер и т. д.).
Тремя возможными значениями являются строки с соответствующими константами в классе flash.display.ColorCorrection:
default
: использование такой же цветокоррекции, как в хост-системе.on
: постоянное выполнение цветокоррекции.off
: запрет выполнения цветокоррекции.
Реализация
public function get colorCorrection():String
public function set colorCorrection(value:String):void
Связанные элементы API
Пример ( Использование этого примера )
Stage.colorCorrection
не является элементом класса ColorCorrection, тогда обработчик сообщает об ошибке.
function addHandler(add_event:Event) { switch(stage.colorCorrection) { case ColorCorrection.ON: stage.colorCorrection = ColorCorrection.OFF; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.OFF: stage.colorCorrection = ColorCorrection.DEFAULT; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.DEFAULT: stage.colorCorrection = ColorCorrection.ON; lblCMEnableState.text = "State: " + stage.colorCorrection; break; default: lblCMEnableState.text = "Error."; break; }
colorCorrectionSupport | свойство |
colorCorrectionSupport:String
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Указывает, работает ли среда выполнения Flash в операционной системе, поддерживающей цветокоррекцию, и имеется ли возможность чтения и распознавания цветового профиля главного (основного) монитора средой выполнения Flash. Это свойство также возвращает состояние цветокоррекции по умолчанию в хост-системе (обычно обозревателе). Текущими возвращаемыми значениями могут быть следующие:
Тремя возможными значениями являются строки с соответствующими константами в классе flash.display.ColorCorrectionSupport:
unsupported
: цветокоррекция недоступна.defaultOn
: постоянное выполнение цветокоррекции.defaultOff
: запрет выполнения цветокоррекции.
Реализация
public function get colorCorrectionSupport():String
Связанные элементы API
Пример ( Использование этого примера )
stage.colorCorrectionSupport
, чтобы узнать, является ли оно элементом класса ColorCorrectionSupport: DEFAULT_ON
или DEFAULT_OFF
. Если свойство имеет любое из этих значений, оно отображается в текстовом поле. В противном случае, если его значение не является DEFAULT_ON
или DEFAULT_OFF
, в текстовом поле отображается слово «unsupported» (не поддерживается).
function addHandler(add_event:Event) { if (stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_ON || stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_OFF) { lblHasCM.text = "stage.colorCorrectionSupport: " + stage.colorCorrectionSupport; } else { lblHasCM.text = "stage.colorCorrectionSupport: unsupported"; } }
constructor | свойство |
contentsScaleFactor | свойство |
contentsScaleFactor:Number
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 11.5 |
Указывает эффективный коэффициент масштабирования пикселей рабочей области. Это значение равно 1 на стандартных экранах и дисплеях HiDPI (дисплеях Retina). Когда рабочая область отрисовывается на экранах HiDPI, разрешение в пикселях удваивается, даже если режим масштаба рабочей области устанавливается как StageScaleMode.NO_SCALE. Параметры Stage.stageWidth и Stage.stageHeight по-прежнему отображаются в классических единицах измерения пикселей.
Реализация
public function get contentsScaleFactor():Number
deviceOrientation | свойство |
deviceOrientation:String
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2 |
Физическая ориентация устройства.
На устройствах с раскладками клавиатуры слайда у состояния клавиатуры есть более высокий приоритет в задавании ориентации устройства чем угол, определенный акселерометром. Таким образом на устройстве книжного аспекта с установленной стороной клавиатурой, deviceOrientation
свойства сообщат ROTATED_LEFT
когда клавиатура открыта независимо от того, как пользователь хранит устройство.
Используйте константы, определенные в классе StageOrientation, устанавливая или сравнивая значения для этих свойств.
Поддержка в профилях AIR: эта функция поддерживается на мобильных устройствах, но не поддерживается в компьютерных операционных системах или на устройствах AIR for TV. Используйте свойство Stage.supportsOrientationChange
, чтобы проверить наличие поддержки в среде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».
Реализация
public function get deviceOrientation():String
Связанные элементы API
displayState | свойство |
displayState:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Значение класса StageDisplayState, задающее состояние отображения. Ниже приводятся допустимые значения.
StageDisplayState.FULL_SCREEN
предписывает приложению AIR или содержимому проигрывателя Flash Player развернуть рабочую область на весь экран. Ввод с клавиатуры при этом отключен (за исключением некоторых клавиш, не предназначенных для печати).StageDisplayState.FULL_SCREEN_INTERACTIVE
предписывает приложению развернуть рабочую область на весь экран пользователя, не отключая ввод с клавиатуры. (Доступно в AIR и проигрывателе Flash Player, начиная с версии Flash Player 11.3.)StageDisplayState.NORMAL
возвращает проигрыватель в стандартный режим отображения рабочей области.
Масштабирование видео в полноэкранном режиме определяется значением scaleMode
(которое задается при помощи свойства Stage.scaleMode
параметрами тегов embed
SWF-файла в файле HTML). Если для свойства scaleMode
установлено значение noScale
при переводе приложения в полноэкранный режим, у объекта Stage обновляются свойства width
и height
, а сам объект Stage отправляет событие resize
. Если установлен другой режим масштабирования, рабочая область и ее содержимое заполняют все окно с новыми размерами. У объекта Stage остаются исходные значения параметров width
и height
, и объект не отправляет событие resize
.
Следующие ограничения действуют для SWF-файлов, проигрываемых на странице HTML (не для тех, что выполняются в автономном проигрывателе Flash Player и среде AIR):
- Для включения полноэкранного режима добавьте параметр
allowFullScreen
в тегиobject
иembed
страницы HTML, содержащей SWF-файл, задав для свойстваallowFullScreen
значение"true"
, как показано в следующем примере:<param name="allowFullScreen" value="true" /> ... <embed src="example.swf" allowFullScreen="true" ... >
Страница HTML может также выполнить сценарий для создания тегов внедрения SWF. Такой сценарий нужно изменить, задав нужные значения для свойства
allowFullScreen
. HTML-страницы, созданные при помощи Flash Professional и Flash Builder, используют функциюAC_FL_RunContent()
для вставки ссылок на SWF-файлы, поэтому необходимо добавить значения параметраallowFullScreen
, как в следующем примере.AC_FL_RunContent( ... "allowFullScreen", "true", ... )
- Полноэкранный режим запускается в ответ на щелчок мышью или нажатие кнопки пользователем; значение свойства
Stage.displayState
не может измениться без ввода пользователя. В среде выполнения Flash ввод с клавиатуры в полноэкранном режиме ограничен. Допустимыми клавишами являются комбинации клавиш для отключения полноэкранного режима и клавиши, отличные от клавиш печати, такие как стрелки, пробел Shift и Tab. (Для поддержки ввода с дополнительных клавиш необходимо работать в полноэкранном интерактивном режиме.) Для выключения полноэкранного режима используются следующие сочетания клавиш: Escape (Windows, Linux и Mac), Control+W (Windows), Command+W (Mac) и Alt+F4. - Начиная с Flash Player 9.0.115.0, полноэкранный режим работает одинаково в безоконном и оконном режиме. Если вы установите «Режим окон» (
wmode
в HTML) на «Непрозрачный, без окна» (opaque
) или «Прозрачный, без окна» (transparent
), полноэкранный режим может быть включен, но окно всегда будет непрозрачным. - Для включения интерактивного полноэкранного режима, который поддерживает работу с клавиатурой, добавьте параметр
allowFullScreenInteractive
в тегиobject
иembed
страницы HTML, содержащей SWF-файл, задав для свойстваallowFullScreenInteractive
значение"true"
, как показано в следующем примере:<param name="allowFullScreenInteractive" value="true" /> ...
Данные ограничения не действуют для содержимого SWF, выполняемого в автономном Flash Player или в приложении AIR.
При входе в полноэкранный режим среда Flash ненадолго выводит поверх содержимого SWF уведомление о том, что пользователь находится в полноэкранном режиме и может выйти из него, нажав клавишу Escape.
При входе в полноэкранный интерактивный режим Flash Player ненадолго выводит поверх содержимого SWF запрос на подтверждение доступа к расширенному вводу с клавиатуры (включая клавиши для печати). В этом же запросе содержится информация о том, что пользователь может выйти из интерактивного полноэкранного режима, нажав клавишу Escape. Не следует делать предположений о внешнем виде/расположении запроса на подтверждение. Определить, разрешил ли пользователь доступ к расширенному вводу с клавиатуры, можно по ответу события FullScreenEvent.FULL_SCREEN_INTERACTIVE_ACCEPTED
.
На время воспроизведения ролика AIR в полноэкранном режиме экранная заставка ОС и управление питанием отключаются и становятся активными только при выходе из полноэкранного режима или завершении воспроизведения ролика.
В Linux установка displayState
на StageDisplayState.FULL_SCREEN
или StageDisplayState.FULL_SCREEN_INTERACTIVE
является асинхронной операцией.
Реализация
public function get displayState():String
public function set displayState(value:String):void
Выдает
SecurityError — Вызов свойства displayState объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0. При попытке настроить свойство displayState , когда отображается диалоговое окно параметров без отклика пользователя или если атрибуту allowFullScreen HTML-тегов param или embed не назначено значение true , появляется ошибка безопасности.
|
Связанные элементы API
Пример ( Использование этого примера )
displayState
. Примечание. Вследствие ограничений, установленных из соображений безопасности, полноэкранный режим можно запускать только в определенных ситуациях, например, если пользователь щелкнул кнопку или нажал клавишу. При запуске в обозревателе свойство allowFullScreen должно иметь значение true.
package { import flash.display.Sprite; import flash.display.Stage; import flash.events.*; import flash.net.NetConnection; import flash.net.NetStream; import flash.media.Video; public class FullScreenExample extends Sprite { private var videoURL:String = "testVideo.flv"; private var connection:NetConnection; private var stream:NetStream; private var video:Video; public function FullScreenExample() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK,toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { switch(stage.displayState) { case "normal": stage.displayState = "fullScreen"; break; case "fullScreen": default: stage.displayState = "normal"; break; } } // Video related: private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); video = new Video(stage.stageWidth,stage.stageHeight); video.attachNetStream(stream); stream.play(videoURL); addChild(video); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } } }
focus | свойство |
focus:InteractiveObject
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Интерактивный объект с фокусом клавиатуры, либо null
, если фокус не установлен, а также если объект с фокусом принадлежит к изолированной программной среде безопасности, доступ к которой отсутствует у вызывающего объекта.
Реализация
public function get focus():InteractiveObject
public function set focus(value:InteractiveObject):void
Выдает
Error — Выдает ошибку, если фокус нельзя перевести на цель.
|
Пример ( Использование этого примера )
myTF
, чтобы пользователь мог сразу начинать ввод текста, не щелкая по полю. На мобильных устройствах с ОС iOS и Android, а также на устройствах с ОС tvOS пользователю необходимо нажать текстовое поле для активации программной клавиатуры. При тестировании этого кода в интерфейсе инструмента разработки доступ может быть ограничен несколькими клавишами, так как хост (браузер или инструмент разработки) первым интерпретирует большинство нажатий клавиш. Чтобы протестировать все функции этого примера, его необходимо скомпилировать и запустить полученный SWF-файл.
var myTF:TextField = new TextField(); myTF.border =true; myTF.type = TextFieldType.INPUT; addChild(myTF); stage.focus= myTF;
frameRate | свойство |
frameRate:Number
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Получает и задает частоту кадров монтажного стола. Частота кадров определяется как число кадров в секунду. По умолчанию используется значение частоты кадров первого загруженного SWF-файла. Допустимые значения частоты кадров находятся в диапазоне 0,01 — 1000 кадров в секунду.
Примечание. Приложение может не воспринимать параметры высокой частоты, если целевая платформа недостаточно быстрая или если проигрыватель синхронизируется с интервалами пробела по вертикали дисплея (обычно это 60 Гц на ЖК-мониторах). В некоторых случаях целевая платформа также может выбирать более низкую максимальную частоту кадров, если ожидает высокий процент использования ЦП.
При работе с содержимым в Adobe AIR настройка свойства frameRate
одного объекта Stage приводит к изменению частоты кадров всех объектов Stage (используемых разными объектами NativeWindow).
Реализация
public function get frameRate():Number
public function set frameRate(value:Number):void
Выдает
SecurityError — Вызов метода frameRate объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
fullScreenHeight | свойство |
fullScreenHeight:uint
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Возвращает ту высоту монитора, которая будет использована при мгновенном переходе в полноэкранный режим. Если в системе установлено несколько мониторов, то используется тот из них, на котором в данный момент отображается большая часть рабочей области.
Примечание. Если у пользователя есть возможность перемещать обозреватель с одного монитора на другой между получением значения и переходом в полноэкранный режим, то это значение будет неправильным. Если значение получено в обработчике событий, задающем для Stage.displayState
значение StageDisplayState.FULL_SCREEN
, то значение будет правильным.
Это высота монитора в пикселях, она равна высоте рабочей области, если для Stage.align
задано значение StageAlign.TOP_LEFT
, а для Stage.scaleMode
— StageScaleMode.NO_SCALE
.
Реализация
public function get fullScreenHeight():uint
Связанные элементы API
fullScreenSourceRect
fullScreenWidth
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Пример ( Использование этого примера )
enterFullScreen()
, который задает свойство fullScreenSourceRect
и входит в полноэкранный режим. Чтобы задать свойство fullScreenSourceRect
, обработчик событий начинает с местоположения и размеров красного квадрата. Затем он сравнивает соотношение сторон (ширина, разделенная на высоту) красного квадрата с соотношением сторон рабочей области, имеющего ширину и высоту полного экрана, чтобы развернуть прямоугольник (fullScreenSourceRect
) в соответствии с соотношением сторон экрана. В результате, красный квадрат занимает всю высоту монитора, а по бокам виден зеленый фон. Если бы не соблюдалось соотношение сторон, то вместо зеленого фона по бокам был бы виден фон рабочей области (по умолчанию белый).
Примечание. Протестируйте этот пример в обозревателе. В диалоговом окне «Параметры публикации Flash», на вкладке «HTML» выберите шаблон «Только Flash — Разрешить полноэкранный режим». Укажите Flash Player версии 9.0.115.0 и не забудьте выбрать форматы Flash и HTML на вкладке «Форматы». Затем опубликуйте и откройте полученный HTML-файл в обозревателе.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
fullScreenSourceRect | свойство |
fullScreenSourceRect:Rectangle
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Среда выполнения Flash масштабирует конкретный участок рабочей области в полноэкранный режим. Если есть возможность, среда выполнения Flash выполняет масштабирование с использованием аппаратных средств, включая графическую карту и видеокарту на компьютере пользователя. В этом случае отображение содержания, как правило, начинается намного быстрее, чем при масштабировании с помощью программных средств.
Когда в качестве значения этому свойству передан допустимый прямоугольник, а свойство displayState
настроено на полноэкранный режим, среда выполнения Flash масштабирует заданную область. Фактический размер рабочей области в пикселях в ActionScript не изменяется. Среда выполнения Flash использует ограничение минимального размера прямоугольника, чтобы показать сообщение «Нажмите Esc для выхода из полноэкранного режима». Обычно минимальный размер бывает около 260 на 30 пикселей, но он может варьироваться в зависимости от платформы и версии среды выполнения Flash.
Это свойство можно настраивать, только когда среда выполнения Flash не находится в полноэкранном режиме. Для правильного использования этого свойства его необходимо настроить первым, и только потом выбирать для свойства displayState
полноэкранный режим, как показано в примерах кода. Примечание. В Flash Player 15 и более поздних версий это свойство можно установить, даже когда среда выполнения Flash находится в полноэкранном режиме.
Чтобы включить масштабирование, задайте свойство fullScreenSourceRect
объекту прямоугольника.
// valid, will enable hardware scaling stage.fullScreenSourceRect = new Rectangle(0,0,320,240);
Чтобы отключить масштабирование, задайте fullScreenSourceRect=null
в ActionScript 3.0 и undefined
в ActionScript 2.0.
stage.fullScreenSourceRect = null;
Конечный пользователь может отключить в параметрах отображения проигрывателя Flash Player аппаратное масштабирование, включенное по умолчанию. Дополнительные сведения см. на странице www.adobe.com/go/display_settings_ru.
Реализация
public function get fullScreenSourceRect():Rectangle
public function set fullScreenSourceRect(value:Rectangle):void
Связанные элементы API
Stage.displayState
Stage.scaleMode
flash.events.FullScreenEvent
flash.events.Event.RESIZE
Пример ( Использование этого примера )
import flash.geom.*; { stage.fullScreenSourceRect = new Rectangle(0,0,320,240); stage.displayState = StageDisplayState.FULL_SCREEN; }
Прежде чем использовать полноэкранный режим с аппаратным масштабированием, необходимо выполнить следующие условия:
- Требуется проигрыватель Flash Player версии 9.0.115.0 или более поздней, а также поддерживающий его инструмент разработки.
- необходимо изменить HTML-шаблоны с целью поддержки полноэкранного режима; атрибуту
allowFullScreen
необходимо задать значениеtrue
для теговobject
иembed
. (Сценарии, создающие теги для внедрения SWF, также должны разрешать переход в полноэкранный режим.) Примеры файлов, которые можно использовать для Flash Builder, см. в статье Exploring full-screen mode in Flash Player 9 (Полноэкранный режим в проигрывателе Flash Player 9). - У приложения должны быть разрешение и доступ к видеофайлу FLV. В данном примере предполагается, что файл Flash Video (FLV) находится в том же каталоге, что и SWF-файл.
- Пользователь должен разрешить доступ для полноэкранного режима.
- Дополнительные сведения об аппаратном масштабировании см. в статье Поддержка видео с высоким разрешением H.264 и аудио формата AAC в проигрывателе Flash Player.
FLV-файл загружается с использованием объектов NetConnection и NetStream. Так как FLV-файл находится в том же каталоге, что и SWF-файл и будет подключаться через HTTP, то параметру метода NetConnection.connect()
задается значение null
. Объект connect
NetConnection сообщает свое состояние, отправляя событие netStatus
, вызывающее метод netStatusHandler()
. Метод netStatusHandler()
проверяет, успешно ли установлено подключение и вызывает метод connectStream()
, который создает объект NetStream, принимающий в качестве параметра объект NetConnection. Он также создает видеообъект и прилагаемый к нему объект NetStream. Затем видеообъект добавляется в список отображения и поток включается на воспроизведение. Так как видеофайл FLV не содержит метаданных или информации о ключевых точках, отправляется событие AsyncError
. Необходимо настроить прослушиватель для обработки этого события. В данном примере прослушиватель настроен, он игнорирует событие. Также для объекта NetStream настраивается другой прослушиватель для события netStatus
. Он будет отображать сообщение об ошибке, если поток не найден. (Обратите внимание, что метод netStatusHandler()
можно использовать для обработки любого объема информации о состоянии потока или подключения.)
Когда становятся доступны свойства и методы загруженного SWF-файла, вызывается метод createMouseListener()
. Он настраивает прослушивателя событий щелчка мыши по рабочей области. Метод toggleFullScreen()
проверяет, находится ли состояние отображения в полноэкранном или нормальном режиме. Если режим нормальный, размер видеообъекта равен размеру видеопотока. Для свойства fullScreenSourceRect
выбирается прямоугольник, соответствующий размерам видеообъекта. Затем для свойства Stage.displayMode
задается полный экран, в результате чего видео в исходном прямоугольнике развернется на весь экран. Если выполняются системные требования, графические аппаратные средства компьютера будут использоваться для оптимизации производительности полноэкранной визуализации видеоролика, и состояние отображения переходит в полноэкранный режим. Чтобы улавливать любые ошибки безопасности, которые могут возникнуть при переходе в полноэкранный режим, используется try...catch
. (Обратите внимание, что состояние отображения должно переводиться на полноэкранный режим после того, как задано свойство fullScreenSourceRect
.) Перед переключением в нормальный режим ширина и высота видеообъекта возвращаются к сохраненным исходным значениям. Если этого не сделать, ширина и высота будут определяться изменениями, внесенными в видеообъект для полноэкранного режима.
package { import flash.display.Sprite; import flash.display.StageDisplayState; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; import flash.events.NetStatusEvent; import flash.events.AsyncErrorEvent; import flash.events.SecurityErrorEvent; import flash.events.MouseEvent; import flash.events.Event; import flash.geom.Rectangle; public class Stage_fullScreenSourceRectExample2 extends Sprite { private var videoURL:String = "testVideo1.flv"; private var connection:NetConnection; private var stream:NetStream; private var myVideo:Video; private var savedWidth:uint; private var savedHeight:uint; public function Stage_fullScreenSourceRectExample2() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK, toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { if(stage.displayState == StageDisplayState.NORMAL) { myVideo.width = myVideo.videoWidth; myVideo.height = myVideo.videoHeight; try { stage.fullScreenSourceRect = new Rectangle(myVideo.x, myVideo.y, myVideo.width, myVideo.height); stage.displayState = StageDisplayState.FULL_SCREEN; } catch (e:SecurityError) { trace ("A security error occurred while switching to full screen: " + event); myVideo.width = savedWidth; myVideo.height = savedHeight; } }else { myVideo.width = savedWidth; myVideo.height = savedHeight; stage.displayState = StageDisplayState.NORMAL; } } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace ("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); myVideo = new Video(); myVideo.attachNetStream(stream); stream.play(videoURL); savedWidth = myVideo.width; savedHeight = myVideo.height; addChild(myVideo); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { } } }
fullScreenWidth | свойство |
fullScreenWidth:uint
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Возвращает ту ширину монитора, которая будет использована при мгновенном переходе в полноэкранный режим. Если в системе установлено несколько мониторов, то используется тот из них, на котором в данный момент отображается большая часть рабочей области.
Примечание. Если у пользователя есть возможность перемещать обозреватель с одного монитора на другой между получением значения и переходом в полноэкранный режим, то это значение будет неправильным. Если значение получено в обработчике событий, задающем для Stage.displayState
значение StageDisplayState.FULL_SCREEN
, то значение будет правильным.
Это ширина монитора в пикселях, она равна ширине рабочей области, если для Stage.align
задано значение StageAlign.TOP_LEFT
, а для Stage.scaleMode
— StageScaleMode.NO_SCALE
.
Реализация
public function get fullScreenWidth():uint
Связанные элементы API
fullScreenHeight
fullScreenSourceRect
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Пример ( Использование этого примера )
enterFullScreen()
, который задает свойство fullScreenSourceRect
и входит в полноэкранный режим. Чтобы задать свойство fullScreenSourceRect
, обработчик событий начинает с местоположения и размеров красного квадрата. Затем он сравнивает соотношение сторон (ширина, разделенная на высоту) красного квадрата с соотношением сторон рабочей области, имеющего ширину и высоту полного экрана, чтобы развернуть прямоугольник (fullScreenSourceRect
) в соответствии с соотношением сторон экрана. В результате, красный квадрат занимает всю высоту монитора, а по бокам виден зеленый фон. Если бы не соблюдалось соотношение сторон, то вместо зеленого фона по бокам был бы виден фон рабочей области (по умолчанию белый).
Примечание. Протестируйте этот пример в обозревателе. В диалоговом окне «Параметры публикации Flash», на вкладке «HTML» выберите шаблон «Только Flash — Разрешить полноэкранный режим». Укажите Flash Player версии 9.0.115.0 и не забудьте выбрать форматы Flash и HTML на вкладке «Форматы». Затем опубликуйте и откройте полученный HTML-файл в обозревателе.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
height | свойство |
height:Number
[переопределить] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Указывает высоту экранного объекта в пикселях. Высота вычисляется на основе границ содержимого экранного объекта. Когда задается свойство height
, соответствующим образом изменяется и свойство scaleY
, как показано в следующем коде.
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleY) // 1; rect.height = 200; trace(rect.scaleY) // 2;
За исключением объектов TextField и Video, экранные объекты без содержимого (например, пустой спрайт), имеют высоту 0, даже если задать свойству height
другое значение.
Реализация
override public function get height():Number
override public function set height(value:Number):void
Выдает
SecurityError — Ссылка на свойство height объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
| |
IllegalOperationError — Абсолютно недопустимо настраивать свойство height объекта Stage, даже если вызывающий объект является его владельцем (главный SWF-файл).
|
mouseChildren | свойство |
mouseChildren:Boolean
[переопределить] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. Если объект поддерживает эти события, пользователь может взаимодействовать с ним с помощью мыши или другого устройства ввода. Значение по умолчанию — true
.
Это свойство удобно использовать, когда кнопка создается с помощью экземпляра класса Sprite (а не класса SimpleButton). Когда для создания кнопки используется экземпляр Sprite, при желании можно украсить кнопку с помощью метода addChild()
, добавив дополнительные экземпляры Sprite. Этот процесс может вызывать непредвиденное поведение событий мыши, так как целевым объектом события мыши вместо родительского экземпляра могут стать экземпляры Sprite, добавленные в качестве дочерних. Чтобы родительский экземпляр гарантированно был целевым объектом событий мыши, можно задать его свойству mouseChildren
значение false
.
При настройке данного свойства события не отправляются. Чтобы создать интерактивные функции, необходимо использовать метод addEventListener()
.
Реализация
override public function get mouseChildren():Boolean
override public function set mouseChildren(value:Boolean):void
Выдает
SecurityError — Ссылка на свойство mouseChildren объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
mouseLock | свойство |
mouseLock:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 11.2, AIR 3.2 |
Установите значение true
, чтобы включить блокировку мыши. При включении блокировки мыши курсор отключается, и разрешается перемещение мыши без границ. Блокировку мыши можно включить только в полноэкранном режиме для настольных приложений. При установке его для приложений не в полноэкранном режиме или для приложений на мобильных устройствах будет возникать исключение.
Блокировка мыши отключается автоматически, и курсор снова становится видимым в следующих случаях:
- Пользователь выходит из полноэкранного режима, нажимая клавишу ESC (все платформы), Ctrl-W (Windows), Command-W (Mac) или Alt-F4 (Windows).
- Окно приложения теряет фокус.
- Все элементы пользовательского интерфейса настроек отображаются, включая все конфиденциальные диалоговые окна.
- Отображается собственное диалоговое окно, например диалоговое окно загрузки файлов.
При выходе из полноэкранного режима для этого свойства автоматически устанавливается значение false
.
События, связанные с перемещением мыши, такие как mouseMove
, используют класс MouseEvent для представления объекта события. Если блокировка мыши отключена, для определения положения мыши следует использовать свойства MouseEvent.localX
и MouseEvent.localY
. Если блокировка мыши включена, для определения положения мыши следует использовать свойства MouseEvent.movementX
и MouseEvent.movementY
. Свойства movementX
и movementY
содержат изменения положения мыши, произошедшие с последнего события, вместо абсолютных координат положения мыши.
Примечание. Когда приложение находится в полноэкранном режиме, прослушиватели событий мыши, присоединенные к экранным объектам, кроме объекта Stage, не отправляются. Поэтому, чтобы получить дельты мыши и любые другие события мыши при значении mouseLock
равном true
, присоедините прослушивателей события мыши к объекту Stage.
Реализация
public function get mouseLock():Boolean
public function set mouseLock(value:Boolean):void
Связанные элементы API
nativeWindow | свойство |
nativeWindow:NativeWindow
[только для чтения] Версии среды выполнения: | AIR 1.0, Flash Lite 4 |
Ссылка на объект NativeWindow, содержащий данную рабочую область.
Данное окно представляет собственное окно операционной системы, а рабочая область — его содержимое. Это свойство действительно только для содержимого, выполняющегося в программе AIR на платформах, поддерживающих класс NativeWindow. На других платформах это свойство будет иметь значение null
. В проигрывателе Flash Player (при просмотре содержимого в браузере) значением данного свойства также является null
.
Реализация
public function get nativeWindow():NativeWindow
numChildren | свойство |
numChildren:int
[только для чтения] [переопределить] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Возвращает число дочерних элементов данного объекта.
Реализация
override public function get numChildren():int
Выдает
SecurityError — Ссылка на свойство numChildren объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
orientation | свойство |
orientation:String
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2 |
Текущая ориентация рабочей области. Этому свойству задается одно из четырех значений, определенных в качестве констант класса StageOrientation:
Константа StageOrientation | Ориентация рабочей области |
---|---|
StageOrientation.DEFAULT | Экран находится ориентации по умолчанию (правой стороной вверх). |
StageOrientation.ROTATED_RIGHT | Экран повернут вправо. |
StageOrientation.ROTATED_LEFT | Экран повернут влево. |
StageOrientation.UPSIDE_DOWN | Экран находится в перевернутом положении. |
StageOrientation.UNKNOWN | Программа еще не определила начальную ориентацию экрана. Можно добавить прослушиватель для события orientationChange . |
Чтобы задать ориентацию рабочей области, используйте метод setOrientation()
.
Важный: свойства ориентации поддержаны на устройствах Андроида от 2.6 namespace вперед.
Реализация
public function get orientation():String
Связанные элементы API
quality | свойство |
quality:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Значение класса StageQuality, определяющее, какое качество визуализации следует применять. Ниже приводятся допустимые значения.
StageQuality.LOW
— низкое качество визуализации. Графические объекты и растровые изображения не сглаживаются, а среда выполнения продолжает использовать множественное отображение.StageQuality.MEDIUM
— среднее качество визуализации. Графические объекты сглаживаются с помощью решетки пикселей 2 на 2, сглаживание растровых изображений зависит от значения параметраBitmap.smoothing
. Среда выполнения использует множественные отображения. Эта установка подходит для роликов, не содержащих текст.StageQuality.HIGH
— высокое качество визуализации. Графические объекты сглаживаются с помощью решетки пикселей 4 на 4, сглаживание растровых изображений зависит от значения параметраBitmap.smoothing
. Среда выполнения использует множественные отображения. Этот параметр качества визуализации используется проигрывателем Flash Player по умолчанию.StageQuality.BEST
— Очень высокое качество визуализации. Графические объекты сглаживаются с помощью решетки пикселей 4 на 4. Если параметрBitmap.smoothing
имеет значениеtrue
, то среда выполнения использует высококачественный алгоритм уменьшения размера, который дает меньше помех (в то же время использованиеStageQuality.BEST
с параметромBitmap.smoothing
, равнымtrue
, существенно замедляет работу и не рекомендуется).
Более высокие параметры качества обеспечивают более качественную визуализацию масштабированных растровых изображений. Однако это происходит за счет увеличения нагрузки на ресурсы системы. В частности, параметр высокого качества при визуализации масштабированного видео может привести к уменьшению частоты кадров.
Метод BitmapData.draw()
использует значение свойства Stage.quality
. Или можно использовать метод BitmapData.drawWithQuality()
, который позволяет указать параметр quality
, игнорируя текущее значение Stage.quality
.
В профиле Adobe AIR для настольного компьютера можно задать для параметра quality
значение StageQuality.BEST
или StageQuality.HIGH
(значением по умолчанию является StageQuality.HIGH
). Изменение значения параметра на другое ни к чему не приводит (значение свойства остается неизменным). В профиле AIR для мобильных устройств доступны все четыре параметра качества. Значение по умолчанию для мобильных устройств StageQuality.MEDIUM
.
При работе с содержимым в Adobe AIR настройка свойства quality
одного объекта Stage приводит к изменению качества визуализации всех объектов Stage (используемых разными объектами NativeWindow).
quality
.
Реализация
public function get quality():String
public function set quality(value:String):void
Выдает
SecurityError — Вызов свойства quality объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
Связанные элементы API
scaleMode | свойство |
scaleMode:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Значение класса StageScaleMode, задающее режим масштабирования. Ниже приводятся допустимые значения.
StageScaleMode.EXACT_FIT
— Задает видимость всего приложения в указанной области. При этом исходное соотношение сторон не поддерживается. Может возникнуть искажение изображения, в результате чего приложение может выглядеть растянутым или сжатым.StageScaleMode.SHOW_ALL
— Задает видимость всего приложения в указанной области без искажений при поддержании исходного соотношения сторон приложения. С двух сторон от приложения могут появиться поля.StageScaleMode.NO_BORDER
— Задает заполнение указанной области приложением без искажений, но с возможным усечением. При этом поддерживается исходное соотношение сторон приложения.StageScaleMode.NO_SCALE
— Фиксируется размер всего приложения, так что он сохраняется даже при изменении размеров окна проигрывателя. Если окно проигрывателя меньше размеров содержимого, может возникнуть усечение.
Реализация
public function get scaleMode():String
public function set scaleMode(value:String):void
Выдает
SecurityError — Вызов метода scaleMode объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
Связанные элементы API
showDefaultContextMenu | свойство |
showDefaultContextMenu:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает отображение или скрытие элементов по умолчанию в контекстном меню среды выполнения Flash.
Если свойство showDefaultContextMenu
имеет значение true
(по умолчанию), то появляются все элементы контекстного меню. Если свойство showDefaultContextMenu
имеет значение false
, отображаются только элементы меню «Параметры» и «О проигрывателе...».
Реализация
public function get showDefaultContextMenu():Boolean
public function set showDefaultContextMenu(value:Boolean):void
Выдает
SecurityError — Вызов свойства showDefaultContextMenu объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
softKeyboardRect | свойство |
softKeyboardRect:Rectangle
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2.6, Flash Player 10.2 |
Прямоугольник, указывающий область рабочей области, которая в настоящее время закрыта программной клавиатурой. Компоненты Rect (0,0,0,0), когда мягкая клавиатура не вызывают.
Реализация
public function get softKeyboardRect():Rectangle
Связанные элементы API
stage3Ds | свойство |
stage3Ds:Vector.<Stage3D>
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 11, AIR 3 |
Список объектов Stage3D, доступных для отображения трехмерного содержимого.
Число объектов Stage3D, которые можно использовать одновременно, ограничено. Число доступных объектов Stage3D зависит от платформы и доступного аппаратного обеспечения.
Объект Stage3D отрисовывается перед объектом StageVideo и позади объектов в списке отображения Flash.
Реализация
public function get stage3Ds():Vector.<Stage3D>
Связанные элементы API
stageFocusRect | свойство |
stageFocusRect:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Определяет, должна ли отображаться светящаяся рамка вокруг объектов в фокусе.
Реализация
public function get stageFocusRect():Boolean
public function set stageFocusRect(value:Boolean):void
Выдает
SecurityError — Вызов свойства stageFocusRect объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
stageHeight | свойство |
stageHeight:int
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Текущая высота объекта Stage в пикселях.
Если задать для свойства Stage.scaleMode
значение StageScaleMode.NO_SCALE
, когда пользователь изменяет размеры окна, содержимое рабочей области сохраняет заданный размер, а свойство stageHeight
изменяется, отражая новую высоту области экрана, занимаемой SWF-файлом. (В остальных режимах масштабирования свойство stageHeight
всегда отражает исходную высоту SWF-файла.) Можно добавить прослушиватель для события resize
, а затем использовать свойство stageHeight
класса Stage, чтобы определять фактические размеры в пикселях измененного окна среды выполнения Flash. Прослушиватель событий позволяет контролировать, как содержимое экрана корректируется, когда пользователь изменяет размер окна.
Поведение устройств AIR for TV немного отличается от поведения на настольных устройствах при задании свойства stageHeight
. Если для свойства Stage.scaleMode
установлено значение StageScaleMode.NO_SCALE
и задается свойство stageHeight
, высота рабочей области не изменяется до отображения следующего кадра SWF-файла.
Примечание. На HTML-странице, содержащей SWF-файл, атрибуты height
тегов object
и embed
должны быть выражены в процентах (например, 100%
), а не в пикселях. Если параметры определяются кодом JavaScript, то параметр height
метода AC_FL_RunContent()
также необходимо настроить на представление в процентах. Эти проценты применяются к значению stageHeight
.
Реализация
public function get stageHeight():int
public function set stageHeight(value:int):void
Выдает
SecurityError — Вызов свойства stageHeight объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
Связанные элементы API
stageVideos | свойство |
stageVideos:Vector.<StageVideo>
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2.5, Flash Player 10.2 |
Список объектов StageVideo, доступных для воспроизведения внешних видеофайлов.
Число объектов StageVideo, которые можно использовать одновременно, ограничено. Во время начала выполнения SWF-файла число доступных объектов StageVideo зависит от платформы и доступного оборудования.
Для использования объекта StageVideo назначьте элементу объекта Vector stageVideos
переменную StageVideo.
Все объекты StageVideo отображаются в рабочей области позади любых экранных объектов. Все объекты StageVideo отображаются в рабочей области в порядке их появления в объекте Vector stageVideos
. Например, если объект Vector stageVideos
содержит три записи:
- Объект StageVideo, находящийся в указателе 0 объекта Vector
stageVideos
, отображается позади всех объектов StageVideo. - Объект StageVideo, находящийся в указателе 1, отображается перед объектом StageVideo в указателе 0.
- Объект StageVideo, находящийся в указателе 2, отображается перед объектом StageVideo в указателе 1.
Используйте свойство StageVideo.depth
для изменения этого порядка.
Примечание. На устройствах AIR for TV поддерживается только один объект StageVideo.
Реализация
public function get stageVideos():Vector.<StageVideo>
Связанные элементы API
Пример ( Использование этого примера )
var stageVideo:StageVideo; if ( stage.stageVideos.length >= 1 ) { stageVideo = stage.stageVideos[0]; }
stageWidth | свойство |
stageWidth:int
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Задает текущую ширину объекта Stage в пикселях.
Если задать для свойства Stage.scaleMode
значение StageScaleMode.NO_SCALE
, когда пользователь изменяет размеры окна, содержимое рабочей области сохраняет заданный размер, а свойство stageWidth
изменяется, отражая новую ширину области экрана, занимаемой SWF-файлом. (В остальных режимах масштабирования свойство stageWidth
всегда отражает исходную ширину SWF-файла.) Можно добавить прослушиватель для события resize
, а затем использовать свойство stageWidth
класса Stage, чтобы определять фактические размеры в пикселях измененного окна среды выполнения Flash. Прослушиватель событий позволяет контролировать, как содержимое экрана корректируется, когда пользователь изменяет размер окна.
Поведение устройств AIR for TV немного отличается от поведения на настольных устройствах при задании свойства stageWidth
. Если для свойства Stage.scaleMode
установлено значение StageScaleMode.NO_SCALE
и задается свойство stageWidth
, ширина рабочей области не изменяется до отображения следующего кадра SWF-файла.
Примечание. На HTML-странице, содержащей SWF-файл атрибуты width
тегов object
и embed
должны быть выражены в процентах (например, 100%
), а не в пикселях. Если параметры определяются кодом JavaScript, то параметр width
метода AC_FL_RunContent()
также необходимо настроить на представление в процентах. Эти проценты применяются к значению stageWidth
.
Реализация
public function get stageWidth():int
public function set stageWidth(value:int):void
Выдает
SecurityError — Вызов свойства stageWidth объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
Связанные элементы API
supportedOrientations | свойство |
supportedOrientations:Vector.<String>
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2.6 |
Ориентации поддержаны текущим устройством.
Вы можете использовать строки ориентации, включенные в этот список, как параметры для метода setOrientation()
. Задавание неподдерживаемой ориентации завершается неудачно без ошибки.
Возможные ориентации включают:
Константа StageOrientation | Ориентация рабочей области |
---|---|
StageOrientation.DEFAULT | Установите для рабочей области ориентацию по умолчанию (правой стороной вверх). |
StageOrientation.ROTATED_RIGHT | Задайте ориентацию рабочей области, повернув ее вправо. |
StageOrientation.ROTATED_LEFT | Задайте ориентацию рабочей области, повернув ее влево. |
StageOrientation.UPSIDE_DOWN | Задайте ориентацию рабочей области, перевернув ее сверху вниз. |
Реализация
public function get supportedOrientations():Vector.<String>
Связанные элементы API
supportsOrientationChange | свойство |
supportsOrientationChange:Boolean
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2 |
Поддерживает ли приложение изменения ориентации рабочей области (и поворот устройства). В настоящее время это свойство имеет значение true
только в приложениях AIR на мобильных устройствах.
Реализация
public static function get supportsOrientationChange():Boolean
Связанные элементы API
tabChildren | свойство |
tabChildren:Boolean
[переопределить] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Определяет, включен ли переход между дочерними элементами объекта с помощью клавиши Tab. Включает или отключает переход между дочерними объектами с помощью клавиши Tab. Значение по умолчанию — true
.
Примечание. Свойство tabChildren
не следует использовать с Flex. Вместо него следует использовать свойство mx.core.UIComponent.hasFocusableChildren
.
Реализация
override public function get tabChildren():Boolean
override public function set tabChildren(value:Boolean):void
Выдает
SecurityError — Ссылка на свойство tabChildren объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
textSnapshot | свойство |
textSnapshot:flash.text:TextSnapshot
[только для чтения] [переопределить] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.
Реализация
override public function get textSnapshot():flash.text:TextSnapshot
Выдает
IllegalOperationError — Ссылка на свойство textSnapshot объекта Stage приводит к созданию исключения, так как класс Stage не реализует это свойство. Во избежание этого нужно вызвать свойство textSnapshot контейнера экранного объекта, не содержащего объект Stage.
|
vsyncEnabled | свойство |
vsyncEnabled:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 29.0 |
Это отражает текущее состояние vsync базового графического решения. Мы можем включить или отключить vsync, чтобы сразу перейти к рендерингу, не дожидаясь активации следующего состояния VSYNC. Чтение свойства допустимо в любое время. Однако задать свойство можно только после активации VsyncStateChangeAvailabilityEvent.
Реализация
public function get vsyncEnabled():Boolean
public function set vsyncEnabled(value:Boolean):void
width | свойство |
width:Number
[переопределить] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Указывает ширину экранного объекта в пикселях. Ширина вычисляется на основе границ содержимого экранного объекта. Когда задается свойство width
, соответствующим образом изменяется и свойство scaleX
, как показано в следующем коде.
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleX) // 1; rect.width = 200; trace(rect.scaleX) // 2;
За исключением объектов TextField и Video, экранные объекты без содержимого (например, пустой спрайт), имеют ширину 0, даже если задать свойству width
другое значение.
Реализация
override public function get width():Number
override public function set width(value:Number):void
Выдает
SecurityError — Ссылка на свойство width объекта Stage приводит к созданию исключения для всех вызывающих объектов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
| |
IllegalOperationError — Абсолютно недопустимо настраивать свойство width объекта Stage, даже если вы являетесь его владельцем.
|
wmodeGPU | свойство |
wmodeGPU:Boolean
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10.0.32, AIR 1.5.2, Flash Lite 4 |
Указывает, доступен ли композитинг GPU и используется ли он в данный момент. Свойство wmodeGPU
имеет значение true
, только когда верны все три перечисленные ниже условия.
- Получен запрос на композитинг GPU.
- Композитинг GPU доступен.
- Композитинг GPU используется в данный момент.
В частности, свойство wmodeGPU
указывает на одно из следующих состояний.
- Композитинг GPU не востребован или недоступен. В этом случае свойство
wmodeGPU
имеет значениеfalse
. - Композитинг GPU востребован (если он применим и доступен), но среда работает в резервном режиме из-за ограничений содержимого (не может обеспечить оптимальную визуализацию). В этом случае свойство
wmodeGPU
имеет значениеtrue
. - Композитинг GPU востребован (если он применим и доступен), и среда работает в оптимальном режиме. В этом случае свойство
wmodeGPU
также имеет значениеtrue
.
Другими словами, свойство wmodeGPU
обозначает возможности и состояние среды визуализации. Если среда выполнения не поддерживает композитинг GPU, например AIR 1.5.2, это свойство всегда имеет значение false
, поскольку (как сказано выше) оно имеет значение true
, только когда композитинг GPU востребован, доступен и используется.
С помощью свойства wmodeGPU
во время выполнения можно определить, используется ли композитинг GPU. Значение wmodeGPU
указывает, будет ли содержимое масштабироваться аппаратными средствами, чтобы выбрать для графики правильный размер. Также можно определить, быстро или медленно выполняется визуализация, чтобы соответствующим образом скорректировать сложность содержимого.
Если Flash Player встроен в браузер, композитинг GPU может быть востребован с помощью значения gpu
, присвоенного параметру HTML wmode
на странице, содержащей SWF-файл. Для других конфигураций запрос на композитинг GPU можно добавить в заголовок SWF-файла (с помощью инструментов разработки SWF).
Однако свойство wmodeGPU
не позволяет определить текущее быстродействие визуализации. Даже если композитинг GPU используется, процесс визуализации может выполняться не в оптимальном режиме. Чтобы скорректировать содержимое для оптимальной визуализации, следует использовать отладочную версию среды выполнения Flash и задать свойство DisplayGPUBlendsetting
в файле mm.cfg.
Примечание. Это свойство всегда имеет значение false
, когда на него ссылается код ActionScript, исполняемый до того, как среда выполнения осуществляет первый прогон визуализации. Например, если выполняется анализ wmodeGPU
из сценария кадра 1 в Adobe Flash Professional и ваш SWF-файл является первым SWF-файлом, загруженным в новый экземпляр среды выполнения, тогда wmodeGPU
будет иметь значение false
. Чтобы получить точное значение, дождитесь, когда будет выполнен хотя бы один прогон визуализации. Если создан прослушиватель для события exitFrame
любого объекта DisplayObject
, то свойство wmodeGPU
возвращает правильное значение.
Реализация
public function get wmodeGPU():Boolean
Связанные элементы API
Пример ( Использование этого примера )
wmodeGPU
анализируется после визуализации экранного объекта mySprite с целью получения точного значения.
mySprite.addEventListener(EXIT_FRAME, exithandler): function exithandler(exiteventobject:Event):void { trace(stage.wmodeGPU); }
addChild | () | метод |
override public function addChild(child:DisplayObject):DisplayObject
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. Дочерний элемент добавляется перед (сверху) всеми остальными дочерними элементами в данном экземпляре DisplayObjectContainer. (Чтобы добавить дочерний элемент в конкретную позицию в индексе, используйте метод addChildAt()
.)
При добавлении дочернего объекта, уже имеющего отличный от других контейнер объекта отображения в качестве родительского элемента, объект удаляется из списка дочерних элементов другого контейнера объекта отображения.
Примечание. Команда stage.addChild()
может вызвать проблемы с опубликованным SWF-файлом, включая проблемы безопасности и конфликты с другими загруженными SWF-файлами. В экземпляре среды выполнения Flash есть только одна рабочая область независимо от числа загружаемых SWF-файлов. Так, как правило, объекты совсем не следует добавлять в рабочую область напрямую. Рабочая область должна содержать только корневой объект. Создайте объект DisplayObjectContainer, который будет содержать все элементы списка отображения. Затем, при необходимости, добавьте этот экземпляр DisplayObjectContainer в рабочую область.
Параметры
child:DisplayObject — Экземпляр DisplayObject для добавления в качестве нижестоящего элемента экземпляра DisplayObjectContainer.
|
DisplayObject — Экземпляр DisplayObject, передаваемый в параметр child .
|
Выдает
SecurityError — Вызов метода addChild() объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
addChildAt | () | метод |
override public function addChildAt(child:DisplayObject, index:int):DisplayObject
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. Дочерний элемент добавляется к указанной позиции индекса. Индекс 0 представляет собой заднюю (нижнюю) часть списка отображения для объекта DisplayObjectContainer.
Так, в следующем примере представлено три объекта отображения с метками а, b и c в позициях индекса 0, 1 и 2 соответственно.
При добавлении дочернего объекта, уже имеющего отличный от других контейнер объекта отображения в качестве родительского элемента, объект удаляется из списка дочерних элементов другого контейнера объекта отображения.
Параметры
child:DisplayObject — Экземпляр DisplayObject для добавления в качестве нижестоящего элемента экземпляра DisplayObjectContainer.
| |
index:int — Позиция индекса для добавления нижестоящего элемента. При указании занятой в настоящее время позиции индекса существующий в данной позиции дочерний объект и все вышестоящие позиции перемещаются по списку на одну позицию вверх.
|
DisplayObject — Экземпляр DisplayObject, передаваемый в параметр child .
|
Выдает
SecurityError — Вызов метода addChildAt() объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
addEventListener | () | метод |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. Можно регистрировать прослушиватели событий в любом узле из списка отображения для каждого типа события, фазы и приоритета.
После успешной регистрации прослушивателя событий невозможно изменить его приоритет путем дополнительных вызовов addEventListener()
. Чтобы изменить приоритет прослушивателя, необходимо сначала вызвать метод removeListener()
. Затем можно снова зарегистрировать прослушиватель с новым приоритетом.
Следует учесть, что после регистрации прослушивателя последующие вызовы метода addEventListener()
с другим значением свойства type
или useCapture
приводят к регистрации другого прослушивателя. Например, прослушиватель, изначально зарегистрированный со значением useCapture
, равным true
, прослушивает только во время фазы захвата. Если вызвать метод addEventListener()
еще раз с тем же объектом прослушивателя, но со свойством useCapture
в значении false
, то будет два прослушивателя: один — прослушивающий в фазе захвата, а другой — в целевой фазе и фазе восходящей цепочки.
Невозможно зарегистрировать прослушиватель события только для целевой фазы или для фазы восходящей цепочки. Эти фазы соединены при регистрации, поскольку восходящая цепочка применяется только к предшественникам целевого узла.
Если прослушиватель событий больше не нужен, его можно удалить, вызвав метод removeEventListener()
, иначе могут возникнуть проблемы с памятью. Прослушиватели событий не удаляются из памяти автоматически, так как сборщик мусора не удаляет прослушиватель, пока существует объект, отправляющий соответствующее событие (если параметру useWeakReference
не задано значение true
).
Копирование экземпляра EventDispatcher не приводит к копированию прослушивателей событий, присоединенных к нему. (Если для вновь создаваемого узла требуется прослушиватель событий, его необходимо присоединить после создания узла.) При этом при перемещении экземпляра EventDispatcher присоединенные к нему прослушиватели событий перемещаются вместе с ним.
Если прослушиватель регистрируется для узла в тот момент, когда на нем обрабатывается событие, то в текущей фазе он не запускается, однако может запуститься в следующей фазе потока события, например в фазе восходящей цепочки.
Прослушиватель событий, удаленный из узла во время обработки события на этом узле, будет запускаться текущими операциями. После удаления прослушиватель событий больше не вызывается (если не будет снова зарегистрирован для дальнейшей обработки).
Параметры
type:String — Тип события.
| |
listener:Function — Функция прослушивателя, обрабатывающая событие. Эта функция должна принимать объект Event в качестве единственного параметра и не должна что-либо возвращать , как показано в примере:
function(evt:Event):void Эта функция может иметь любое имя. | |
useCapture:Boolean (default = false ) —
Определяет, работает ли прослушиватель в фазе захвата или в целевой фазе и в фазе восходящей цепочки. Если значение useCapture равно true , прослушиватель обрабатывает событие только во время фазы захвата, но не во время целевой фазы или фазы восходящей цепочки. Если значение useCapture равно false , то прослушиватель обрабатывает событие только в целевой фазе или фазе восходящей цепочки. Чтобы прослушивать событие во всех трех фазах, необходимо вызвать addEventListener() дважды: один раз с useCapture в значении true , а другой — с useCapture в значении false .
| |
priority:int (default = 0 ) — Уровень приоритета прослушивателя событий. Приоритет определяется 32-разрядным целым числом со знаком. Чем больше число, тем выше приоритет. Все прослушиватели событий с приоритетом n обрабатываются перед прослушивателями с приоритетом n-1. Прослушиватели с одинаковым приоритетом обрабатываются в порядке их добавления. Значение приоритета по умолчанию равно 0.
| |
useWeakReference:Boolean (default = false ) — Определяет, является ли ссылка на прослушиватель «сильной» или «слабой». «Сильная» ссылка (по умолчанию) предотвращает удаление прослушивателя сборщиком мусора. «Слабая» ссылка позволяет удалить прослушиватель. Функции элементов уровня класса не подлежат удалению в качестве мусора, вследствие чего можно установить |
Выдает
SecurityError — Вызов метода addEventListener объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этой ситуации владелец объекта Stage должен предоставить разрешение домену вызывающего файла путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
assignFocus | () | метод |
public function assignFocus(objectToFocus:InteractiveObject, direction:String):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0 |
Устанавливает фокус клавиатуры на интерактивном объекте, указанном в objectToFocus
. Направление фокуса устанавливается параметром direction
.
Направление фокуса должно задаваться приложением (или средой приложения). Как такового встроенного принципа расположения интерактивных объектов не существует, однако, для их упорядочения можно использовать ряд доступных свойств. Например, можно сортировать интерактивные объекты в рабочей области по их положению в списке отображения. Вызов метода assignFocus()
идентичен параметру свойства Stage.focus
с дополнительной возможностью указывать направление, откуда этот фокус поступает.
После получения фокуса objectToFocus
отправляет событие focusIn
. Свойство direction
объекта FocusEvent сообщает о настройке параметра direction
.
При назначении объекта HTMLLoader параметру objectToFocus
объект HTMLLoader выбирает подходящий объект для передачи фокуса в HTML DOM, принимая во внимание значение параметра direction
. При использовании FocusDirection.BOTTOM
фокус передается объекту в HTML DOM, который находится в конце списка отображения. При использовании FocusDirection.TOP
фокус передается объекту в HTML DOM, который находится в начале списка отображения. При использовании NONE
объект HTMLLoader получает фокус, а его текущий элемент с фокусом не меняется.
Параметры
objectToFocus:InteractiveObject — Объект, на который следует переместить фокус или null , чтобы убрать фокус с любого элемента в рабочей области.
| |
direction:String — Направление, по которому фокусируется objectToFocus . Подходящие значения перечислены в виде констант в классе FocusDirection.
|
Выдает
Error — Если фокус не может быть установлен на цели, или тип направления неверный.
|
Связанные элементы API
dispatchEvent | () | метод |
override public function dispatchEvent(event:Event):Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Посылает событие в поток событий. Целью события является объект EventDispatcher, для которого вызывается метод dispatchEvent()
.
Параметры
event:Event — Объект события, передаваемый в поток событий. Если осуществляется повторная отправка события, автоматически создается его клон. После отправки события нельзя изменить его свойство target , поэтому необходимо создать новую копию события, чтобы обеспечить правильное выполнение повторной отправки.
|
Boolean — Значение true в случае успешной передачи события. Значение false указывает на ошибку или на то, что для события был вызван метод preventDefault() .
|
Выдает
SecurityError — Вызов метода dispatchEvent() объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
hasEventListener | () | метод |
override public function hasEventListener(type:String):Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. Это позволяет определить, где объект EventDispatcher изменил обработку типа события в иерархии потока событий. Чтобы определить, запускает ли на самом деле определенный тип событий прослушиватель, используйте метод willTrigger()
.
Различие между hasEventListener()
и willTrigger()
заключается в том, что hasEventListener()
анализирует только объект, к которому он принадлежит, тогда как willTrigger()
— весь поток событий для события, указанного параметром type
.
Когда метод hasEventListener()
вызывается из объекта LoaderInfo, учитываются только те прослушиватели, к которым есть доступ у вызывающего объекта.
Параметры
type:String — Тип события.
|
Boolean — Значение true , если прослушиватель указанного типа зарегистрирован; в противном случае – false .
|
Выдает
SecurityError — Вызов метода hasEventListener() объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
invalidate | () | метод |
public function invalidate():void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Вызов метода invalidate()
предписывает среде выполнения Flash оповестить экранные объекты о следующей возможности визуализации списка отображения (например, когда точка воспроизведения приближается к новому кадру). После вызова метода invalidate()
при дальнейшей визуализации списка отображения среда выполнения Flash отправляет событие render
каждому экранному объекту, зарегистрированному для прослушивания события render
. Метод invalidate()
необходимо вызвать каждый раз, когда нужно, чтобы среда выполнения Flash отправляла события render
.
Событие render
дает возможность вносить изменения в список отображения непосредственно перед его визуализацией. Это позволяет откладывать обновления списка отображения до самой последней возможности. Это может увеличить производительность путем предотвращения ненужных обновлений экрана.
Событие render
отправляется только тем экранным объектам, которые находятся в том же защищенном домене, что и код, вызывающий метод stage.invalidate()
, или экранным объектам из защищенного домена, которому предоставлено разрешение через метод Security.allowDomain()
.
Связанные элементы API
isFocusInaccessible | () | метод |
public function isFocusInaccessible():Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Определяет, должно ли свойство Stage.focus
возвращать значение null
по соображениям безопасности. Другими словами, isFocusInaccessible
имеет значение true
, если объект в фокусе принадлежит к изолированной программной среде безопасности, к которой у SWF-файла нет доступа.
Boolean — true , если объект в фокусе принадлежит к изолированной программной среде безопасности, к которой у SWF-файла нет доступа.
|
removeChildAt | () | метод |
override public function removeChildAt(index:int):DisplayObject
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Удаляет дочерний DisplayObject из заданной позиции index
в списке дочерних объектов DisplayObjectContainer. Свойство parent
удаленного дочернего элемента получает значение null
, а сам объект очищается, если нет других ссылок на дочерние элементы. Позиции индекса экранных объектов, расположенных над дочерним элементом в DisplayObjectContainer уменьшаются на 1.
Сборщик мусора перераспределяет неиспользуемый объем памяти. Когда на переменную или объект больше нет ссылок или он хранится в другом месте, сборщик мусора очищает и утилизирует память, которую он занимал, при условии отсутствия ссылок
Параметры
index:int — Удаляемый индекс нижестоящего элемента DisplayObject.
|
DisplayObject — Удаленный экземпляр DisplayObject.
|
Выдает
SecurityError — Вызов метода removeChildAt() объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец данного объекта может предоставить разрешение домену вызывающего файла путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
setAspectRatio | () | метод |
public function setAspectRatio(newAspectRatio:String):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2 |
Готовит почву к ориентации с указанными пропорциями.
Если изменения ориентации рабочей область в результате вызова метода, объект Stage отправляет orientationChange событие.
Чтобы узнать, поддерживается ли ориентация устройства, проверьте значение свойства Stage.supportsOrientantionChange
.
Поддержка в профилях AIR: эта функция поддерживается на мобильных устройствах, но не поддерживается в компьютерных операционных системах или на устройствах AIR for TV. Используйте свойство Stage.supportsOrientantionChange
, чтобы проверить наличие поддержки в среде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».
Параметры
newAspectRatio:String — Код типа для заданных пропорций (StageAspectRatio.PORTRAIT , StageAspectRatio.LANDSCAPE или StageAspectRatio.ANY ).
|
Выдает
ArgumentError — Значение, переданное в качестве параметра newAspectRatio , недействительно. Значение должно соответствовать одной из констант, определенных в классе StageAspectRatio.
|
Связанные элементы API
setChildIndex | () | метод |
override public function setChildIndex(child:DisplayObject, index:int):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Изменяет положение существующего дочернего элемента в DisplayObjectContainer. Это отражается на иерархическом представлении дочерних объектов. Так, в следующем примере показано три разных объекта с именами a, b и c в позициях индекса 0, 1 и 2 соответственно.
Когда используется метод setChildIndex()
и указывается уже занятая позиция индекса, меняются только позиции между прежней и новой позицией экранного объекта. Все остальные остаются без изменения. Если дочерний объект перемещается на более НИЗКУЮ позицию, позиции всех дочерних объектов между этими позициями станут на 1 ВЫШЕ. Если дочерний объект перемещается на более ВЫСОКУЮ позицию, позиции всех дочерних объектов между этими позициями станут на 1 НИЖЕ. Например, если контейнер экранных объектов из предыдущего примера имеет имя container
, можно поменять позициями экранные объекты с именами a и b, вызвав следующий код:
container.setChildIndex(container.getChildAt(1), 0);
В результате этого объекты выстраиваются следующим образом:
Параметры
child:DisplayObject — Дочерний экземпляр DisplayObject, для которого нужно изменить номер индекса.
| |
index:int — Полученный в результате номер индекса для дочернего экранного объекта child .
|
Выдает
SecurityError — Вызов метода addChildIndex() объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
setOrientation | () | метод |
public function setOrientation(newOrientation:String):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2 |
Устанавливает рабочую область в указанную ориентацию.
Задайте параметру newOrientation
одно из четырех значений, выраженных константами класса StageOrientation:
Константа StageOrientation | Ориентация рабочей области |
---|---|
StageOrientation.DEFAULT | Установите для рабочей области ориентацию по умолчанию (правой стороной вверх). |
StageOrientation.ROTATED_RIGHT | Задайте ориентацию рабочей области, повернув ее вправо. |
StageOrientation.ROTATED_LEFT | Задайте ориентацию рабочей области, повернув ее влево. |
StageOrientation.UPSIDE_DOWN | Задайте ориентацию рабочей области, перевернув ее сверху вниз. |
Не задавайте параметру значение StageOrientation.UNKNOWN
или строковое значение, которого нет в таблице.
Чтобы узнать, поддерживается ли изменение ориентации устройства, проверьте значение свойства Stage.supportsOrientantionChange
. Проверьте список, обеспеченный supportedOrientations
свойства, чтобы задать, какие ориентации поддержаны текущим устройством.
Операция установки ориентации является асинхронной. Нельзя гарантировать ее выполнение сразу после вызова метода setOrientation()
. Добавьте прослушиватель событий для события orientationChange
, чтобы определить момент завершения изменения ориентации.
Важный: setOrientation()
метод не был поддержан на устройствах Андроида перед AIR 2.6.
setOrientation()
не приводит к прекращению отправки события orientationChanging
.
Параметры
newOrientation:String — Новая ориентация рабочей области.
|
События
orientationChange: — Размер рабочей области изменен в результате вызова метода setOrientation() .
|
Выдает
ArgumentError — Значение, переданное в качестве параметра newOrientation , недействительно. Значение должно соответствовать одной из констант, определенных в классе StageOriention, за исключением константы StageOrientation.UNKNOWN .
|
Связанные элементы API
swapChildrenAt | () | метод |
override public function swapChildrenAt(index1:int, index2:int):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних объектов. Все остальные дочерние объекты в контейнере экранных объектов остаются на прежних позициях.
Параметры
index1:int — Позиция индекса первого дочернего объекта.
| |
index2:int — Позиция индекса второго дочернего объекта.
|
Выдает
SecurityError — Вызов метода swapChildrenAt() объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владельцы объекта могут предоставить разрешение домену вызывающего файла путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
willTrigger | () | метод |
override public function willTrigger(type:String):Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. Этот метод возвращает значение true
, если прослушиватель события запускается в течение любой фазы потока событий, когда событие указанного типа передается объекту EventDispatcher или любому из его нижестоящих элементов.
Разница между методами hasEventListener()
и willTrigger()
заключается в том, что hasEventListener()
просматривает только тот объект, которому он принадлежит, а willTrigger()
просматривает весь поток событий для события, указанного в параметре type
.
Когда метод willTrigger()
вызывается из объекта LoaderInfo, учитываются только те прослушиватели, к которым есть доступ у вызывающего объекта.
Параметры
type:String — Тип события.
|
Boolean — Значение равно true при запуске прослушивателя указанного типа; в противном случае значение равно false .
|
Выдает
SecurityError — Вызов метода willTrigger() объекта Stage приводит к созданию исключения для всех вызывающих файлов, находящихся не в той же изолированной программной среде безопасности, что и владелец объекта Stage (главный SWF-файл). Во избежание этого владелец объекта Stage может предоставить разрешение домену вызывающего объекта путем вызова метода Security.allowDomain() или метода Security.allowInsecureDomain() . Дополнительные сведения см. в главе «Безопасность» в Руководстве разработчика по ActionScript 3.0.
|
browserZoomChange | Событие |
flash.events.Event
свойство Event.type =
flash.events.Event.BROWSER_ZOOM_CHANGE
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 15 |
Отправляется при изменении свойства browserZoomFactor
для объекта Stage.
Event.BROWSER_ZOOM_CHANGE
определяет значение свойства type
объекта события browserZoomChange
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Экземпляр в рабочей области. |
fullScreen | Событие |
flash.events.FullScreenEvent
свойство FullScreenEvent.type =
flash.events.FullScreenEvent.FULL_SCREEN
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Отправляется, когда объект Stage переходит в полноэкранный режим или выходит из этого режима. Изменение в полноэкранном режиме можно инициировать через ActionScript, либо при нажатии комбинации клавиш пользователем, либо если текущий фокус покидает окно, находящееся в полноэкранном режиме.
КонстантаFullScreenEvent.FULL_SCREEN
определяет значение свойства type
для объекта события fullScreen
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
fullScreen | true , если состояние отображения — на весь экран или false , если состояние обычное. |
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект Stage. |
mouseLeave | Событие |
flash.events.Event
свойство Event.type =
flash.events.Event.MOUSE_LEAVE
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется объектом Stage, когда указатель покидает рабочую область. Если кнопка мыши нажата, событие не отправляется.
КонстантаEvent.MOUSE_LEAVE
определяет значение свойства type
объекта события mouseLeave
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект Stage. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
orientationChange | Событие |
flash.events.StageOrientationEvent
свойство StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGE
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2.0 |
Отправляется объектом Stage при изменении ориентации рабочей области.
Ориентация может изменяться, когда пользователь поворачивает устройство или открывает выдвижную клавиатуру либо вызывается функция setAspectRatio()
.
Примечание. Если для свойства autoOrients
установлено значение false
, ориентация рабочей области не изменяется при повороте устройства. Таким образом, события StageOrientationEvents отправляются при повороте устройства, только когда для свойства autoOrients
установлено значение true
.
ORIENTATION_CHANGE
определяет значение свойства type
объекта события orientationChange
. Это событие имеет следующие свойства:
Свойства | Значения |
---|---|
afterOrientation | Новая ориентация рабочей области. |
beforeOrientation | Старая ориентация рабочей области. |
target | Объект Stage, отправивший изменение ориентации. |
bubbles | true |
currentTarget | Указывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
cancelable | false ; он должен слишком поздно отменить изменение. |
orientationChanging | Событие |
flash.events.StageOrientationEvent
свойство StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGING
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 2.0 |
Отправляется объектом Stage, когда начинается изменение ориентации рабочей области.
Важный: события orientationChanging не отправлены на устройствах Андроида.
Примечания.
-
Если для свойства
autoOrients
установлено значениеfalse
, ориентация рабочей области не изменяется при повороте устройства. Таким образом, события StageOrientationEvents отправляются при повороте устройства, только когда для свойстваautoOrients
установлено значениеtrue
. -
Когда ориентация задается программным путем с помощью метода
setOrientation()
, событиеorientationChanging
не отправляется.
ORIENTATION_CHANGING
определяет значение свойства type
объекта события orientationChanging
. Это событие имеет следующие свойства:
Свойства | Значения |
---|---|
afterOrientation | Новая ориентация рабочей области. |
beforeOrientation | Старая ориентация рабочей области. |
target | Объект Stage, отправивший изменение ориентации. |
bubbles | true |
currentTarget | Указывает объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
cancelable | true . |
resize | Событие |
flash.events.Event
свойство Event.type =
flash.events.Event.RESIZE
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Отправляется, когда свойство scaleMode
объекта Stage установлено в значение StageScaleMode.NO_SCALE
и изменяется размер SWF-файла. Также отправляется в случае изменения ориентации экрана в полноэкранном режиме Flash Player 15 и более поздних версий.
Event.RESIZE
определяет значение свойства type
объекта события resize
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект Stage. |
stageVideoAvailability | Событие |
flash.events.StageVideoAvailabilityEvent
свойство StageVideoAvailabilityEvent.type =
flash.events. StageVideoAvailabilityEvent. STAGE_VIDEO_AVAILABILITY
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 10.2 |
Отправленный объектом Stage, когда состояние stageVideos изменений свойств.
Пример ( Использование этого примера )
StageExample
для отправки событий при активации или изменении размера рабочей области. Это можно сделать, выполнив следующие действия.
- Сначала конструктор класса настраивает приложение Flash для фиксации, независимо от размера окна проигрывателя Flash Player, а затем добавляет два прослушивателя событий с методами
activateHandler()
иresizeHandler()
. - Метод
activateHandler()
запускается при щелчке левой кнопкой мыши. - Метод
resizeHandler()
запускается при изменении размеров рабочего стола.
package { import flash.display.Sprite; import flash.display.StageAlign; import flash.display.StageScaleMode; import flash.events.Event; public class StageExample extends Sprite { public function StageExample() { stage.scaleMode = StageScaleMode.NO_SCALE; stage.align = StageAlign.TOP_LEFT; stage.addEventListener(Event.ACTIVATE, activateHandler); stage.addEventListener(Event.RESIZE, resizeHandler); } private function activateHandler(event:Event):void { trace("activateHandler: " + event); } private function resizeHandler(event:Event):void { trace("resizeHandler: " + event); trace("stageWidth: " + stage.stageWidth + " stageHeight: " + stage.stageHeight); } } }
VsyncStateChangeAvailability | Событие |
flash.events.VsyncStateChangeAvailabilityEvent
свойство VsyncStateChangeAvailabilityEvent.type =
flash.events.VsyncStateChangeAvailabilityEvent
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 29.0 |
Отправлено объектом Stage при изменении состояния свойства vsync.
Определяет значение свойства type объекта события VsyncStateChangeAvailabilityEvent
.
Пример ( Использование этого примера )
VsyncExample
используется для отправки событий при включении или отключении состояния vsync Stage. Это можно сделать, выполнив следующие действия.
- Конструктор сначала запускает событие Stage
VsyncStateChangeAvailabilityEvent
. - После этого вызывается метод
onVsyncStateChangeAvailability
, в котором проверяется, доступно ли свойствоVsyncStateChangeAvailabilityEvent
. - Если оно доступно, можно переключить состояние vsync Stage, иначе свойство
vsyncEnable
будет доступно только для чтения. - Значение vsync enable можно активировать, только если запущено событие.
package { import flash.display.Sprite; import flash.events.VsyncStateChangeAvailabilityEvent public class VsyncExample extends Sprite { public function VsyncExample() { stage.addEventListener(VsyncStateChangeAvailabilityEvent.VSYNC_STATE_CHANGE_AVAILABILITY, onVsyncStateChangeAvailability); } public function onVsyncStateChangeAvailability(event:VsyncStateChangeAvailabilityEvent):void { if (event.available) { // vsyncEnabled is now changeable and can be turned off. stage.vsyncEnabled = false; // Now, AS can change VSYNC state because event.available is true trace("vsyncEnabled of Stage object is changeable"); } else { // vsyncEnabled is not changeable now. This could be due to fallback to software rendering, for example. stage.vsyncEnabled = false; // This will be ignored because event.available is now false trace("vsyncEnabled of Stage object is read-only"); trace("Current value of vsyncEnabled of Stage object is "+ stage.vsyncEnabled); } } } }
Tue Jun 12 2018, 11:34 AM Z