Пакет | flashx.textLayout.events |
Класс | public class SelectionEvent |
Наследование | SelectionEvent Event Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Свойство | Определено | ||
---|---|---|---|
bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | ||
cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | ||
eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | ||
selectionState : SelectionState
Объект типа SelectionState, представляющий выбранный диапазон, связанный с этим событием SelectionEvent. | SelectionEvent | ||
target : Object [только для чтения]
Целевой объект события. | Event | ||
type : String [только для чтения]
Тип события. | Event |
Метод | Определено | ||
---|---|---|---|
SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Создает объект события, содержащий информацию об операции потока. | SelectionEvent | ||
Создает дубликат экземпляра подкласса Event. | Event | ||
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строку, содержащую все свойства объекта Event. | Event | ||
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
SELECTION_CHANGE : String = "selectionChange" [статические]
Константа SelectionEvent.SELECTION_CHANGE определяет значение свойства type объекта события выбора. | SelectionEvent |
selectionState | свойство |
selectionState:SelectionState
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Объект типа SelectionState, представляющий выбранный диапазон, связанный с этим событием SelectionEvent.
Это свойство, наряду с классом ElementRange, может использоваться для создания экземпляра ElementRange, представляющего диапазон выбранного текста. Для создания экземпляра класса ElementRange, представляющего диапазон выбранного текста, можно применять следующий код (переменная ev
представляет объект события, а условный оператор используется для защиты от значения null
свойства selectionState
):
// Find selected element range var range:ElementRange = ev.selectionState ? ElementRange.createElementRange(ev.selectionState.textFlow, ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;
Реализация
public function get selectionState():SelectionState
public function set selectionState(value:SelectionState):void
Связанные элементы API
SelectionEvent | () | Конструктор |
public function SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Создает объект события, содержащий информацию об операции потока.
Параметрыtype:String — Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type . Существует только один тип события SelectionEvent: SelectionEvent.SELECTION_CHANGE ;
| |
bubbles:Boolean (default = false ) — Указывает, является ли событие элементом восходящей цепочки. Это событие не является элементом восходящей цепочки.
| |
cancelable:Boolean (default = false ) — Указывает, можно ли предотвратить поведение, связанное с событием.
| |
selectionState:SelectionState (default = null ) — Объект типа ElementRange, описывающий диапазон выбранного текста.
|
SELECTION_CHANGE | Константа |
public static const SELECTION_CHANGE:String = "selectionChange"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Константа SelectionEvent.SELECTION_CHANGE определяет значение свойства type объекта события выбора.
В этом примере показан метод прослушивания изменений выбора текста в текстовом потоке. Двумя ключевыми шагами являются вызов метода addEventListener()
для текстового потока и создание функции обработчика событий.
Вызов метода addEventListener()
осуществляется для экземпляра TextFlow. При этом можно применять простую строку selectionChange
, однако надежнее использовать статическую константу SelectionEvent.SELECTION_CHANGE
.
Функция обработчика событий в этом примере называется selectionHandler()
. В методе selectionHandler()
функция trace()
применяется для определения операторов отслеживания, указывающих начальную и конечную точки диапазона текста. Доступ к этой информации осуществляется с помощью свойства selectedElementRange
объекта события.
package flashx.textLayout.events.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.edit.ElementRange; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.edit.SelectionManager; import flashx.textLayout.edit.SelectionState; import flashx.textLayout.events.SelectionEvent; public class SelectionEvent_example extends Sprite { private var tf:TextFlow; private var sm:SelectionManager; public function SelectionEvent_example() { //define TextFlow and manager objects tf = new TextFlow(); sm = new SelectionManager(); tf.interactionManager = sm; //define elements to contain text var p:ParagraphElement = new ParagraphElement(); var s:SpanElement = new SpanElement(); s.text ="This is sample text for the SelectionEvent example."; //add the elements to the TextFlow p.addChild(s); // add span as child of paragraph tf.addChild(p); // add paragraph to text flow //compose TextFlow to display tf.flowComposer.addController(new ContainerController(this,600,400)); tf.flowComposer.updateAllControllers(); //add event handler to listen for SelectionEvent tf.addEventListener(SelectionEvent.SELECTION_CHANGE, selectionHandler); } private function selectionHandler(ev:SelectionEvent):void{ trace("Selection event detected."); // Find selected element range var range:ElementRange = ev.selectionState ? ElementRange.createElementRange(ev.selectionState.textFlow, ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null; trace("Starting index of selection range: " + range.absoluteStart); trace("Ending index of selection range: " + range.absoluteEnd); } } }
Tue Jun 12 2018, 11:34 AM Z