| Пакет | 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