| Пакет | flash.events |
| Класс | public class ThrottleEvent |
| Наследование | ThrottleEvent  Event Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 11, AIR 3.2 |
ThrottleEvent.THROTTLE.
Это многоадресное событие, которое отправляется всеми объектами EventDispatcher, для которых зарегистрированы прослушиватели данного события. Дополнительную информацию о многоадресных событиях см. в описании класса DisplayObject.
Примечание. Это событие не имеет фазы захвата и фазы восходящей цепочки, поэтому отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.
Flash Player может переключать содержимое на низкую частоту кадров (частота кадров уменьшается до значения от 2 до 8 кадров/с). Содержимое может переключаться на другую частоту кадров, когда его вкладка скрыта или свернута. На мобильном устройстве содержимое может переключаться на другую частоту кадров, когда выключается подсветка или становится активным режим заставки. Перед переключением содержимого на другую частоту кадров отправляется событие ThrottleEvent со свойством ThrottleEvent.state=ThrottleType.THROTTLE. Свойство ThrottleEvent.targetFrameRate содержит значение новой целевой частоты кадров.
Содержимое может выполнить код в прослушивателе событий для подготовки к переключению частоты кадров. Это позволяет предупредить внешнее содержимое о том, что переключенное содержимое будет реагировать медленней. Например активный метод FileReference.upload() или FileReference.download() может быть отменен. Или, если содержимое поддерживает связь с помощью LocalConnection с другим SWF-файлом, это позволяет сообщить этому SWF-файлу ожидать более медленный отклик. Обратите внимание, что переключенное содержимое может быть не в состоянии завершить асинхронные операции, начатые до переключения. Содержимое переходит в переключенное состояние после возвращения из прослушивателя события.
Flash Player может приостанавливать содержимое. Например, содержимое может приостанавливаться, если оно переносится за пределы экрана на мобильном устройстве в момент, когда не воспроизводится аудио или видео. Перед приостановкой содержимого отправляется событие ThrottleEvent со свойствами ThrottleEvent.state=ThrottleType.PAUSE и ThrottleEvent.targetFrameRate=0. Так же, как при получении события ThrottleType.THROTTLE, содержимое может выполнить код в прослушивателе событий, чтобы подготовить приостановку. После возврата из прослушивателя событий содержимое переходит в приостановленное состояние. Во время паузы содержимое не отвечает на действия пользователя, например на щелчки мыши или ввод с клавиатуры. Тем не менее, события сети ActionScript могут по-прежнему поступать.
Когда Flash Player возобновляет воспроизведение содержимого после переключения скорости потока или паузы, отправляется событие ThrottleEvent со свойством ThrottleEvent.state=ThrottleType.RESUME. ThrottleEvent.targetFrameRate описывает частоту кадров и обычно имеет такое же значение, как и Stage.frameRate. Содержимое может быть возобновлено, когда какая-либо часть рабочей области становится видимой или когда пользователь запрашивает возобновление содержимого.
В настоящее время регулирование скорости потока и приостановка поддерживаются следующими платформами: Flash Player Desktop для Mac и Windows, AIR Mobile, Flash Player для Android. Следующие платформы не отправляют автоматически событие ThrottleEvent, потому что они еще не поддерживают приостановку или изменение скорости потока: устройства AIR for TV, AIR for desktop и Flash Player Desktop для Linux.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | |
| cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | |
| eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | |
| state : String [только для чтения]
Описывает состояние, в которое переходит проигрыватель: ThrottleType.THROTTLE, ThrottleType.PAUSE или ThrottleType.RESUME. | ThrottleEvent | ||
| target : Object [только для чтения]
Целевой объект события. | Event | |
| targetFrameRate : Number [только для чтения]
Целевая частота кадров, которую устанавливает Flash Player или AIR после отправки события ThrottleEvent. | ThrottleEvent | ||
| type : String [только для чтения]
Тип события. | Event | |
| Метод | Определено | ||
|---|---|---|---|
ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)
Создает объект Event, содержащий данные о событии ThrottleEvent. | ThrottleEvent | ||
[переопределить]
Создает копию объекта ThrottleEvent и задает значение каждого свойства, совпадающее с оригиналом. | ThrottleEvent | ||
|
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | |
|
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
[переопределить]
Возвращает строку, содержащую все свойства объекта ThrottleEvent. | ThrottleEvent | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
| Константа | Определено | ||
|---|---|---|---|
| THROTTLE : String = "throttle" [статические]
Определяет значение свойства type объекта события ThrottleEvent. | ThrottleEvent | ||
state | свойство |
state:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 11, AIR 3.2 |
Описывает состояние, в которое переходит проигрыватель: ThrottleType.THROTTLE, ThrottleType.PAUSE или ThrottleType.RESUME.
Реализация
public function get state():StringСвязанные элементы API
targetFrameRate | свойство |
targetFrameRate:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 11, AIR 3.2 |
Целевая частота кадров, которую устанавливает Flash Player или AIR после отправки события ThrottleEvent.
Например, если содержимое приостановлено, то targetFrameRate будет равно 0. Если содержимое переключено на низкую частоту кадров, то targetFrameRate, как правило, составляет от 2 до 8 в зависимости от того, на какой платформе выполняется содержимое, воспроизводится ли аудио, а также от других факторов. Если содержимое возвращается к ожидаемой частоте кадров после приостановки или переключения частоты кадров, то targetFrameRate будет равняться Stage.frameRate.
Реализация
public function get targetFrameRate():NumberСвязанные элементы API
ThrottleEvent | () | Конструктор |
public function ThrottleEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, state:String = null, targetFrameRate:Number = 0)| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 11, AIR 3.2 |
Создает объект Event, содержащий данные о событии ThrottleEvent. Объекты Event передаются прослушивателям событий в качестве параметров.
Параметрыtype:String — Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события ThrottleEvent: ThrottleEvent.THROTTLE.
| |
bubbles:Boolean (default = false)bubbles.
| |
cancelable:Boolean (default = false)cancelable.
| |
state:String (default = null)ThrottleType.THROTTLE, ThrottleType.PAUSE или ThrottleType.RESUME.
| |
targetFrameRate:Number (default = 0)targetFrameRate будет равно 0. Если содержимое переключено на низкую частоту кадров, то targetFrameRate, как правило, составляет от 2 до 8 в зависимости от того, на какой платформе выполняется содержимое, воспроизводится ли аудио, а также от других факторов. Если содержимое возвращается к ожидаемой частоте кадров после приостановки или переключения частоты кадров, то targetFrameRate будет равняться Stage.frameRate.
|
Связанные элементы API
clone | () | метод |
override public function clone():Event| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 11, AIR 3.2 |
Создает копию объекта ThrottleEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект ThrottleEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 11, AIR 3.2 |
Возвращает строку, содержащую все свойства объекта ThrottleEvent. Строка имеет следующий формат:
[ThrottleEvent type=value bubbles=value cancelable=value state=value targetFrameRate=value]
String — Строка, содержащая все свойства объекта ThrottleEvent.
|
THROTTLE | Константа |
public static const THROTTLE:String = "throttle"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 11, AIR 3.2 |
Определяет значение свойства type объекта события ThrottleEvent.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Любой экземпляр DisplayObject, для которого зарегистрирован прослушиватель события ThrottleEvent. |
state | ThrottleType.THROTTLE, ThrottleType.PAUSE или ThrottleType.RESUME. |
targetFrameRate | Описывает частоту кадров, которую устанавливает Flash Player или AIR после отправки события ThrottleEvent. Например, если содержимое приостановлено, то targetFrameRate будет 0. Если содержимое переключено на низкую скорость потока, то targetFrameRate, как правило, составляет от 2 до 8 в зависимости от того, на какой платформе выполняется содержимое, воспроизводится ли аудио, а также от других факторов. Если содержимое возвращается к ожидаемой частоте кадров после приостановки или переключения частоты кадров, то targetFrameRate будет равняться Stage.frameRate. |
Связанные элементы API
Tue Jun 12 2018, 11:34 AM Z