Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.ui 

GameInputControl  - AS3

Пакетflash.ui
Классpublic dynamic class GameInputControl
НаследованиеGameInputControl Inheritance EventDispatcher Inheritance Object

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

Класс GameInputControl представляет элемент управления на устройстве ввода. API-интерфейс GameInput сопоставляет физические элементы управления на устройстве с простыми логическими элементами управления.

Получение значений элементов управления:

Свойство value возвращает текущее значение элемента управления. Этот метод не возвращает самое последнее значение непосредственно из элемента управления. Вместо этого он возвращает значение, которое было сохранено в кэше при последней выборке.

Получить значения отдельного элемента управления можно тремя способами.

  1. Опрос: вызывайте метод value каждый раз, когда требуется получить последнее известное значение для элемента управления.
  2. События изменения: регистрируйте событие изменения для элемента управления. Событие Event.CHANGE отправляется при каждом изменении значения элемента управления. Получив событие, вызовите метод value, чтобы извлечь значение элемента управления, отправившего событие.
  3. Кэширование значений выборки: кэширование выполняется на уровне устройства. Дополнительные сведения о кэшировании и извлечении значений элементов управления из выборки см. в документации по классу GameInputDevice.

При попытке прочитать значения элементов управления выключенного устройства метод value выдает исключение IOError. Однако можно получить доступ к свойствам, описывающим элемент управления (таким как id, minValue и maxValue), даже если устройство не включено. Эта возможность позволяет определить, соответствует ли устройство потребностям приложения, не включая его.

Дополнительные сведения см. в статье Adobe Air Developer Center Игровые контроллеры на Adobe AIR.

Для устройств Android эта функция поддерживает ОС Android начиная с версии 4.1 и требует SWF начиная с версии 20 и пространство имен 3.7. Для устройств iOS эта функция поддерживает ОС iOS начиная с версии 9.0 и требует SWF начиная с версии 34 и пространство имен 23.0.

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



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
      device : GameInputDevice
[только для чтения] Возвращает объект GameInputDevice, содержащий этот элемент управления.
GameInputControl
      id : String
[только для чтения] Возвращает идентификатор этого элемента управления.
GameInputControl
      maxValue : Number
[только для чтения] Возвращает максимальное значение для этого элемента управления.
GameInputControl
      minValue : Number
[только для чтения] Возвращает минимальное значение для этого элемента управления.
GameInputControl
      value : Number
[только для чтения] Возвращает значение для этого элемента управления.
GameInputControl
Общедоступные методы
 МетодОпределено
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
  Отправляется при изменении значения элемента управления.GameInputControl
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
Сведения о свойстве
    

device

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

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

Возвращает объект GameInputDevice, содержащий этот элемент управления.



Реализация
    public function get device():GameInputDevice
    

id

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

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

Возвращает идентификатор этого элемента управления.



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

maxValue

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

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

Возвращает максимальное значение для этого элемента управления.



Реализация
    public function get maxValue():Number
    

minValue

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

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

Возвращает минимальное значение для этого элемента управления.



Реализация
    public function get minValue():Number
    

value

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

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

Возвращает значение для этого элемента управления.



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

Выдает
IOError — Когда метод value вызывается при выключенном устройстве.
Сведения о событии

change

Событие
Тип объекта события: flash.events.Event

Отправляется при изменении значения элемента управления.





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

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