| Pacote | flashx.textLayout.edit |
| Interface | public interface ISelectionManager extends IInteractionEventHandler |
| Implementadores | SelectionManager |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Um SelectionManager acompanha o intervalo de texto selecionado e cuida dos eventos de um TextFlow.
Uma seleção pode ser pontual ou de intervalo. Uma seleção pontual é o ponto de inserção, sendo indicada visualmente pelo desenho de um cursor. Uma seleção de intervalo inclui o texto entre um ponto de ancoragem e um ponto ativo.
Elementos da API relacionados
flashx.textLayout.edit.TextScrap
flashx.textLayout.elements.TextFlow
| Propriedade | Definido por | ||
|---|---|---|---|
| absoluteEnd : int [somente leitura]
A posição de texto do final da seleção, como deslocamento a partir do início do fluxo de texto. | ISelectionManager | ||
| absoluteStart : int [somente leitura]
A posição de texto do início da seleção, como deslocamento a partir do início do fluxo de texto. | ISelectionManager | ||
| activePosition : int [somente leitura]
O ponto ativo da seleção. | ISelectionManager | ||
| anchorPosition : int [somente leitura]
O ponto de ancoragem da seleção. | ISelectionManager | ||
| currentSelectionFormat : SelectionFormat [somente leitura]
O objeto SelectionFormat atual. | ISelectionManager | ||
| editingMode : String [somente leitura]
O modo de edição. | ISelectionManager | ||
| focused : Boolean [somente leitura]
Indica se o foco estará em um contêiner no fluxo de texto. | ISelectionManager | ||
| focusedSelectionFormat : SelectionFormat
O objeto SelectionFormat usado para desenhar a seleção em um contêiner com foco. | ISelectionManager | ||
| inactiveSelectionFormat : SelectionFormat
O objeto SelectionFormat usado para desenhar a seleção quando ela não estiver na janela ativa. | ISelectionManager | ||
| textFlow : flashx.textLayout.elements:TextFlow
O objeto TextFlow gerenciado por este gerenciador de seleções. | ISelectionManager | ||
| unfocusedSelectionFormat : SelectionFormat
O objeto SelectionFormat usado para desenhar a seleção quando ela não estiver em um contêiner com foco e sim na janela ativa. | ISelectionManager | ||
| windowActive : Boolean [somente leitura]
Indica se a janela associada ao fluxo de texto está ativa. | ISelectionManager | ||
| Método | Definido por | ||
|---|---|---|---|
![]() |
Processa um evento de ativação. | IInteractionEventHandler | |
![]() |
Processa um evento de desativação. | IInteractionEventHandler | |
![]() |
Processa um evento de edição. | IInteractionEventHandler | |
Executa qualquer FlowOperations pendente. | ISelectionManager | ||
![]() |
Processa um evento focusChange. | IInteractionEventHandler | |
![]() |
Processa um evento focusIn. | IInteractionEventHandler | |
![]() |
Processa um evento focusOut. | IInteractionEventHandler | |
getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Obtém os atributos de formato de caractere comuns a todos os caracteres do intervalo de texto especificado ou da seleção atual. | ISelectionManager | ||
getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Obtém os atributos de formato de contêiner comuns a todos os contêineres no intervalo de texto especificado ou da seleção atual. | ISelectionManager | ||
getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat
Obtém os atributos de formato de parágrafo comuns a todos os parágrafos no intervalo de texto especificado ou na seleção atual. | ISelectionManager | ||
Lê o objeto SelectionState da seleção atual. | ISelectionManager | ||
Indica se há uma seleção. | ISelectionManager | ||
![]() |
Processa um evento imeStartComposition
| IInteractionEventHandler | |
Indica se a seleção cobre um intervalo de texto. | ISelectionManager | ||
![]() |
Processa um evento keyDown. | IInteractionEventHandler | |
![]() |
Processa um evento keyFocusChange. | IInteractionEventHandler | |
![]() |
Processa um evento keyUp. | IInteractionEventHandler | |
![]() |
Processa um evento menuSelect. | IInteractionEventHandler | |
![]() |
Processa um evento mouseDoubleClick. | IInteractionEventHandler | |
![]() |
Processa um evento mouseDown. | IInteractionEventHandler | |
![]() |
Processa um evento mouseMove. | IInteractionEventHandler | |
![]() |
Processa um evento mouseOut. | IInteractionEventHandler | |
![]() |
Processa um evento mouseOver. | IInteractionEventHandler | |
![]() |
Processa um evento mouseUp. | IInteractionEventHandler | |
![]() |
Processa um evento mouseWheel. | IInteractionEventHandler | |
Atualiza o gerenciador de seleções quando um texto é inserido ou excluído. | ISelectionManager | ||
Reexibe as formas da seleção. | ISelectionManager | ||
Seleciona o fluxo inteiro. | ISelectionManager | ||
Seleciona um intervalo de texto. | ISelectionManager | ||
Põe o foco no primeiro contêiner da seleção. | ISelectionManager | ||
Define o objeto SelectionState da seleção atual. | ISelectionManager | ||
![]() |
Processa um evento softKeyboardActivating
| IInteractionEventHandler | |
![]() |
Processa um TextEvent. | IInteractionEventHandler | |
absoluteEnd | propriedade |
absoluteEnd:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A posição de texto do final da seleção, como deslocamento a partir do início do fluxo de texto.
O final absoluto é igual ao ponto ativo ou de ancoragem da seleção, o que vier por último no fluxo de texto.
Implementação
public function get absoluteEnd():intabsoluteStart | propriedade |
absoluteStart:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A posição de texto do início da seleção, como deslocamento a partir do início do fluxo de texto.
O início absoluto é igual ao ponto ativo ou de ancoragem da seleção, o que vier primeiro no fluxo de texto.
Implementação
public function get absoluteStart():intactivePosition | propriedade |
activePosition:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O ponto ativo da seleção.
O ponto ativo é o final volátil da seleção. O ponto ativo muda quando a seleção é modificada. O ponto ativo pode estar ou no início ou no fim da seleção.
Implementação
public function get activePosition():intanchorPosition | propriedade |
anchorPosition:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O ponto de ancoragem da seleção.
Um ponto de ancoragem é o final estável da seleção. Quando uma seleção é estendida, o ponto de ancoragem não muda. O ponto de ancoragem pode estar ou no início ou no fim da seleção.
Implementação
public function get anchorPosition():intcurrentSelectionFormat | propriedade |
currentSelectionFormat:SelectionFormat [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O objeto SelectionFormat atual.
O objeto SelectionFormat atual é escolhido entre os objetos SelectionFormat atribuídos às propriedades unfocusedSelectionFormat, inactiveSelectionFormat e focusedSelectionFormat de acordo com o estado atual das propriedades windowActive e focused.
Implementação
public function get currentSelectionFormat():SelectionFormateditingMode | propriedade |
editingMode:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O modo de edição.
O modo de edição indica se o fluxo de texto permite seleção, edição ou apenas leitura. Um fluxo de texto passa a ser selecionável por meio da atribuição de um gerenciador de seleções, e editável com a atribuição de um gerenciador de edições. As constantes que representam os modos de edição são definidas na classe EditingMode.
Implementação
public function get editingMode():StringElementos da API relacionados
focused | propriedade |
focused:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Indica se o foco estará em um contêiner no fluxo de texto.
A propriedade focused é verdadeira se algum dos contêineres do fluxo de texto tiver o foco principal.
Implementação
public function get focused():BooleanfocusedSelectionFormat | propriedade |
focusedSelectionFormat:SelectionFormat| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O objeto SelectionFormat usado para desenhar a seleção em um contêiner com foco.
Implementação
public function get focusedSelectionFormat():SelectionFormat public function set focusedSelectionFormat(value:SelectionFormat):voidinactiveSelectionFormat | propriedade |
inactiveSelectionFormat:SelectionFormat| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O objeto SelectionFormat usado para desenhar a seleção quando ela não estiver na janela ativa.
Implementação
public function get inactiveSelectionFormat():SelectionFormat public function set inactiveSelectionFormat(value:SelectionFormat):voidtextFlow | propriedade |
textFlow:flashx.textLayout.elements:TextFlow| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O objeto TextFlow gerenciado por este gerenciador de seleções.
Um gerenciador de seleções gerencia um único fluxo de texto. Um gerenciador de seleções também pode ser atribuído a um fluxo de texto por meio da definição da propriedade interactionManager do objeto TextFlow.
Implementação
public function get textFlow():flashx.textLayout.elements:TextFlow public function set textFlow(value:flashx.textLayout.elements:TextFlow):voidElementos da API relacionados
unfocusedSelectionFormat | propriedade |
unfocusedSelectionFormat:SelectionFormat| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O objeto SelectionFormat usado para desenhar a seleção quando ela não estiver em um contêiner com foco e sim na janela ativa.
Implementação
public function get unfocusedSelectionFormat():SelectionFormat public function set unfocusedSelectionFormat(value:SelectionFormat):voidwindowActive | propriedade |
windowActive:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Indica se a janela associada ao fluxo de texto está ativa.
A propriedade windowActive é verdadeira se a janela exibida com o fluxo de texto for a janela ativa.
Implementação
public function get windowActive():BooleanflushPendingOperations | () | método |
public function flushPendingOperations():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Executa qualquer FlowOperations pendente.
A execução de algumas operações de edição, tais como inserção de texto, é suspensa até o evento enterFrame seguinte. Uma chamada a flushPendingOperations() faz com que todas as operações suspensas sejam executadas imediatamente.
getCommonCharacterFormat | () | método |
public function getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Obtém os atributos de formato de caractere comuns a todos os caracteres do intervalo de texto especificado ou da seleção atual.
Os atributos de formato que não tiverem o mesmo valor para todos os caracteres do intervalo de elemento especificado ou da seleção terão o valor null na instância TextLayoutFormat retornada.
Parâmetros
range:flashx.textLayout.elements:TextRange (default = null) — O intervalo opcional do texto para o qual os atributos comuns são solicitados. Se nulo, a seleção atual será usada.
|
flashx.textLayout.formats:TextLayoutFormat — As configurações comuns de estilo de caracteres
|
Exemplo ( Como usar este exemplo )
var common:ITextLayoutFormat = textFlow.interactionManager.getCommonCharacterFormat();
getCommonContainerFormat | () | método |
public function getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Obtém os atributos de formato de contêiner comuns a todos os contêineres no intervalo de texto especificado ou da seleção atual.
Os atributos de formato que não tiverem o mesmo valor para todos os contêineres do intervalo de elemento especificado ou da seleção terão o valor null na instância TextLayoutFormat retornada.
Parâmetros
range:flashx.textLayout.elements:TextRange (default = null) — O intervalo opcional do texto para o qual os atributos comuns são solicitados. Se nulo, a seleção atual será usada.
|
flashx.textLayout.formats:TextLayoutFormat — As configurações comuns de estilo de contêineres
|
Exemplo ( Como usar este exemplo )
var common:ITextLayoutFormat = textFlow.interactionManager.getCommonContainerFormat();
getCommonParagraphFormat | () | método |
public function getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Obtém os atributos de formato de parágrafo comuns a todos os parágrafos no intervalo de texto especificado ou na seleção atual.
Os atributos de formato que não tiverem o mesmo valor para todos os parágrafos no intervalo de elemento especificado ou na seleção terão o valor null na instância TextLayoutFormat retornada.
Parâmetros
range:flashx.textLayout.elements:TextRange (default = null) — O intervalo opcional do texto para o qual os atributos comuns são solicitados. Se nulo, a seleção atual será usada.
|
flashx.textLayout.formats:TextLayoutFormat — As configurações comuns de estilo de parágrafos
|
Exemplo ( Como usar este exemplo )
var common:ITextLayoutFormat = textFlow.interactionManager.getCommonParagraphFormat();
getSelectionState | () | método |
public function getSelectionState():SelectionState| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Lê o objeto SelectionState da seleção atual.
RetornaSelectionState |
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
var selection:SelectionState = textFlow.interactionManager.getSelectionState();
hasSelection | () | método |
public function hasSelection():Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Indica se há uma seleção.
Gera true se houver uma seleção de intervalo ou uma seleção pontual. Por padrão, quando um gerenciador de seleções é criado, não há nenhuma seleção (o início e o final são -1).
Boolean |
Exemplo ( Como usar este exemplo )
var selection:SelectionState = textFlow.interactionManager.hasSelection();
isRangeSelection | () | método |
public function isRangeSelection():Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Indica se a seleção cobre um intervalo de texto.
Gera true se houver uma seleção que se estende após uma única posição.
Boolean |
Exemplo ( Como usar este exemplo )
var selection:SelectionState = textFlow.interactionManager.isRangeSelection();
notifyInsertOrDelete | () | método |
public function notifyInsertOrDelete(absolutePosition:int, length:int):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Atualiza o gerenciador de seleções quando um texto é inserido ou excluído.
As operações devem chamar notifyInsertOrDelete ao alterar o texto no fluxo de texto. O gerenciador de seleções ajusta proporcionalmente os indicadores de posição indexados. Se você criar uma nova classe Operação que altere diretamente o texto em um fluxo de texto (sem usar outra operação), a sua operação deverá chamar esta função para manter a seleção atualizada.
Parâmetros
absolutePosition:int — Ponto do texto em que a modificação foi realizada.
| |
length:int — Um número positivo ou negativo que indica quantos caracteres foram inseridos ou excluídos.
|
Exemplo ( Como usar este exemplo )
notifyInsertOrDelete().
Esta função substitui um intervalo do texto em um SpanElement como parte de um alguma operação hipotética.
import flashx.textLayout.elements.SpanElement;
function doReplace( span:SpanElement, newText:String, relativeStart:int, relativeEnd:int ):void
{
span.replaceText( relativeStart, relativeEnd, newText );
var parentFlow:TextFlow = span.getTextFlow();
var lengthDifference:int = newText.length - (relativeEnd - relativeStart);
parentFlow.interactionManager.notifyInsertOrDelete( span.getAbsoluteStart() + relativeStart, lengthDifference );
}
refreshSelection | () | método |
public function refreshSelection():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Reexibe as formas da seleção.
Nota: não é necessário chamar esse método diretamente. Ele é chamado automaticamente.
selectAll | () | método |
public function selectAll():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Seleciona o fluxo inteiro.
selectRange | () | método |
public function selectRange(anchorPosition:int, activePosition:int):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Seleciona um intervalo de texto.
Se um número negativo for transmitido como qualquer um dos parâmetros, todas as seleções existentes serão excluídas.
Parâmetros
anchorPosition:int — O ponto de ancoragem da nova seleção, como posição absoluta no TextFlow
| |
activePosition:int — O final ativo da nova seleção, como posição absoluta no TextFlow
|
Exemplo ( Como usar este exemplo )
var textFlow:TextFlow = TextConverter.importToFlow( "Let me not to the marriage of true minds", TextConverter.PLAIN_TEXT_FORMAT ); textFlow.interactionManager = new SelectionManager(); textFlow.interactionManager.selectRange( 18, 26 ); // Selects the word 'marriage'
setFocus | () | método |
public function setFocus():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Põe o foco no primeiro contêiner da seleção.
Exemplo ( Como usar este exemplo )
textFlow.interactionManager.setFocus();
setSelectionState | () | método |
public function setSelectionState(state:SelectionState):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Define o objeto SelectionState da seleção atual.
Parâmetros
state:SelectionState |
Elementos da API relacionados
Wed Jun 13 2018, 11:10 AM Z
Ocultar métodos públicos herdados
Mostrar métodos públicos herdados