Pacote | flashx.textLayout.events |
Classe | public class SelectionEvent |
Herança | SelectionEvent Event Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
Propriedade | Definido por | ||
---|---|---|---|
bubbles : Boolean [somente leitura]
Indica se um evento é do tipo bubbling. | Event | ||
cancelable : Boolean [somente leitura]
Indica se o comportamento associado ao evento pode ser impedido. | Event | ||
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
currentTarget : Object [somente leitura]
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. | Event | ||
eventPhase : uint [somente leitura]
A fase atual no fluxo de eventos. | Event | ||
selectionState : SelectionState
Um objeto do tipo SelectionState que representa o intervalo selecionado associado a este SelectionEvent. | SelectionEvent | ||
target : Object [somente leitura]
O destino de evento. | Event | ||
type : String [somente leitura]
O tipo de evento. | Event |
Método | Definido por | ||
---|---|---|---|
SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Cria um objeto de evento que contém informações sobre uma operação de fluxo. | SelectionEvent | ||
Duplica uma ocorrência de uma subclasse Event. | Event | ||
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Verifica se o método preventDefault() foi chamado no evento. | Event | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | ||
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna uma string que contém todas as propriedades do objeto Event. | Event | ||
Retorna o valor primitivo do objeto especificado. | Object |
Constante | Definido por | ||
---|---|---|---|
SELECTION_CHANGE : String = "selectionChange" [estático]
A constante SelectionEvent.SELECTION_CHANGE define o valor da propriedade de tipo do objeto de evento de seleção. | SelectionEvent |
selectionState | propriedade |
selectionState:SelectionState
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
Um objeto do tipo SelectionState que representa o intervalo selecionado associado a este SelectionEvent.
Você pode usar esta propriedade, junto com a classe ElementRange, para criar uma instância ElementRange que represente o intervalo do texto selecionado. Você pode usar a seguinte linha de código para criar uma instância da classe ElementRange que representa o intervalo de texto selecionado (a variável ev
representa o objeto do evento e o operador condicional é usado para proteção contra um valor null
na propriedade selectionState
):
// Find selected element range var range:ElementRange = ev.selectionState ? ElementRange.createElementRange(ev.selectionState.textFlow, ev.selectionState.absoluteStart, ev.selectionState.absoluteEnd) : null;
Implementação
public function get selectionState():SelectionState
public function set selectionState(value:SelectionState):void
Elementos da API relacionados
SelectionEvent | () | Construtor |
public function SelectionEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, selectionState:SelectionState = null)
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
Cria um objeto de evento que contém informações sobre uma operação de fluxo.
Parâmetrostype:String — O tipo de evento. Ouvintes de eventos podem acessar essas informações por meio da propriedade type herdada. Há apenas um tipo de SelectionEvent: SelectionEvent.SELECTION_CHANGE ;
| |
bubbles:Boolean (default = false ) — Indica se um evento é do tipo bubbling. Esse evento não realiza bubbling.
| |
cancelable:Boolean (default = false ) — Indica se o comportamento associado ao evento pode ser impedido.
| |
selectionState:SelectionState (default = null ) — Um objeto do tipo ElementRange que descreve o intervalo de texto selecionado.
|
SELECTION_CHANGE | Constante |
public static const SELECTION_CHANGE:String = "selectionChange"
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
A constante SelectionEvent.SELECTION_CHANGE define o valor da propriedade de tipo do objeto de evento de seleção.
Este exemplo mostra como ouvir mudanças na seleção de texto em um fluxo de texto. As duas etapas principais são chamar o método addEventListener()
no fluxo de texto e criar uma função gerenciadora de eventos.
A chamada a addEventListener()
é efetuada à instância de TextFlow. Você pode usar a string simples "selectionChange"
, mas é mais seguro usar a constante estática SelectionEvent.SELECTION_CHANGE
.
A função gerenciadora de eventos neste exemplo é denominada selectionHandler()
. O método selectionHandler()
utiliza a função trace()
para gerar declarações de traço que indicam os pontos inicial e final do intervalo de texto. Essa informação pode ser acessada através da propriedade selectedElementRange
do objeto do evento.
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); } } }
Wed Jun 13 2018, 11:10 AM Z