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():int
absoluteStart | 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():int
activePosition | 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():int
anchorPosition | 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():int
currentSelectionFormat | 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():SelectionFormat
editingMode | 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():String
Elementos 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():Boolean
focusedSelectionFormat | 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):void
inactiveSelectionFormat | 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):void
textFlow | 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):void
Elementos 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):void
windowActive | 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():Boolean
flushPendingOperations | () | 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