| Пакет | flash.text.ime |
| Интерфейс | public interface IIMEClient |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Для обеспечения поддержки встроенного IME задайте в качестве значения свойства imeClient события ImeEvent.IME_START_COMPOSITION объект, который реализует этот интерфейс.
Следующие термины часто используются в API-интерфейсах, связанных с IME.
- Диалог — это обмен данными между IME и приложением. Во время диалога компоновка обновляется один или несколько раз, и затем подтверждается пользователем.
- Компоновка определяет текст, введенный пользователем через IME; включая связанную информацию о состоянии ввода, например выделенный диапазон и расширение выражений.
- Выражение — это диапазон компоновки, который может иметь общую семантическую информацию, например обозначать, находится ли ввод в состоянии выделения или преобразования. Компоновка содержит нуль или больше выражений.
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
| compositionEndIndex : int [только для чтения]
Отсчитываемое от нуля значение индекса символа в конце текста текущего сеанса редактирования (например, всего текста во встроенном сеансе, который еще не подтвержден в документе). | IIMEClient | ||
| compositionStartIndex : int [только для чтения]
Отсчитываемое от нуля значение индекса символа в начале текста текущего сеанса редактирования (например, всего текста во встроенном сеансе, который еще не подтвержден в документе). | IIMEClient | ||
| selectionActiveIndex : int [только для чтения]
Отсчитываемое от нуля значение индекса для последнего символа в текущем выделенном фрагменте. | IIMEClient | ||
| selectionAnchorIndex : int [только для чтения]
Отсчитываемое от нуля значение индекса для первого символа в текущем выделенном фрагменте. | IIMEClient | ||
| verticalTextLayout : Boolean [только для чтения]
Обозначает, имеет ли текст в компоненте вертикальное направление или нет. | IIMEClient | ||
| Метод | Определено | ||
|---|---|---|---|
Используйте этот обратный вызов, чтобы завершить встроенный сеанс редактирования и подтвердить текст. | IIMEClient | ||
IME использует этот метод для запроса ограничительной рамки текста, который в данный момент редактируется с помощью клиента IME. | IIMEClient | ||
Получает указанный диапазон текста от компонента. | IIMEClient | ||
Устанавливает диапазон выбранного текста в компоненте. | IIMEClient | ||
updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void
Обратный вызов для обновления содержимого в ходе встроенного сеанса редактирования. | IIMEClient | ||
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| Отправляется, когда пользователь начинает использовать IME (редактор методов ввода). | IIMEClient | |||
| Отправляется, когда пользователь вводит текст. | IIMEClient | |||
compositionEndIndex | свойство |
compositionEndIndex:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Отсчитываемое от нуля значение индекса символа в конце текста текущего сеанса редактирования (например, всего текста во встроенном сеансе, который еще не подтвержден в документе).
Реализация
public function get compositionEndIndex():intcompositionStartIndex | свойство |
compositionStartIndex:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Отсчитываемое от нуля значение индекса символа в начале текста текущего сеанса редактирования (например, всего текста во встроенном сеансе, который еще не подтвержден в документе).
Реализация
public function get compositionStartIndex():intselectionActiveIndex | свойство |
selectionAnchorIndex | свойство |
verticalTextLayout | свойство |
verticalTextLayout:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Обозначает, имеет ли текст в компоненте вертикальное направление или нет. Это свойство задает направление для размещение предполагаемого окна (например, рядом с вертикальным текстом или под горизонтальным).
Реализация
public function get verticalTextLayout():BooleanconfirmComposition | () | метод |
public function confirmComposition(text:String = null, preserveSelection:Boolean = false):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Используйте этот обратный вызов, чтобы завершить встроенный сеанс редактирования и подтвердить текст.
Параметры
text:String (default = null) | |
preserveSelection:Boolean (default = false) |
getTextBounds | () | метод |
public function getTextBounds(startIndex:int, endIndex:int):Rectangle| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
IME использует этот метод для запроса ограничительной рамки текста, который в данный момент редактируется с помощью клиента IME. Используйте этот метод, чтобы разместить предполагаемое окно и задать вид курсора мыши в клиенте IME, когда мышь наводится на текстовое поле или другой компонент, поддерживающий IME.
Параметры
startIndex:int — Целое число, которое определяет начальную позицию диапазона текста от измеряемой ограничительной рамки.
| |
endIndex:int — Необязательно; целое число, которое определяет конечную позицию диапазона текста от измеряемой ограничительной рамки.
|
Rectangle — Ограничительная рамка указанного диапазона текста, или null, если один или оба индекса недействительны. Этот метод возвращает одно и то же значение, если startIndex больше или меньше, чем endIndex. То же самое значение должно быть возвращено независимо от того, startIndex больше или меньше чем endIndex.
|
getTextInRange | () | метод |
public function getTextInRange(startIndex:int, endIndex:int):String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Получает указанный диапазон текста от компонента. Этот метод вызывается во время обратного преобразования IME.
Параметры
startIndex:int — целое число, указывающее начальное положение фрагмента извлекаемого текста.
| |
endIndex:int — целое число, указывающую конечное местоположение диапазона извлекаемого текста.
|
String — Запрашиваемый текст или null, если в указанном диапазоне нет текста, либо один или оба индекса недействительны. Должно быть использовано одинаковое значение независимо от того, индекс больше startIndex или меньше endIndex.
|
selectRange | () | метод |
public function selectRange(anchorIndex:int, activeIndex:int):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Устанавливает диапазон выбранного текста в компоненте. Если любой из аргументов находится за пределами диапазона, выделенную область изменять не требуется.
Параметры
anchorIndex:int — Отсчитываемое от нуля значение индекса символа в опорной конечной точке выделенного фрагмента.
| |
activeIndex:int — Отсчитываемое от нуля значение индекса символа в активной конечной точке выделенного фрагмента.
|
updateComposition | () | метод |
public function updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Обратный вызов для обновления содержимого в ходе встроенного сеанса редактирования. Этот метод вызывается после каждого изменения текста, отредактированного с помощью IME, и его содержимое используется клиентом для перерисовки всего встроенного сеанса редактирования.
Параметры
text:String — Содержит текст встроенного сеанса редактирования из IME.
| |
attributes:Vector.<CompositionAttributeRange> — Содержит массив выражений компоновки с информацией о графических элементах.
| |
compositionStartIndex:int — Начало встроенного сеанса относительно начала текстового объекта.
| |
compositionEndIndex:int — Конец встроенного сеанса относительно начала текстового объекта.
|
imeStartComposition | Событие |
flash.events.IMEEventсвойство IMEEvent.type =
flash.events.IMEEvent.IME_START_COMPOSITION| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Отправляется, когда пользователь начинает использовать IME (редактор методов ввода).
Чтобы обработать ввод текста с помощью IME, получатель должен задать для поляimeClient объект, который реализует интерфейс IIMEClient. Если для imeClient не задано значение, среда выполнения использует смещенную компоновку IME и отправляет конечную компоновку как событие TEXT_INPUT.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект IME. |
textInput | Событие |
flash.events.TextEventсвойство TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Отправляется, когда пользователь вводит текст. Для клиентов IME (редактора методов ввода) получатель должен вставить строку, содержащуюся в свойстве text объекта события в текущей точке вставки.
type для объекта события textInput.
Примечание. Это событие не отправляется для клавиш Delete или Backspace.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | true |
cancelable | true; вызовите метод preventDefault() для отмены поведения по умолчанию. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Текстовое поле, в которое вводятся символы. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
text | Символ или последовательность символов, введенных пользователем. |
Tue Jun 12 2018, 11:34 AM Z