LinkElement

Pacote	flashx.textLayout.elements
Classe	public final class LinkElement
Herança	LinkElement SubParagraphGroupElementBase FlowGroupElement FlowElement Object
Implementações	IEventDispatcher

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

A classe LinkElement define um link para um URI (Identificador Universal de Recursos), executado quando o usuário clica nele. A classe LinkElement é uma subclasse da classe SubParagraphGroupElementBase e pode conter um ou mais objetos FlowElement, tais como um objeto SpanElement que armazena o texto do link. Um LinkElement vazio que não contenha um objeto FlowElement é ignorado.

Geralmente quando clicado o LinkElement chamará o método flash.net.navigateToURL(). Um evento de esquema URI especial: também é compatível. Este esquema gerará um evento TextFlow que o usuário pode escutar para executar o código AS3. Um exemplo está incluído abaixo.

Se você especificar um destino, ele deverá ter um dos seguintes valores:

Valor de destino	descrição
_self	Substitui a página HTML atual. Se estiver em um quadro ou em um frameset, ela será carregada nesse quadro. Se for o navegador completo, será aberta para substituir a página de origem.
_blank	Abre um novo nome de navegador sem nome.
_parent	Substitui sua página HTML de origem.
_top	Carrega no navegador atual, substituindo tudo o que houver nele, como um frameset.

Propriedade MXML padrãomxmlChildren

Veja os exemplos

Mais exemplos

Creating TextFlow objects
Adding hyperlinks with TLF

Elementos da API relacionados

LinkState
FlowElement.linkActiveFormat
FlowElement.linkHoverFormat
FlowElement.linkNormalFormat
TextFlow

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		alignmentBaseline : * TextLayoutFormat: especifica a linha de base à qual a linha de base dominante se alinha.	FlowElement
		backgroundAlpha : * TextLayoutFormat: Valor de Alfa (transparência) do plano de fundo (adota o valor padrão se não for definido durante o cascateamento).	FlowElement
		backgroundColor : * TextLayoutFormat: Cor do plano de fundo do texto (adota o valor padrão se não for definido durante o cascateamento).	FlowElement
		baselineShift : * TextLayoutFormat: quantidade para deslocar a linha de base do valor dominantBaseline.	FlowElement
		blockProgression : * TextLayoutFormat: especifica uma progressão vertical ou horizontal da colocação de linha.	FlowElement
		breakOpportunity : * TextLayoutFormat: controla onde as linhas são permitidas para quebrar o texto em diversas linhas.	FlowElement
		cffHinting : * TextLayoutFormat: O tipo de referência CFF usado nesse texto.	FlowElement
		clearFloats : * TextLayoutFormat: Controla como texto envolve um float.	FlowElement
		color : * TextLayoutFormat: Cor do texto.	FlowElement
		columnCount : * TextLayoutFormat: o número de colunas de texto (adota o valor padrão se indefinido durante a cascata).	FlowElement
		columnGap : * TextLayoutFormat: especifica a quantidade do espaço de sarjeta, em pixels, para dobra de colunas (adota o valor padrão se indefinido durante a cascata).	FlowElement
		columnWidth : * TextLayoutFormat: a largura da coluna em pixels (adota o valor padrão se indefinido durante a cascata).	FlowElement
		computedFormat : flashx.textLayout.formats:ITextLayoutFormat [somente leitura] Gera os atributos calculados de formato válidos para este elemento.	FlowElement
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		coreStyles : Object [somente leitura] Retorna os coreStyles neste FlowElement.	FlowElement
		digitCase : * TextLayoutFormat: o tipo da caixa de dígito usado para este texto.	FlowElement
		digitWidth : * TextLayoutFormat: o tipo da largura de dígito usado para este texto.	FlowElement
		direction : * TextLayoutFormat: Especifica o nível de incorporação bidirecional padrão do texto no bloco de texto.	FlowElement
		dominantBaseline : * TextLayoutFormat: especifica que linha de base de elemento se ajusta ao alignmentBaseline para determinar a posição vertical do elemento na linha.	FlowElement
		firstBaselineOffset : * TextLayoutFormat: especifica a posição de linha de base da primeira linha no container.	FlowElement
		fontFamily : * TextLayoutFormat: O nome da fonte a ser usada ou uma lista dos nomes de fonte separados por vírgulas.	FlowElement
		fontLookup : * TextLayoutFormat: busca de fonte para usar.	FlowElement
		fontSize : * TextLayoutFormat: o tamanho do texto em pixels.	FlowElement
		fontStyle : * TextLayoutFormat: estilo de texto.	FlowElement
		fontWeight : * TextLayoutFormat: espessura do texto.	FlowElement
		format : flashx.textLayout.formats:ITextLayoutFormat Propriedades do TextLayoutFormat aplicadas diretamente a este elemento.	FlowElement
		href : String O Identificador Uniforme de Recursos (URI) associado ao objeto LinkElement.	LinkElement
		id : String Atribui um nome identificador ao elemento, possibilitando definir um estilo para o elemento através da referência à id.	FlowElement
		justificationRule : * TextLayoutFormat: regra usada para justificar o texto em um parágrafo.	FlowElement
		justificationStyle : * TextLayoutFormat: o estilo usado para a justificação do parágrafo.	FlowElement
		kerning : * TextLayoutFormat: O kerning ajusta os pixels entre determinados pares de caracteres para aprimorar a legibilidade.	FlowElement
		leadingModel : * TextLayoutFormat: especifica o modelo de entrelinha, que é uma combinação de base e direção de entrelinha.	FlowElement
		ligatureLevel : * TextLayoutFormat: controla quai das ligaduras que são definidas na fonte podem ser usadas no texto.	FlowElement
		lineBreak : * TextLayoutFormat: controla a quebra de texto dentro do container (adota o valor padrão se indefinido durante a cascata).	FlowElement
		lineHeight : * TextLayoutFormat: controles de entrelinha do texto.	FlowElement
		lineThrough : * TextLayoutFormat: se verdadeiro, aplica-se tachado, uma linha desenhada no meio do texto.	FlowElement
		linkActiveFormat : * TextLayoutFormat: define os atributos de formatação usados para links em estado normal.	FlowElement
		linkHoverFormat : * TextLayoutFormat: define os atributos de formatação utilizados para links em estado de foco, quando o mouse está sobre os limites (rolando sobre) um link.	FlowElement
		linkNormalFormat : * TextLayoutFormat: define os atributos de formatação usados para links em estado normal.	FlowElement
		linkState : String [somente leitura] O estado atual do link.	LinkElement
		listAutoPadding : * TextLayoutFormat: isto especifica um recuo automático da borda inicial de listas quando o valor de preenchimento da lista neste lado é automático.	FlowElement
		listMarkerFormat : * TextLayoutFormat: define a formatação dos marcadores de lista de atributos.	FlowElement
		listStylePosition : * TextLayoutFormat: os valores permitidos são ListStylePosition.INSIDE, ListStylePosition.OUTSIDE, FormatValue.INHERIT. O valor padrão é indefinido indicando não configurado. Se não for definido durante o cascateamento, esta propriedade herdará seu valor de um ancestral.	FlowElement
		listStyleType : * TextLayoutFormat: Os valores permitidos são ListStyleType.UPPER_ALPHA, ListStyleType.LOWER_ALPHA, ListStyleType.UPPER_ROMAN, ListStyleType.LOWER_ROMAN, ListStyleType.NONE, ListStyleType.DISC, ListStyleType.CIRCLE, ListStyleType.SQUARE, ListStyleType.BOX, ListStyleType.CHECK, ListStyleType.DIAMOND, ListStyleType.HYPHEN, ListStyleType.ARABIC_INDIC, ListStyleType.BENGALI, ListStyleType.DECIMAL, ListStyleType.DECIMAL_LEADING_ZERO, ListStyleType.DEVANAGARI, ListStyleType.GUJARATI, ListStyleType.GURMUKHI, ListStyleType.KANNADA, ListStyleType.PERSIAN, ListStyleType.THAI, ListStyleType.URDU, ListStyleType.CJK_EARTHLY_BRANCH, ListStyleType.CJK_HEAVENLY_STEM, ListStyleType.HANGUL, ListStyleType.HANGUL_CONSTANT, ListStyleType.HIRAGANA, ListStyleType.HIRAGANA_IROHA, ListStyleType.KATAKANA, ListStyleType.KATAKANA_IROHA, ListStyleType.LOWER_ALPHA, ListStyleType.LOWER_GREEK, ListStyleType.LOWER_LATIN, ListStyleType.UPPER_ALPHA, ListStyleType.UPPER_GREEK, ListStyleType.UPPER_LATIN, FormatValue.INHERIT. O valor padrão é indefinido indicando não configurado. Se não for definido durante o cascateamento, esta propriedade herdará seu valor de um ancestral.	FlowElement
		locale : * TextLayoutFormat: O local do texto.	FlowElement
		mxmlChildren : Array Acrescenta uma matriz de filhos a este objeto.	FlowGroupElement
		numChildren : int [somente leitura] Gera o número de filhos do FlowElement que este objeto FlowGroupElement possui.	FlowGroupElement
		paddingBottom : * TextLayoutFormat: inserção inferior em pixels.	FlowElement
		paddingLeft : * TextLayoutFormat: Inserção esquerda em pixels.	FlowElement
		paddingRight : * TextLayoutFormat: inserção direita em pixels.	FlowElement
		paddingTop : * TextLayoutFormat: inserção superior em pixels.	FlowElement
		paragraphEndIndent : * TextLayoutFormat: um número que especifica, em pixels, a quantidade para recuar a borda de fim do parágrafo.	FlowElement
		paragraphSpaceAfter : * TextLayoutFormat: Um Número que especifica a quantidade de espaço, em pixels, a ser deixada após o parágrafo.	FlowElement
		paragraphSpaceBefore : * TextLayoutFormat: Um Número que especifica a quantidade de espaço, em pixels, a ser deixada antes do parágrafo.	FlowElement
		paragraphStartIndent : * TextLayoutFormat: um número que especifica, em pixels, a quantidade para recuar a borda inicial do parágrafo.	FlowElement
		parent : FlowGroupElement [somente leitura] Gera o pai deste objeto FlowElement.	FlowElement
		parentRelativeEnd : int [somente leitura] Gera o fim relativo deste objeto FlowElement no pai.	FlowElement
		parentRelativeStart : int [somente leitura] Gera o início relativo deste objeto FlowElement no pai.	FlowElement
		renderingMode : * TextLayoutFormat: O modo de renderização usado nesse texto.	FlowElement
		styleName : * TextLayoutFormat: atribui uma classe de identificação ao elemento, permitindo definir um estilo para o elemento por meio da referência a styleName.	FlowElement
		styles : Object [somente leitura] Retorna os estilos neste FlowElement.	FlowElement
		tabStops : * TextLayoutFormat: especifica as paradas de tabulação associadas ao parágrafo.	FlowElement
		target : String O valor de Destino associado ao LinkElement.	LinkElement
		textAlign : * TextLayoutFormat: alinhamento de linhas no parágrafo em relação ao container.	FlowElement
		textAlignLast : * TextLayoutFormat: alinhamento da última (ou única) linha no parágrafo em relação ao container em texto justificado.	FlowElement
		textAlpha : * TextLayoutFormat: Valor Alfa (transparência) do texto.	FlowElement
		textDecoration : * TextLayoutFormat: decoração no texto.	FlowElement
		textIndent : * TextLayoutFormat: um número que especifica, em pixels, a quantidade para recuar a primeira linha do parágrafo.	FlowElement
		textJustify : * TextLayoutFormat: especifica opções para justificar o texto.	FlowElement
		textLength : int [somente leitura] Gera o comprimento total de texto de propriedade deste objeto FlowElement e do seu filho.	FlowElement
		textRotation : * TextLayoutFormat: determina o número de graus para girar este texto.	FlowElement
		tracking : Object [somente gravação] Define o controle e é sinônimo da propriedade trackingRight.	FlowElement
		trackingLeft : * TextLayoutFormat: Número, em pixels (ou porcentagem de fontSize, como 120%) que indica a quantidade de rastreamento (kerning manual) a ser aplicado à esquerda de cada caractere.	FlowElement
		trackingRight : * TextLayoutFormat: Número, em pixels (ou porcentagem de fontSize, como 120%) que indica a quantidade de rastreamento (kerning manual) a ser aplicado à direita de cada caractere.	FlowElement
		typeName : String Cada FlowElement tem um typeName.	FlowElement
		typographicCase : * TextLayoutFormat: o tipo de caixa tipográfica usado para este texto.	FlowElement
		userStyles : Object Permite ler e gravar estilos de usuários em um objeto FlowElement.	FlowElement
		verticalAlign : * TextLayoutFormat: o alinhamento vertical ou a justificação (adota o valor padrão se indefinido durante a cascata).	FlowElement
		whiteSpaceCollapse : * TextLayoutFormat: oculta ou mantém espaços em branco ao importar texto em um TextFlow.	FlowElement
		wordSpacing : * TextLayoutFormat: especifica o espaçamento ideal, mínimo e máximo (como um multiplicador da largura de um espaço normal) entre palavras a ser utilizado durante a justificação.	FlowElement

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		LinkElement() Construtor - cria uma nova instância de LinkElement.	LinkElement
		addChild(child:FlowElement):FlowElement Anexa um objeto FlowElement filho.	FlowGroupElement
		addChildAt(index:uint, child:FlowElement):FlowElement Acrescenta um objeto FlowElement filho na posição de índice especificada.	FlowGroupElement
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.	LinkElement
		clearStyle(styleProp:String):void Apaga o estilo especificado por styleProp a partir deste objeto FlowElement.	FlowElement
		deepCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement Faz uma cópia profunda deste objeto FlowElement, inclusive os filhos, copiando o conteúdo entre as duas posições de caracteres especificadas e gerando a cópia como um objeto FlowElement.	FlowElement
		dispatchEvent(evt:Event):Boolean Envia um evento para o fluxo de eventos.	LinkElement
		equalUserStyles(otherElement:FlowElement):Boolean Compare o userStyles deste com o userStyles de otherElement.	FlowElement
		findChildIndexAtPosition(relativePosition:int):int Dada uma posição relativa de texto, localiza o índice do primeiro FlowElement filho que contenha a posição relativa.	FlowGroupElement
		findLeaf(relativePosition:int):FlowLeafElement Dada uma posição relativa de texto, localizar o elemento de folha que contém a posição.	FlowGroupElement
		getAbsoluteStart():int Gera o local inicial do elemento no fluxo de texto como um índice absoluto.	FlowElement
		getCharAtPosition(relativePosition:int):String Gera o caractere na posição especificada, em relação a este objeto FlowElement.	FlowElement
		getCharCodeAtPosition(relativePosition:int):int Gera o código do caractere na posição especificada, em relação a este FlowElement.	FlowElement
		getChildAt(index:int):FlowElement Gera o FlowElement filho no índice especificado.	FlowGroupElement
		getChildIndex(child:FlowElement):int Pesquisa nos filhos o objeto FlowElement especificado e gera sua posição no índice.	FlowGroupElement
		getElementRelativeStart(ancestorElement:FlowElement):int Gera o início deste elemento em relação a um elemento precedente.	FlowElement
		getFirstLeaf():FlowLeafElement Gera o primeiro descendente FlowLeafElement deste grupo.	FlowGroupElement
		getLastLeaf():FlowLeafElement Gera o último descendente FlowLeafElement deste grupo.	FlowGroupElement
		getNextSibling():FlowElement Gera o próximo irmão FlowElement na hierarquia do fluxo de texto.	FlowElement
		getParagraph():ParagraphElement Gera o objeto ParagraphElement associado a este elemento.	FlowElement
		getPreviousSibling():FlowElement Gera o irmão FlowElement anterior na hierarquia do fluxo de texto.	FlowElement
		getStyle(styleProp:String):* Gera o valor do estilo especificado pelo parâmetro styleProp, que especifica o nome do estilo e pode conter qualquer nome de estilo do usuário.	FlowElement
		getText(relativeStart:int = 0, relativeEnd:int = -1, paragraphSeparator:String = " "):String [substituir]	FlowGroupElement
		getTextFlow():flashx.textLayout.elements:TextFlow Sobe na hierarquia do fluxo de texto para gerar o objeto TextFlow de raiz do elemento.	FlowElement
		hasEventListener(type:String):Boolean Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.	LinkElement
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		initialized(document:Object, id:String):void Uma chamada dos objetos MXML depois do objeto de implementação foi criada, e todas as propriedades componentes especificadas na tag de MXML foram inicializadas.	FlowElement
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		removeChild(child:FlowElement):FlowElement Retira do grupo o objeto FlowElement filho especificado.	FlowGroupElement
		removeChildAt(index:uint):FlowElement Retira o objeto FlowElement filho da posição especificada do índice.	FlowGroupElement
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um ouvinte do objeto EventDispatcher.	LinkElement
		replaceChildren(beginChildIndex:int, endChildIndex:int, ... rest):void Substitui elementos filhos no grupo pelos novos elementos especificados.	FlowGroupElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		setStyle(styleProp:String, newValue:*):void Define o estilo especificado pelo parâmetro styleProp para o valor especificado pelo parâmetro newValue.	FlowElement
		shallowCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement Produz uma cópia deste objeto FlowElement, copiando o conteúdo entre duas posições especificadas de caracteres.	FlowElement
		splitAtIndex(childIndex:int):FlowGroupElement Divide este objeto na posição especificada pelo parâmetro childIndex.	FlowGroupElement
		splitAtPosition(relativePosition:int):FlowElement Divide este objeto FlowElement na posição especificada pelo parâmetro relativePosition, que é uma posição relativa deste elemento no texto.	FlowElement
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna a representação de string do objeto especificado.	Object
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object
		willTrigger(type:String):Boolean Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.	LinkElement

Eventos

Clique para obter mais informações sobre eventos

	Resumo	Definido por
click	Despachado ao se clicar no link.	LinkElement
mouseDown	Despachado quando o mouse é pressionado em um link.	LinkElement
mouseMove	Despachado quando o mouse passa sobre o link.	LinkElement
mouseUp	Despachado quando o mouse sai de um link.	LinkElement
rollOut	Despachado quando o mouse sai do link.	LinkElement
rollOver	Despachado quando o mouse acaba de entrar no link.	LinkElement

Detalhes da propriedade

href	propriedade

href:String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

O Identificador Uniforme de Recursos (URI) associado ao objeto LinkElement. O URI pode ser qualquer URI contemplado pelo método flash.net.navigateToURL(). Esta propriedade é vinculada ao parâmetro request nesse método. O URI também pode ser do formulário event:eventType. Quando clicado o TextFlow gerará um evento do tipo eventType.

Implementação
public function get href():String
public function set href(value:String):void

Elementos da API relacionados

flash.net.navigateToURL()

linkState

propriedade

linkState:String [somente leitura]

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

O estado atual do link.

Implementação
public function get linkState():String

Elementos da API relacionados

LinkState

target

propriedade

target:String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

O valor de Destino associado ao LinkElement. Os valores possíveis são "_self", "_blank", "_parent" e "_top". Esse valor está correlacionado ao parâmetro window do método flash.net.navigateToURL().

Implementação
public function get target():String
public function set target(value:String):void

Elementos da API relacionados

flash.net.navigateToURL()

Detalhes do construtor

()

Construtor

public function LinkElement()

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Construtor - cria uma nova instância de LinkElement.

Detalhes do método

addEventListener

()

método

 public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. Você pode registrar ouvintes de eventos em todos os nós da lista de exibição de um tipo específico de evento, fase e prioridade.

Depois de registrar um ouvinte de evento com êxito, não será possível alterar a respectiva prioridade por meio de chamadas adicionais para o addEventListener(). Para alterar a prioridade de um ouvinte, chame primeiramente o removeEventListener(). Em seguida, você poderá registrar o ouvinte novamente com o novo nível de prioridade.

Depois que o ouvinte for registrado, chamadas subsequentes para o addEventListener() com um valor diferente para type ou useCapture resultarão na criação de um registro de ouvinte separado. Por exemplo, se você primeiro registrar um ouvinte com o useCapture definido como true, ele escutará apenas durante a fase de captura. Se você chamar o addEventListener() novamente, usando o mesmo objeto de ouvinte, mas com o useCapture definido como false, você terá dois ouvintes distintos: um que escuta durante a fase de captura e outro que escuta durante as fases de destino e de bubbling.

Você não pode registrar um ouvinte de evento apenas para a fase de destino ou a fase de bubbling. Essas fases são emparelhadas durante o registro porque o bubbling se aplica apenas aos ancestral do nó-alvo.

Quando você não precisar ais de um ouvinte de evento, remova-o, chamando o EventDispatcher.removeEventListener(); do contrário, poderão ocorrer problemas de memória. Objetos com ouvintes de eventos registrados não são removidos automaticamente da memória porque o coletor de lixo não remove objetos que ainda têm referências.

Copiar uma ocorrência do EventDispatcher não copia os ouvintes de eventos a ele anexados. (Se o seu recém-criado nó precisar de um ouvinte de evento, anexe o ouvinte após criar o nó). Entretanto, se você mover uma ocorrência do EventDispatcher, os ouvintes de evento anexados se movimentarão com ele.

Se o ouvinte de evento estiver sendo registrado em um nó enquanto um evento também estiver sendo processado nesse nó, o ouvinte de evento não será disparado durante a fase atual, mas poderá ser disparado durante uma fase posterior no fluxo de eventos, como a fase de bubbling.

Se um ouvinte de evento for removido de um nó enquanto um evento estiver sendo processado no nó, ele ainda será disparado pelas ações atuais. Depois de removido, o ouvinte de evento nunca mais é chamado novamente (a menos que ele seja registrado mais uma vez para processamento futuro).

Parâmetros

	`type:String` — O tipo de evento.

	`listener:Function` — A função de ouvinte que processa o evento. Esta função deve aceitar um objeto event como seu único parâmetro e não deve retornar nada, como mostra este exemplo: `function(evt:Event):void` A função pode ter qualquer nome.

	`useCapture:Boolean` (default = `false`) — Determina se o ouvinte trabalha na fase de captura ou nas fases de destino e bubbling. Se `useCapture` for definido como `true`, o ouvinte processará o evento apenas durante a fase de captura e não na fase de destino nem de bubbling. Se `useCapture` for `false`, o ouvinte processará o evento apenas durante a fase de destino ou de bubbling. Para ouvir o evento em todas as três fases, chame o `addEventListener()` duas vezes, uma vez com o `useCapture` definido como `true`, e novamente, com o `useCapture` definido como `false`.

	`priority:int` (default = `0`) — O nível de prioridade do ouvinte de evento. Prioridades são designadas por um número inteiro de 32 bits. Quanto mais alto o número, maior a prioridade. Todos os ouvintes com prioridade n são processados antes dos ouvintes com prioridade n-1. Se dois ou mais ouvintes compartilham a mesma prioridade, eles são processados pela ordem segundo a qual foram adicionados. A prioridade padrão é 0.

	`useWeakReference:Boolean` (default = `false`) — Determina se a referência ao ouvinte é forte ou fraca. Uma referência forte (a padrão) impede que o ouvinte seja coletado como lixo. Uma referência fraca não impede. Funções de membro de nível de classe não estão sujeitas à coleta de lixo, portanto, você pode definir `useWeakReference` como `true` para funções de membro de nível de classe sem sujeitá-las à coleta de lixo. Se você definir `useWeakReference` como `true` para um ouvinte que seja uma função interna aninhada, a função será sujeita à coleta de lixo e não mais será persistente. Se você criar referências à função interna (salve-a em outra variável), então ela não ficará sujeita à coleta de lixo e permanece persistente.

dispatchEvent

()

método

public function dispatchEvent(evt:Event):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Envia um evento para o fluxo de eventos. O destino de evento é o objeto EventDispatcher no qual o método dispatchEvent() é chamado.

Parâmetros

evt:Event — O objeto event despachado para o fluxo de eventos.

Retorna

Boolean — Um valor de true a menos que o preventDefault() seja chamado no evento, caso em que ele retornará false.

hasEventListener

()

método

public function hasEventListener(type:String):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. Isto permite determinar quando um objeto EventDispatcher alterou o tratamento de um tipo de evento na hierarquia de fluxo de eventos. Para determinar se um tipo de evento específico efetivamente dispara um ouvinte de evento, utilize o IEventDispatcher.willTrigger().

A diferença entre o hasEventListener() e o willTrigger() é que o hasEventListener() examina só o objeto a que ele pertence, ao passo que o willTrigger() examina o fluxo de eventos inteiro para o evento especificado pelo parâmetro type.

Parâmetros

type:String — O tipo de evento.

Retorna

Boolean — Um valor true se um ouvinte do tipo especificado for registrado; do contrário, será false.

removeEventListener

()

método

public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Remove um ouvinte do objeto EventDispatcher. Se não existir um ouvinte correspondente registrado com o objeto EventDispatcher, uma chamada para esse método não terá efeito.

Parâmetros

	`type:String` — O tipo de evento.

	`listener:Function` — O objeto de ouvinte a remover.

	`useCapture:Boolean` (default = `false`) — Especifica se o ouvinte foi registrado na fase de captura ou nas fases de destino e bubbling. Se o ouvinte foi registrado para a fase de captura e as fases de destino e bubbling, duas chamadas para o `removeEventListener()` serão necessárias para removê-las: uma chamada com o `useCapture` definido como `true`, e outra, com o `useCapture` definido como `false`.

willTrigger

()

método

public function willTrigger(type:String):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. Este método retorna true se um ouvinte de evento for disparado durante qualquer fase do fluxo de eventos quando um evento do tipo especificado for despachado para esse objeto EventDispatcher ou para algum de seus descendentes.

Parâmetros

type:String — O tipo de evento.

Retorna

Boolean — Um valor true se um ouvinte do tipo especificado será disparado; do contrário, será false.

Detalhe do evento

click

Evento

Tipo do objeto de evento: flashx.textLayout.events.FlowElementMouseEvent
propriedade FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.CLICK

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Despachado ao se clicar no link. Os clientes podem ignorar a maneira como o link trata do evento, tratando-o por si mesmos e chamando preventDefault().

Define o valor da propriedade type de um objeto de evento click.

mouseDown

Evento

Tipo do objeto de evento: flashx.textLayout.events.FlowElementMouseEvent
propriedade FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.MOUSE_DOWN

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Despachado quando o mouse é pressionado em um link.

Define o valor da propriedade type de um objeto de evento mouseDown.

mouseMove

Evento

Tipo do objeto de evento: flashx.textLayout.events.FlowElementMouseEvent
propriedade FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.MOUSE_MOVE

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Despachado quando o mouse passa sobre o link.

Define o valor da propriedade type de um objeto de evento de evento mouseMove.

mouseUp

Evento

Tipo do objeto de evento: flashx.textLayout.events.FlowElementMouseEvent
propriedade FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.MOUSE_UP

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Despachado quando o mouse sai de um link.

Define o valor da propriedade type de um objeto de evento select.

rollOut

Evento

Tipo do objeto de evento: flashx.textLayout.events.FlowElementMouseEvent
propriedade FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.ROLL_OUT

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Despachado quando o mouse sai do link.

Define o valor da propriedade type de um objeto de evento rollOut.

rollOver

Evento

Tipo do objeto de evento: flashx.textLayout.events.FlowElementMouseEvent
propriedade FlowElementMouseEvent.type = flashx.textLayout.events.FlowElementMouseEvent.ROLL_OVER

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10, AIR 1.5

Despachado quando o mouse acaba de entrar no link.

Define o valor da propriedade type de um objeto de evento rollOver.

Exemplos Como usar este exemplo

LinkElementExample.as

Este exemplo acrescenta um LinkElement em um parágrafo e ignora o formato padrão do estado hover, deixando vermelho o texto do link.

package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.LinkElement;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class LinkElementExample extends Sprite
    {
        public function LinkElementExample()
        {
            var textFlow:TextFlow = new TextFlow();
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
          
            textLayoutFormat.fontFamily = "Arial, Helvetica, _sans";
            textLayoutFormat.fontSize = 18;
            textFlow.hostFormat = textLayoutFormat;

            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var link:LinkElement = new LinkElement();
            var span2:SpanElement = new SpanElement();
            var inf:Object = {color:0xFF0000};   
            p.linkHoverFormat = inf;
            span1.text = "Text that includes a link to "; 
            link.href = "http://www.adobe.com";
            var linkSpan:SpanElement = new SpanElement();
            linkSpan.text = "Adobe's website";
            link.addChild(linkSpan);
            span2.text = ". Notice the custom formatting when the cursor hovers " + 
                    "over the link.";
            p.addChild(span1);
            p.addChild(link);
            p.addChild(span2);
            textFlow.addChild(p);
            textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth, stage.stageHeight));
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

LinkElementEventExample.as

Este exemplo usa o evento: esquema URI para gerar um evento para executar o código de ActionScript no clique.

package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.LinkElement;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.events.FlowElementMouseEvent;
    import flashx.textLayout.formats.TextLayoutFormat;
    
    public class LinkElementEventExample extends Sprite
    {
        public function LinkElementEventExample()
        {
            var textFlow:TextFlow = new TextFlow();
          
            textFlow.fontFamily = "Arial, Helvetica, _sans";
            textFlow.fontSize = 18;
            textFlow.paddingLeft = textFlow.paddingRight = textFlow.paddingTop = 20;

            var p:ParagraphElement = new ParagraphElement();
            var span1:SpanElement = new SpanElement();
            var link:LinkElement = new LinkElement();
            var span2:SpanElement = new SpanElement();
            span1.text = "Text that includes a link to "; 
            link.href = "event:changeTextFlowColor";
            var linkSpan:SpanElement = new SpanElement();
            linkSpan.text = "custom event code"
            link.addChild(linkSpan);
            span2.text = ". Clicking the link changes the default color of the TextFlow";
            p.addChild(span1);
            p.addChild(link);
            p.addChild(span2);
            textFlow.addChild(p);
            textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth, stage.stageHeight));
            textFlow.flowComposer.updateAllControllers();
            textFlow.addEventListener("changeTextFlowColor",changeTextFlowColor)
        }

        private function changeTextFlowColor(e:FlowElementMouseEvent):void
        {
            var textFlow:TextFlow = e.flowElement.getTextFlow();
            textFlow.color = textFlow.color == 0x00ff00 ? 0 : 0x00ff00;
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

Aspectos jurídicos | Política de privacidade on-line

LinkElement - AS3

Pacotesx

Elementos de linguagem

Apêndices

Pacote flashx.textLayout.elements

href

linkState

target

LinkElement

addEventListener

dispatchEvent

hasEventListener

removeEventListener

willTrigger

click

mouseDown

mouseMove

mouseUp

rollOut

rollOver