| Пакет | 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
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства