Pacote | flashx.textLayout.elements |
Classe | public class SpanElement |
Herança | SpanElement FlowLeafElement FlowElement Object |
Subclasses | SpecialCharacterElement |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
Um ParagraphElement terá um único objeto SpanElement se todo o texto do parágrafo compartilhar o mesmo conjunto de atributos. Ele tem vários objetos SpanElement se o texto do parágrafo tiver mais de um formato.
Propriedade MXML padrãomxmlChildren
Mais exemplos
Elementos da API relacionados
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 [substituir] [somente leitura]
Os atributos de formato de texto calculados válidos para este elemento. | FlowLeafElement | ||
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 | ||
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 | ||
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
Compõe o texto com base no conteúdo dentro das marcas de intervalo; sempre exclui os filhos existentes. | SpanElement | ||
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 | ||
text : String
Recebe a String de texto que este objeto SpanElement contém. | SpanElement | ||
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étodo | Definido por | ||
---|---|---|---|
Construtor – cria um objeto SpanElement para conter uma sequência de texto em um parágrafo. | SpanElement | ||
Apaga o estilo especificado por styleProp a partir deste objeto FlowElement. | 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 | ||
Compare o userStyles deste com o userStyles de otherElement. | FlowElement | ||
Gera o local inicial do elemento no fluxo de texto como um índice absoluto. | FlowElement | ||
Gera o caractere na posição especificada, em relação a este objeto FlowElement. | FlowElement | ||
Gera o código do caractere na posição especificada, em relação a este FlowElement. | FlowElement | ||
Gera o objeto FontMetrics do intervalo. | FlowLeafElement | ||
Gera o início deste elemento em relação a um elemento precedente. | FlowElement | ||
Gera o próximo objeto FlowLeafElement. | FlowLeafElement | ||
Gera o próximo irmão FlowElement na hierarquia do fluxo de texto. | FlowElement | ||
Gera o objeto ParagraphElement associado a este elemento. | FlowElement | ||
Gera o objeto FlowLeafElement anterior. | FlowLeafElement | ||
Gera o irmão FlowElement anterior na hierarquia do fluxo de texto. | FlowElement | ||
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 | ||
Adquire o intervalo de texto especificado de um elemento de fluxo. | FlowElement | ||
Sobe na hierarquia do fluxo de texto para gerar o objeto TextFlow de raiz do elemento. | FlowElement | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
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 | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Atualiza o texto no intervalo de texto, com base nas posições inicial e final especificadas. | SpanElement | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Define o estilo especificado pelo parâmetro styleProp para o valor especificado pelo parâmetro newValue. | FlowElement | ||
Produz uma cópia deste objeto FlowElement, copiando o conteúdo entre duas posições especificadas de caracteres. | FlowElement | ||
Divide este objeto FlowElement na posição especificada pelo parâmetro relativePosition, que é uma posição relativa deste elemento no texto. | FlowElement | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Retorna o valor primitivo do objeto especificado. | Object |
mxmlChildren | propriedade |
mxmlChildren:Array
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
Compõe o texto com base no conteúdo dentro das marcas de intervalo; sempre exclui os filhos existentes. Esta propriedade deve ser usada durante a importação compilada de MXML em Flex. Flash Professional ignora esta propriedade. Quando elementos de marcação TLF tiverem outros elementos de marcação TLF como filhos, os filhos serão atribuídos a esta propriedade.
Implementação
public function get mxmlChildren():Array
public function set mxmlChildren(value:Array):void
Lança
TypeError — Se o elemento da matriz não for um SpecialCharacterElement nem uma String.
|
text | propriedade |
text:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
Recebe a String de texto que este objeto SpanElement contém.
O texto de um span não inclui o retorno de carro (CR) no final do parágrafo, mas ele é incluído no valor de textLength
.
Implementação
public function get text():String
public function set text(value:String):void
SpanElement | () | Construtor |
public function SpanElement()
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
Construtor – cria um objeto SpanElement para conter uma sequência de texto em um parágrafo.
replaceText | () | método |
public function replaceText(relativeStartPosition:int, relativeEndPosition:int, textValue:String):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10, AIR 1.5 |
Atualiza o texto no intervalo de texto, com base nas posições inicial e final especificadas. Para inserir um texto, a posição final deve ser igual à posição inicial. Para anexar um texto ao texto existente no span, as posições inicial e final devem ser iguais ao comprimento do texto existente.
O texto substituído contém o caractere inicial e até (sem incluir) o caractere final.
Parâmetros
relativeStartPosition:int — A posição de índice do início do texto a ser substituído, em relação ao início do span. O primeiro caractere do span está na posição 0.
| |
relativeEndPosition:int — O índice que estiver uma posição depois do último caractere do texto a ser substituído, em relação ao início do span. Este valor deve ser relativeStartPos para uma inserção.
| |
textValue:String — O texto substituto ou o texto a ser adicionado, conforme o caso.
|
Lança
RangeError — A relativeStartPosition ou relativeEndPosition especificada está fora do intervalo ou um par de códigos está sendo dividido por causa da substituição.
|
Exemplo ( Como usar este exemplo )
O exemplo utiliza um segundo span (span2) para exibir os resultados.
package flashx.textLayout.elements.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.TextFlow; public class SpanElement_replaceTextExample extends Sprite { public function SpanElement_replaceTextExample() { // create container and add it to the stage var container:Sprite = new Sprite(); this.stage.addChild(container); // create TextFlow, ParagraphElement, and SpanElement objects var textFlow:TextFlow = new TextFlow(); var paragraph:ParagraphElement = new ParagraphElement(); var span:SpanElement = new SpanElement; var span2:SpanElement = new SpanElement; // add composer and container controller var controller:ContainerController = new ContainerController(container, 200, 700 ); textFlow.flowComposer.addController(controller); textFlow.fontSize = 24; // set font size // create text string and add it to the span var str:String = "0123456"; span.text = str; // insert at the beginning span.replaceText(0, 0, "abc"); span2.text = span.text + '\n'; // append to the end of the text span.replaceText(10, 10, "abc"); span2.text += span.text + '\n'; // insert string in the middle of the text span.replaceText(5, 8, "abc"); span2.text += span.text + '\n'; // replace text with string span.replaceText(0, 13, "abc"); span2.text += span.text + '\n'; // replace text with string span.replaceText(0, 3, "That's all she wrote!\n"); span2.text += span.text + '\n'; // display the results paragraph.addChild(span2); textFlow.addChild(paragraph); textFlow.flowComposer.updateAllControllers(); } } }
package flashx.textLayout.elements.examples { import flash.display.Sprite; import flash.text.engine.FontPosture; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.TextFlow; public class SpanElementExample extends Sprite { public function SpanElementExample() { // create a container and add it to the stage var container:Sprite = new Sprite(); this.stage.addChild(container); // create TextFlow, ParagraphElement, and SpanElement objects var textFlow:TextFlow = new TextFlow(); var p:ParagraphElement = new ParagraphElement(); var spanHello:SpanElement = new SpanElement(); var spanWorld:SpanElement = new SpanElement(); // add text and styles to the spans spanHello.text = "Hello, "; spanHello.fontSize = 48; spanWorld.text = "World!"; spanWorld.fontSize = 56; spanWorld.fontStyle = FontPosture.ITALIC; spanWorld.color = 0xFFCC00; // add spans to paragraph, paragraph to text flow p.addChild(spanHello); p.addChild(spanWorld); textFlow.addChild(p); // update controller to display text var controller:ContainerController = new ContainerController(container, 400, 200 ); textFlow.flowComposer.addController(controller); textFlow.flowComposer.updateAllControllers(); } } }
Wed Jun 13 2018, 11:10 AM Z