Пакет | flash.text |
Класс | public final class StageText |
Наследование | StageText EventDispatcher Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Этот класс позволяет мобильным приложениям получать введенные пользователем данные с использованием собственных элементов управления текстовым вводом на мобильных устройствах. Элементы управления вводом на мобильных устройствах часто имеют расширенные интерфейсы пользователя и поведение поддержки, которые не существуют в компьютерных системах. Например, многие мобильные устройства поддерживают такие функции ввода текста, как:
- автозаполнение;
- автоисправление;
- выделение текста прикосновением;
- настраиваемые программные клавиатуры.
Базовая операционная система (или библиотека компонентов, связанная с операционной системой) отрисовывает собственные поля для ввода текста. Собственные поля для ввода текста обеспечивают такое же взаимодействие, как и в других приложениях на этом устройстве. Однако, поскольку отрисовка полей для ввода текста выполняется операционной системой, а не проигрывателем, использование встроенных шрифтов невозможно.
Поддержка профиля AIR. Эта функция поддерживается на платформах iOS и Android. Объект StageText использует собственные поля для ввода текста на мобильных устройствах Android и iOS. На других платформах объект StageText использует TextField среды выполнения Flash.
При использовании собственных средств ввода объекты StageText не являются экранными объектами и не могут быть добавлены в список отображения Flash. Вместо них отображается объект StageText путем его подключения напрямую к рабочей области с использованием свойства stage
. Экземпляр StageText, подключенный к рабочей области, отображается поверх любых экранных объектов Flash. Размером и расположением области визуализации можно управлять с помощью свойства viewPort
. Способ управления порядком глубины различных экранных объектов StageText не предусмотрен. Наложение двух экземпляров не рекомендуется.
Если объект StageText получает фокус, ему предоставляется первая возможность обработки ввода с клавиатуры. Рабочая область, к которой прикреплен объект StageText, не отправляет события ввода с клавиатуры.
Поскольку класс StageText включает разный собственный элемент управления на каждой платформе, степень поддержки его функций будет отличаться в зависимости от платформы. Если поддержка функций предусмотрена, их поведение может отличаться на разных платформах. При попытке использовать определенную функцию на той или иной платформе рекомендуется сначала проверять поведение. Только на компьютерных платформах, где не используются собственные элементы управления, поведение StageText подобно поведению текста в среде выполнения Flash.
StageText в Apple TV назначает фокус по умолчанию. Для управления фокусом в разных объектах при работе с приложением учитывайте следующее.
- Чтобы переопределить фокус StageText по умолчанию или назначить фокус другому объекту дисплея, используйте stage.focus
- Чтобы назначить фокус StageText, используйте stageText.assignFocus()
Свойство | Определено | ||
---|---|---|---|
autoCapitalize : String
Управляет тем, как устройство автоматически выполняет переход на прописные буквы для введенных пользователем данных. | StageText | ||
autoCorrect : Boolean
Обозначает, выполняет ли устройство автоматическое исправление орфографических и пунктуационных ошибок во введенных пользователем данных. | StageText | ||
clearButtonMode : String [только для записи]
Режим clearButton для текущего объекта StageText. | StageText | ||
color : uint
Указывает цвет текста. | StageText | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
displayAsPassword : Boolean
Показывает, является ли текстовое поле полем пароля. | StageText | ||
editable : Boolean
Показывает, может ли пользователь редактировать текстовое поле. | StageText | ||
fontFamily : String
Обозначает имя текущего семейства шрифтов. | StageText | ||
fontPosture : String
Указывает начертание шрифта с помощью констант, определенных в классе FontPosture. | StageText | ||
fontSize : int
Размер текущего семейства шрифтов в пикселях. | StageText | ||
fontWeight : String
Указывает плотность шрифта с помощью констант, определенных в классе FontWeight. | StageText | ||
locale : String
Указывает языковой стандарт текста. | StageText | ||
maxChars : int
Определяет максимальное число символов, которые могут быть введены пользователем в текстовом поле. | StageText | ||
multiline : Boolean [только для чтения]
Показывает, может ли объект StageText отображать более одной строки текста. | StageText | ||
restrict : String
Ограничивает набор символов, которые могут быть введены пользователем в текстовом поле. | StageText | ||
returnKeyLabel : String
Обозначает метку клавиши ввода для устройств с программной клавиатурой. | StageText | ||
selectionActiveIndex : int [только для чтения]
Отсчитываемое от нуля значение индекса для последнего символа в текущем выделенном фрагменте. | StageText | ||
selectionAnchorIndex : int [только для чтения]
Отсчитываемое от нуля значение индекса для первого символа в текущем выделенном фрагменте. | StageText | ||
softKeyboardType : String
Управляет внешним видом программной клавиатуры. | StageText | ||
stage : Stage
Рабочая область, в которой отображается этот StageText. | StageText | ||
text : String
Текущее содержимое текстового поля. | StageText | ||
textAlign : String
Обозначает выравнивание абзацев. | StageText | ||
viewPort : Rectangle
Область в рабочей области, в которой отображается объект StageText. | StageText | ||
visible : Boolean
Обозначает видимость объекта StageText. | StageText |
Метод | Определено | ||
---|---|---|---|
Создает объект StageText. | StageText | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | ||
Передает фокус объекту StageText. | StageText | ||
Посылает событие в поток событий. | EventDispatcher | ||
Утилизирует объект StageText. | StageText | ||
Отрисовывает область просмотра StageText для растрового изображения. | StageText | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Выбирает текст, указанный значениями индексов первого и последнего символов. | StageText | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher |
Событие | Сводка | Определено | ||
---|---|---|---|---|
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | |||
Отправляется после изменения содержимого текста. | StageText | |||
Отправляется после установки ненулевого значения stage и непустого значения viewPort. | StageText | |||
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | |||
Отправляется, когда пользователь редактирует текст и элемент управления имеет фокус клавиатуры. | StageText | |||
Отправляется, когда пользователь прекращает редактирование текста и элемент управления больше не находится в фокусе клавиатуры. | StageText | |||
Отправляется, когда пользователь нажимает клавишу. | StageText | |||
Отправляется, когда пользователь отпускает клавишу. | StageText | |||
Отправляется после активации программной клавиатуры как результат получения фокуса объектом StageText. | StageText | |||
Отправляется перед активацией программной клавиатуры как результат получения фокуса объектом StageText. | StageText | |||
Отправляется после деактивации программной клавиатуры как результат потери фокуса объектом StageText. | StageText |
autoCapitalize | свойство |
autoCapitalize:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Управляет тем, как устройство автоматически выполняет переход на прописные буквы для введенных пользователем данных. Допустимые значения определены в виде констант в классе AutoCapitalize:
- "none"
- "word"
- "sentence"
- "all"
Это свойство носит только рекомендательный характер для базовой платформы, поскольку не все устройства и операционные системы поддерживают эту функцию.
Примечание. Если свойство autoCapitalize
включено во время редактирования текста (или в любое время, когда текст находится в фокусе), изменения не будут применены, пока фокус не будет снят и снова помещен на текстовое поле.
Значением по умолчанию является AutoCapitalize.NONE.
Реализация
public function get autoCapitalize():String
public function set autoCapitalize(value:String):void
Выдает
ArgumentError — Если задано значение, не являющееся элементом класса AutoCapitalize
|
Связанные элементы API
autoCorrect | свойство |
autoCorrect:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Обозначает, выполняет ли устройство автоматическое исправление орфографических и пунктуационных ошибок во введенных пользователем данных.
Это свойство носит только рекомендательный характер для базовой платформы, поскольку не все устройства и операционные системы поддерживают эту функцию.
Примечание. Если свойство autoCorrect
включено во время редактирования текста (или в любое время, когда текст находится в фокусе), изменения не будут применены, пока фокус не будет снят и снова помещен на текстовое поле.
Значением по умолчанию является false.
Реализация
public function get autoCorrect():Boolean
public function set autoCorrect(value:Boolean):void
clearButtonMode | свойство |
clearButtonMode:String
[только для записи] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 23 |
Режим clearButton для текущего объекта StageText. С этим свойством связаны четыре режима:
-
Чтобы отображать clearButton при редактировании:
StageTextClearButtonMode.WHILE_EDITING
-
Чтобы никогда не отображать clearButton:
StageTextClearButtonMode.NEVER
-
Чтобы всегда отображать clearButton:
StageTextClearButtonMode.ALWAYS
-
Чтобы отображать всегда clearButton, но не при редактировании:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode
задано значение StageTextClearButtonMode.WHILE_EDITING
.
Примечание. Это свойство поддерживается только для ОС iOS.
Реализация
public function set clearButtonMode(value:String):void
color | свойство |
color:uint
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Указывает цвет текста. Цвет текста указывается в виде числа, содержащего три 8-разрядных компонента RGB. Первый компонент представляет красный цвет, второй — зеленый, а третий — синий. Например, 0xFF0000
обозначает красный цвет, 0x00FF00
обозначает зеленый цвет, а 0x0000FF
обозначает синий цвет. По умолчанию для текста используется черный цвет (0x000000
).
Значением по умолчанию является 0x000000.
Реализация
public function get color():uint
public function set color(value:uint):void
displayAsPassword | свойство |
displayAsPassword:Boolean
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Показывает, является ли текстовое поле полем пароля. Если установлено значение true
, введенные в текстовое поле символы скрываются с помощью символа замещения (например, с помощью звездочки).
Примечание. Если свойство displayAsPassword
включено во время редактирования текста (или в любое время, когда текст находится в фокусе), изменения не будут применены, пока фокус не будет снят и снова помещен на текстовое поле.
Важно! В iOS многострочный текстовый объект рабочей области не отображает символы замещения, даже если значение этого свойства равно true
.
Значением по умолчанию является false.
Реализация
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | свойство |
fontFamily | свойство |
fontFamily:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Обозначает имя текущего семейства шрифтов. Значение null обозначает системный параметр по умолчанию. Чтобы перечислить все доступные шрифты, используйте flash.text.Font.enumerateFonts()
. Если семейство шрифтов неизвестно, используется семейство шрифтов по умолчанию.
Значением по умолчанию является null.
Реализация
public function get fontFamily():String
public function set fontFamily(value:String):void
fontPosture | свойство |
fontPosture:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Указывает начертание шрифта с помощью констант, определенных в классе FontPosture.
Значением по умолчанию является FontPosture.NORMAL.
Реализация
public function get fontPosture():String
public function set fontPosture(value:String):void
Выдает
ArgumentError — Если задано значение, не являющееся элементом класса FontPosture
|
Связанные элементы API
fontSize | свойство |
fontWeight | свойство |
fontWeight:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Указывает плотность шрифта с помощью констант, определенных в классе FontWeight.
Значением по умолчанию является FontWeight.NORMAL.
Реализация
public function get fontWeight():String
public function set fontWeight(value:String):void
Выдает
ArgumentError — Если задано значение, не являющееся элементом класса FontWeight
|
Связанные элементы API
locale | свойство |
locale:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Указывает языковой стандарт текста. StageText работает со стандартными идентификаторами языковых стандартов. Например en, en_US и en-US относятся к английскому, а ja — к японскому. Список кодов локалей см. в списке кодов iso639-2.
Значением по умолчанию является en.
Реализация
public function get locale():String
public function set locale(value:String):void
maxChars | свойство |
maxChars:int
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Определяет максимальное число символов, которые могут быть введены пользователем в текстовом поле. Сценарий может вставлять более длинный текст, чем разрешено параметром maxChars
. Если параметр maxChars
равен нулю, пользователь может вводить неограниченное количество символов текста в текстовое поле.
Значением по умолчанию является 0.
Реализация
public function get maxChars():int
public function set maxChars(value:int):void
multiline | свойство |
multiline:Boolean
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Показывает, может ли объект StageText отображать более одной строки текста. Только чтение. Это значение соответствует свойству multiline
в объекте StageTextInitOptions, используемому во время конструирования.
Реализация
public function get multiline():Boolean
Связанные элементы API
restrict | свойство |
restrict:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Ограничивает набор символов, которые могут быть введены пользователем в текстовом поле. Система проверяет строку restrict
слева направо.
Значение restrict
определяет следующие правила ограничения ввода текста:
- Если значение равно
null
, пользователь может вводить любой символ. - Если значением является пустая строка, пользователь не может вводить какие-либо символы.
- Если значением является строка символов, пользователь может ввести только те символы, которые содержатся в строке.
- Если значение включает символ вставки (^), пользователь не может вводить любые символы, которые следуют за символом вставки.
- При использовании символа дефиса (-) значение может определять диапазон разрешенных для ввода символов.
- В значении можно использовать escape-последовательность
\u
для построения строкиrestrict
.
Специальные символы:
Используйте символ обратной косой черты для ввода буквальных символов вставки (^) или дефиса (-). Допускаются следующие последовательности с обратной косой чертой: \-, \^ и \\. Обратная косая черта должна быть фактическим символом в строке. При указании обратной косой черты в ActionScript укажите ее два раза.
Примеры настроек свойства restrict
:
В следующем примере пользователь может вводить только символы дефиса (-) и вставки (^):
my_txt.restrict = "\\-\\^";
В следующем примере пользователь может вводить только прописные буквы, пробелы и цифры:
my_txt.restrict = "A-Z 0-9";
В следующем примере исключаются только строчные буквы:
my_txt.restrict = "^a-z";
В следующем примере пользователь может вводить только прописные буквы, за исключением прописной буквы Q:
my_txt.restrict = "A-Z^Q";
В следующем примере пользователь может вводить только символы от ASCII 32 (пробел) до ASCII 126 (тильда).
my_txt.restrict = "\u0020-\u007E";
Примечание. Ограничения действуют только для введенных пользователем данных; сценарий может вставлять любые символы в текстовое поле.
Значением по умолчанию является null.
Реализация
public function get restrict():String
public function set restrict(value:String):void
returnKeyLabel | свойство |
returnKeyLabel:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Обозначает метку клавиши ввода для устройств с программной клавиатурой. Доступными значениями являются константы, определенные в классе ReturnKeyLabel
:
- "default"
- "done"
- "go"
- "next"
- "search"
Это свойство носит только рекомендательный характер для базовой платформы, поскольку не все устройства и операционные системы поддерживают эти значения. Это свойство не работает на устройствах, которые не оснащены программной клавиатурой.
Значением по умолчанию является ReturnKeyLabel.DEFAULT.
Реализация
public function get returnKeyLabel():String
public function set returnKeyLabel(value:String):void
Выдает
ArgumentError — Если задано значение, не являющееся элементом класса ReturnKeyLabel
|
Связанные элементы API
selectionActiveIndex | свойство |
selectionActiveIndex:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отсчитываемое от нуля значение индекса для последнего символа в текущем выделенном фрагменте. Например, первый символ имеет индекс 0, второй — индекс 1 и т. д.
Если не выделено никакого текста, метод возвращает точку вставки. Если экземпляр StageText не имеет фокуса, метод возвращает -1.
В ОС iOS это свойство не поддерживается для немногострочных объектов StageText и возвращает -1.
Реализация
public function get selectionActiveIndex():int
Связанные элементы API
selectionAnchorIndex | свойство |
selectionAnchorIndex:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отсчитываемое от нуля значение индекса для первого символа в текущем выделенном фрагменте. Например, первый символ имеет индекс 0, второй — индекс 1 и т. д.
Если не выделено никакого текста, метод возвращает точку вставки. Если экземпляр StageText не имеет фокуса, метод возвращает -1.
В ОС iOS это свойство не поддерживается для немногострочных объектов StageText и возвращает -1.
Реализация
public function get selectionAnchorIndex():int
Связанные элементы API
softKeyboardType | свойство |
softKeyboardType:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Управляет внешним видом программной клавиатуры.
Устройства с программной клавиатурой могут настраивать кнопки клавиатуры в соответствии с типом ожидаемого ввода. Например, если ожидается ввод числовых данных, на устройстве может использоваться SoftKeyboardType.NUMBER
для отображения только цифр для программной клавиатуры. Допустимые значения определены в виде констант в классе SoftKeyboardType:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
Эти значения служат подсказками, помогающим устройству отобразить наиболее подходящую клавиатуру для текущей операции.
Значением по умолчанию является SoftKeyboardType.DEFAULT.
Реализация
public function get softKeyboardType():String
public function set softKeyboardType(value:String):void
Выдает
ArgumentError — Если задано значение, не являющееся элементом класса SoftKeyboardType
|
Связанные элементы API
stage | свойство |
stage:Stage
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Рабочая область, в которой отображается этот StageText.
Установите для stage
значение null
, чтобы скрыть этот объект StageText.
Значением по умолчанию является null.
Реализация
public function get stage():Stage
public function set stage(value:Stage):void
text | свойство |
text:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Текущее содержимое текстового поля. Символ возврата каретки ('\r'
, ASCII 13) служит для разделения строк текста. Текст, содержащийся в этом свойстве, является неформатированным (он не имеет тегов форматирования).
Значением по умолчанию является null.
Реализация
public function get text():String
public function set text(value:String):void
textAlign | свойство |
textAlign:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Обозначает выравнивание абзацев. Допустимые значения определены в виде констант в классе TextFormatAlign:
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
Все значения textAlign
поддерживаются не на всех платформах. Для неподдерживаемых значений textAlign
платформы используют значение по умолчанию (TextFormatAlign.START
).
Значением по умолчанию является TextFormatAlign.START.
Реализация
public function get textAlign():String
public function set textAlign(value:String):void
Выдает
ArgumentError — Если задано значение, не являющееся элементом класса TextFormatAlign
|
Связанные элементы API
viewPort | свойство |
viewPort:Rectangle
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Область в рабочей области, в которой отображается объект StageText. Значением по умолчанию является нулевой прямоугольник.
Реализация
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Выдает
RangeError — Значение Rectangle недействительно.
|
visible | свойство |
StageText | () | Конструктор |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Создает объект StageText.
Объект StageText невидим, пока он не присоединен к рабочей области и не задано свойство viewPort
.
initOptions:flash.text:StageTextInitOptions (default = null )
|
assignFocus | () | метод |
public function assignFocus():void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Передает фокус объекту StageText. Метод assignFocus()
никак не влияет на нередактируемые объекты.
dispose | () | метод |
public function dispose():void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Утилизирует объект StageText.
Вызов метода dispose()
является необязательным. Если ссылка на этот экземпляр StageText не сохраняется, он включается в операцию сборки мусора. С помощью вызова метода dispose()
сборку мусора можно начать раньше или в более удобное время.
drawViewPortToBitmapData | () | метод |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3.0 |
Отрисовывает область просмотра StageText для растрового изображения.
Захватите растровое изображение и задайте значение null
для рабочей области для того, чтобы отобразить содержимое над объектом StageText.
Растровое изображение, как правило, имеет такие же ширину и высоту, как и порт просмотра. Начиная с AIR версии 15.0, в случае запуска на дисплеях HiDPI ширина и высота растрового изображения могут находиться в зависимости от ширины и высоты порта просмотра в соответствии со значением, указанном в contentsScaleFactor
. Например, на дисплеях Retina компьютеров Mac параметру contentsScaleFactor
задано значение 2, так как пиксельное разрешение рабочей области удваивается и растровое изображение, соответственно, будет вдвое больше порта просмотра.
Если этот метод вызывается перед событием Event.COMPLETE
область просмотра может отрисовываться неправильно.
Параметры
bitmap:BitmapData — Объект BitmapData, на котором нужно отрисовывать видимую часть порта просмотра StageText.
|
Выдает
ArgumentError — Ширина или высота растрового изображения от ширины или высоты порта просмотра.
| |
Error — Растровое изображение пусто.
|
selectRange | () | метод |
public function selectRange(anchorIndex:int, activeIndex:int):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Выбирает текст, указанный значениями индексов первого и последнего символов. Первый и последний символы в выделенном фрагменте указываются в параметрах anchorIndex
и activeIndex
. Если значения обоих параметров равны, это метод определяет точку вставки.
В ОС iOS эта функция не поддерживается для немногострочных объектов StageText и всегда возвращает значение -1. Если этот метод вызывается путем выбора всей текстовой строки, выбор будет виден. Однако, если этот метод вызывается путем выбора подмножества текстовой строки, выбор не будет виден.
На некоторых устройствах и в некоторых операционных системах выделенный фрагмент виден только при наличии фокуса в объекте StageText.
Параметры
anchorIndex:int — Отсчитываемое от нуля значение индекса первого символа в выделенном фрагменте (значением индекса первого символа является 0).
| |
activeIndex:int — Отсчитываемое от нуля значение индекса для последнего символа в выделенном фрагменте.
|
Связанные элементы API
change | Событие |
flash.events.Event
свойство Event.type =
flash.events.Event.CHANGE
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отправляется после изменения содержимого текста. Это событие может отправляться после каждого изменения или после завершения внесения набора изменений.
КонстантаEvent.CHANGE
определяет значение свойства type
объекта события change
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, значение которого было изменено. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
complete | Событие |
flash.events.Event
свойство Event.type =
flash.events.Event.COMPLETE
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отправляется после установки ненулевого значения stage и непустого значения viewPort. Показывает, что реализация завершила компоновку объекта StageText и теперь можно вызвать метод drawViewPortToBitmapData
. В зависимости от платформы это событие может отправлять синхронно или асинхронно при настройке stage
и/или viewPort
.
Event.COMPLETE
определяет значение свойства type
объекта complete
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, который завершил загрузку. |
focusIn | Событие |
flash.events.FocusEvent
свойство FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь редактирует текст и элемент управления имеет фокус клавиатуры.
Задает значение свойстваtype
для объекта события focusIn
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | 0; применяется только к событиям keyFocusChange . |
relatedObject | Дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. |
shiftKey | false ; применяется только к событиям keyFocusChange . |
target | Экземпляр InteractiveObject, только что получивший фокус. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
|
direction | Направление, по которому был получен фокус. Это свойство сообщает значение параметра direction метода assignFocus() рабочей области. Если фокус изменился другим способом, значение всегда будет FocusDirection.NONE . Применяется только к событиям focusIn . Для всех других событий фокуса значение будет FocusDirection.NONE . |
focusOut | Событие |
flash.events.FocusEvent
свойство FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь прекращает редактирование текста и элемент управления больше не находится в фокусе клавиатуры.
Задает значение свойстваtype
для объекта события focusOut
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | 0; применяется только к событиям keyFocusChange . |
relatedObject | Дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. |
shiftKey | false ; применяется только к событиям keyFocusChange . |
target | Экземпляр InteractiveObject, только что потерявший фокус. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.
|
keyDown | Событие |
flash.events.KeyboardEvent
свойство KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь нажимает клавишу.
Соответствие клавиш и конкретных символов варьируется в зависимости от устройства и операционной системы. Этот тип событий создается после возникновения такого соответствия, но перед его обработкой редактором метода ввода IME. Редакторы методов ввода (IME) могут применяться для ввода символов, воспроизведение которых ограничено на стандартной клавиатуре QWERTY (например, китайской идеограммы).
Это событие происходит перед событием keyUp
.
Это событие отправляется не для всех клавиш. Клавиши, инициирующие отправку этого события, изменяются в зависимости от платформы.
Отмена этого события в программе AIR предотвращает ввод этого символа в текстовое поле.
КонстантаKeyboardEvent.KEY_DOWN
определяет значение свойства type
объекта события keyDown
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | true |
cancelable | true в AIR, false в Flash Player. Отмена этого события в AIR предотвращает ввод этого символа в текстовое поле. |
charCode | Значение кода символа для нажатой или отпущенной клавиши. |
commandKey | true в Mac, если клавиша Command активна. В противном случае false |
controlKey | true в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Control активна. В противном случае false |
ctrlKey | true в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | Значение кода клавиши для нажатой или отпущенной клавиши. |
keyLocation | Расположение клавиши на клавиатуре. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
target | Экземпляр InteractiveObject, находящийся в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
keyUp | Событие |
flash.events.KeyboardEvent
свойство KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отправляется, когда пользователь отпускает клавишу.
Соответствие клавиш и конкретных символов варьируется в зависимости от устройства и операционной системы. Этот тип событий создается после возникновения такого соответствия, но перед его обработкой редактором метода ввода IME. Редакторы методов ввода (IME) используются для ввода символов, воспроизведение которых ограничено на стандартной клавиатуре QWERTY (например, китайской идеограммы).
Это событие имеет место после события keyDown
.
Это событие отправляется не для всех клавиш. Клавиши, инициирующие отправку этого события, изменяются в зависимости от платформы.
КонстантаKeyboardEvent.KEY_UP
определяет значение свойства type
объекта события keyUp
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
charCode | Содержит значение кода символа для нажатой или отпущенной клавиши. |
commandKey | true в Mac, если клавиша Command активна. В противном случае false |
controlKey | true в Windows и Linux, если клавиша Ctrl активна. true в Mac, если клавиша Control активна. В противном случае false |
ctrlKey | true в Windows, если клавиша Ctrl активна. true в Mac, если клавиша Ctrl или Command активна. В противном случае false . |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | Значение кода клавиши для нажатой или отпущенной клавиши. |
keyLocation | Расположение клавиши на клавиатуре. |
shiftKey | true , если клавиша Shift активна; иначе — false . |
target | Экземпляр InteractiveObject, находящийся в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
softKeyboardActivate | Событие |
flash.events.SoftKeyboardEvent
свойство SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отправляется после активации программной клавиатуры как результат получения фокуса объектом StageText.
КонстантаSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
определяет значение type
объекта SoftKeyboardEvent, когда программная клавиатура выводится на экран. Для этого события cancellable = false
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
relatedObjectVal | Ссылка на объект списка отображения, связанный с событием. |
triggerTypeVal | Обозначает, было ли событие клавиатуры вызвано программой или пользователем. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
softKeyboardActivating | Событие |
flash.events.SoftKeyboardEvent
свойство SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отправляется перед активацией программной клавиатуры как результат получения фокуса объектом StageText.
КонстантаSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
определяет значение свойства type
объекта SoftKeyboardEvent сразу перед выводом программной клавиатуры на экран. Для этого события cancellable = true
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true , если объект StageText не отправляет событие. Для объектов StageText отменить событие невозможно. |
relatedObjectVal | Ссылка на объект списка отображения, связанный с событием. |
triggerTypeVal | Обозначает, было ли событие клавиатуры вызвано программой или пользователем. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
softKeyboardDeactivate | Событие |
flash.events.SoftKeyboardEvent
свойство SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 3 |
Отправляется после деактивации программной клавиатуры как результат потери фокуса объектом StageText.
КонстантаSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
определяет значение свойства type
объекта SoftKeyboardEvent, когда программная клавиатура опускается или скрывается. Для этого события, cancellable = false
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
relatedObjectVal | Ссылка на объект списка отображения, связанный с событием. |
triggerTypeVal | Обозначает, было ли событие клавиатуры вызвано программой или пользователем. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
Tue Jun 12 2018, 11:34 AM Z