Referência do ActionScript® 3.0 para Adobe® Flash® Platform
Início  |  Ocultar listas de Pacotes e Classes |  Pacotes  |  Classes  |  Novidades  |  Índice  |  Apêndices  |  Por que inglês?
Filtros: Recuperando dados do servidor...
Recuperando dados do servidor...
flashx.textLayout.edit 

ISelectionManager  - AS3

Pacoteflashx.textLayout.edit
Interfacepublic interface ISelectionManager extends IInteractionEventHandler
Implementadores SelectionManager

Versão da linguagem: ActionScript 3.0
Versões de runtime: Flash Player 10, AIR 1.5

A interface ISelectionManager define a interface para gerenciar a seleção de texto.

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



Propriedades públicas
 PropriedadeDefinido 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étodos públicos
 MétodoDefinido por
 Inherited
Processa um evento de ativação.
IInteractionEventHandler
 Inherited
Processa um evento de desativação.
IInteractionEventHandler
 Inherited
Processa um evento de edição.
IInteractionEventHandler
  
Executa qualquer FlowOperations pendente.
ISelectionManager
 Inherited
Processa um evento focusChange.
IInteractionEventHandler
 Inherited
Processa um evento focusIn.
IInteractionEventHandler
 Inherited
Processa um evento focusOut.
IInteractionEventHandler
  
Obtém os atributos de formato de caractere comuns a todos os caracteres do intervalo de texto especificado ou da seleção atual.
ISelectionManager
  
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
  
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
 Inherited
Processa um evento imeStartComposition
IInteractionEventHandler
  
Indica se a seleção cobre um intervalo de texto.
ISelectionManager
 Inherited
Processa um evento keyDown.
IInteractionEventHandler
 Inherited
Processa um evento keyFocusChange.
IInteractionEventHandler
 Inherited
Processa um evento keyUp.
IInteractionEventHandler
 Inherited
Processa um evento menuSelect.
IInteractionEventHandler
 Inherited
Processa um evento mouseDoubleClick.
IInteractionEventHandler
 Inherited
Processa um evento mouseDown.
IInteractionEventHandler
 Inherited
Processa um evento mouseMove.
IInteractionEventHandler
 Inherited
Processa um evento mouseOut.
IInteractionEventHandler
 Inherited
Processa um evento mouseOver.
IInteractionEventHandler
 Inherited
Processa um evento mouseUp.
IInteractionEventHandler
 Inherited
Processa um evento mouseWheel.
IInteractionEventHandler
  
notifyInsertOrDelete(absolutePosition:int, length:int):void
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
  
selectRange(anchorPosition:int, activePosition:int):void
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
 Inherited
Processa um evento softKeyboardActivating
IInteractionEventHandler
 Inherited
Processa um TextEvent.
IInteractionEventHandler
Detalhes da propriedade

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

flashx.textLayout.EditingMode

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
Detalhes do método

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.

Retorna
flashx.textLayout.formats:TextLayoutFormat — As configurações comuns de estilo de caracteres

Exemplo  ( Como usar este exemplo )

O exemplo a seguir ilustra como obter um objeto ITextLayoutFormat contendo as configurações de estilo de caractere comuns a todos os elementos na seleção. (A variável textFlow no exemplo é um objeto TextFlow.)
 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.

Retorna
flashx.textLayout.formats:TextLayoutFormat — As configurações comuns de estilo de contêineres

Exemplo  ( Como usar este exemplo )

O exemplo a seguir ilustra como obter um objeto ITextLayoutFormat contendo as configurações de estilo de contêiner comuns a todos os elementos na seleção. (A variável textFlow no exemplo é um objeto TextFlow.)
 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.

Retorna
flashx.textLayout.formats:TextLayoutFormat — As configurações comuns de estilo de parágrafos

Exemplo  ( Como usar este exemplo )

O exemplo a seguir ilustra como obter um objeto ITextLayoutFormat contendo as configurações de estilo de parágrafo comuns a todos os elementos na seleção. (A variável textFlow no exemplo é um objeto TextFlow.)
 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.

Retorna
SelectionState

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

O exemplo a seguir obtém um objeto SelectionState da seleção atual em um fluxo de texto. (A variável textFlow no exemplo é um objeto TextFlow.)
 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).

Retorna
Boolean

Exemplo  ( Como usar este exemplo )

O exemplo a seguir ilustra como determinar se um fluxo de texto tem uma seleção. (A variável textFlow no exemplo é um objeto TextFlow.)
 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.

Retorna
Boolean

Exemplo  ( Como usar este exemplo )

O exemplo a seguir ilustra como determinar se a seleção atual em um fluxo de texto estende-se sobre um intervalo do texto. (A variável textFlow no exemplo é um objeto TextFlow.)
 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 )

O exemplo a seguir ilustra como uma função numa classe de Operação personalizada chamaria o método 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 )

O exemplo a seguir cria um fluxo de texto e faz uma seleção:
 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 )

O exemplo a seguir estabelece o foco no primeiro contêiner na seleção atual de um fluxo de texto. (A variável textFlow no exemplo é um objeto TextFlow.)
 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





[ X ]Por que inglês?
O conteúdo na Referência do ActionScript 3.0 aparece em inglês

Nem todas as partes da Referência do ActionScript 3.0 estão traduzidas em todos os idiomas. Quando um elemento de um idioma não está traduzido, ele é exibido em inglês. Por exemplo, a classe ga.controls.HelpBox não está traduzida em nenhum idioma. Por isso, na versão da referência em português do Brasil, a classe ga.controls.HelpBox é exibida em inglês.