| Pacote | fl.text |
| Classe | public class TLFTextField |
| Herança | TLFTextField  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Crie um objeto de TLFTextField do mesmo modo que você cria um campo de texto com a classe TextField. Então, use a propriedade textFlow para atribuir a formatação avançada das classes TLF. Por exemplo:
import fl.text.TLFTextField; import flashx.textLayout.formats.TextLayoutFormat; import flashx.textLayout.elements.TextFlow; var myTLFTextField:TLFTextField = new TLFTextField(); addChild(myTLFTextField); myTLFTextField.x = 10; myTLFTextField.y = 10; myTLFTextField.width = 200 myTLFTextField.height = 100; myTLFTextField.text = "This is my text"; var myFormat:TextLayoutFormat = new TextLayoutFormat(); myFormat.textIndent = 8; myFormat.color = 0x336633; myFormat.fontFamily = "Arial, Helvetica, _sans"; myFormat.fontSize = 24; var myTextFlow:TextFlow = myTLFTextField.textFlow; myTextFlow.hostFormat = myFormat; myTextFlow.flowComposer.updateAllControllers();
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
A implementação de acessibilidade atual (AccessibilityImplementation) para esta instância do InteractiveObject. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
As opções de acessibilidade atuais para este objeto de exibição. | DisplayObject | |
| alpha : Number
Indica o valor de transparência alfa do objeto especificado. | DisplayObject | |
| alwaysShowSelection : Boolean
Quando definida como true e o campo de texto não estiver em foco, o Flash Player realçará a seleção no campo de texto em azul claro. | TLFTextField | ||
| antiAliasType : String
O tipo de suavização de borda utilizado para esse campo de texto. | TLFTextField | ||
| autoSize : String
Controla o dimensionamento e o alinhamento automáticos de campos de texto. | TLFTextField | ||
| background : Boolean
Especifica se o campo de texto tem um preenchimento de plano de fundo. | TLFTextField | ||
| backgroundAlpha : Number
Especifica o valor alfa do plano de fundo do campo de texto. | TLFTextField | ||
| backgroundColor : uint
Especifica a cor do plano de fundo do campo de texto. | TLFTextField | ||
| blendMode : String
Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado. | DisplayObject | |
| blendShader : Shader [somente gravação]
Define um shader usado para mesclar o primeiro plano e o segundo plano. | DisplayObject | |
| blockProgression : Object
Especifica uma progressão vertical ou horizontal da colocação de linha. | TLFTextField | ||
| border : Boolean
Especifica se o campo de texto tem uma borda. | TLFTextField | ||
| borderAlpha : Number
Especifica o valor alfa da borda. | TLFTextField | ||
| borderColor : uint
Especifica a cor da borda do campo de texto. | TLFTextField | ||
| borderWidth : Number
Especifica a largura da borda. | TLFTextField | ||
| bottomScrollV : int [somente leitura]
Um inteiro (índice com base 1) que indica a linha na extremidade inferior que está atualmente visível no campo de texto especificado. | TLFTextField | ||
| buttonMode : Boolean
Especifica o modo de botão desta entidade gráfica. | Sprite | |
| cacheAsBitmap : Boolean
Se definido como true, tempo de execução do Flash armazenará em cachê uma representação interna em bitmap do objeto de exibição. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Se não nulo, este objeto Matrix definirá como um objeto exibição será renderizado quando cacheAsBitmap for definido como verdadeiro. | DisplayObject | |
| caretIndex : int [somente leitura]
O índice da posição do ponto de inserção (circunflexo). | TLFTextField | ||
| columnCount : Object
O número de colunas de texto (adota o valor padrão se indefinido durante a cascata). | TLFTextField | ||
| columnGap : Object
Especifica a quantidade do espaço de dobra, em pixels, para deixar entre as colunas (adota o valor padrão se indefinido durante a cascata). | TLFTextField | ||
| columnWidth : Object
A largura da coluna em pixels (adota o valor padrão se indefinido durante a cascata). | TLFTextField | ||
| condenseWhite : Boolean
Um valor booliano que especifica se o espaço em branco extra (espaços, quebras de linha, etc.) em um campo de texto com texto HTML ou marcas TLF deve ser removido. | TLFTextField | ||
| constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| contextMenu : NativeMenu
Especifica o menu de contexto associado a este objeto. | InteractiveObject | |
| defaultTextFormat : flash.text:TextFormat
Especifica o formato aplicado ao texto recém-inserido, por exemplo, o texto inserido com o método replaceSelectedText() ou o texto digitado pelo usuário. | TLFTextField | ||
| direction : String
Especifica o nível de incorporação bidirecional padrão do texto no bloco de texto. | TLFTextField | ||
| displayAsPassword : Boolean
Especifica se o campo de texto é um campo de texto de senha. | TLFTextField | ||
| doubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick. | InteractiveObject | |
| dropTarget : DisplayObject [somente leitura]
Especifica o objeto de exibição sobre o qual a entidade gráfica está sendo arrastada ou no qual a entidade gráfica foi solta. | Sprite | |
| embedFonts : Boolean
Especifica se a renderização será feita com o uso de contornos de fontes incorporadas. | TLFTextField | ||
| filters : Array
Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição. | DisplayObject | |
| firstBaselineOffset : Object
Especifica a posição de linha de base da primeira linha no container. | TLFTextField | ||
| focusRect : Object
Especifica se este objeto exibe um retângulo de foco. | InteractiveObject | |
| graphics : Graphics [somente leitura]
Especifica o objeto Graphics pertencente a esta entidade gráfica em que comandos de desenho de vetor podem ocorrer. | Sprite | |
| gridFitType : String
O tipo de ajuste à grade utilizado para esse campo de texto. | TLFTextField | ||
| height : Number
Indica a altura do objeto de exibição, em pixels. | DisplayObject | |
| hitArea : Sprite
Designa outra entidade gráfica para atuar como área de ocorrência para uma entidade gráfica. | Sprite | |
| htmlText : String
Contém a representação HTML do conteúdo do campo de texto. | TLFTextField | ||
| length : int [somente leitura]
O número de caracteres em um campo de texto. | TLFTextField | ||
| loaderInfo : LoaderInfo [somente leitura]
Retorna um objeto LoaderInfo contendo informações sobre o carregamento do arquivo ao qual esse objeto de exibição pertence. | DisplayObject | |
| mask : DisplayObject
O objeto de exibição de chamada é mascarado pelo objeto "mask" especificado. | DisplayObject | |
| maxChars : int
O número máximo de caracteres que o campo de texto pode conter, conforme digitado por um usuário. | TLFTextField | ||
| maxScrollH : int [somente leitura]
O valor máximo de scrollH. | TLFTextField | ||
| maxScrollV : int [somente leitura]
O valor máximo de scrollV. | TLFTextField | ||
| metaData : Object
Obtém o objeto de metadados da instância DisplayObject se os metadados forem armazenados juntamente com a instância desse DisplayObject no arquivo SWF por uma marca PlaceObject4. | DisplayObject | |
| mouseChildren : Boolean
Determina se os filhos do objeto são ou não ativados pelo mouse, ou dispositivo de entrada do usuário. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. | InteractiveObject | |
| mouseWheelEnabled : Boolean
Um valor booliano que indica se o Flash Player deverá rolar automaticamente os campos de texto de várias linhas quando o usuário clicar em um campo de texto e usar o botão de rolagem do mouse. | TLFTextField | ||
| mouseX : Number [somente leitura]
Indica a coordenada x da posição do dispositivo do mouse ou de entrada do usuário, em pixels. | DisplayObject | |
| mouseY : Number [somente leitura]
Indica a coordenada y da posição do dispositivo do mouse ou de entrada do usuário, em pixels. | DisplayObject | |
| multiline : Boolean
Indica se o campo de texto é um campo de texto de várias linhas. | TLFTextField | ||
| name : String
Indica o nome da ocorrência de DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Especifica se um teclado virtual (teclado de software, na tela) deve ser exibido quando esta instância InteractiveObject recebe foco. | InteractiveObject | |
| numChildren : int [somente leitura]
Retorna o número de filhos deste objeto. | DisplayObjectContainer | |
| numLines : int [somente leitura]
Define o número de linhas de texto em um campo de texto de várias linhas. | TLFTextField | ||
| opaqueBackground : Object
Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo. | DisplayObject | |
| paddingBottom : Object
Margem interna inferior em pixels (adota o valor padrão se indefinido durante a cascata). | TLFTextField | ||
| paddingLeft : Object
Margem interna esquerda em pixels (adota o valor padrão se indefinido durante a cascata). | TLFTextField | ||
| paddingRight : Object
Margem interna direita em pixels (adota o valor padrão se indefinido durante a cascata). | TLFTextField | ||
| paddingTop : Object
Margem interna superior em pixels (adota o valor padrão se indefinido durante a cascata). | TLFTextField | ||
| parent : DisplayObjectContainer [somente leitura]
Indica o objeto DisplayObjectContainer que contém esse objeto de exibição. | DisplayObject | |
| pixelMaxScrollV : int [somente leitura]
O valor máximo de pixelScrollV. | TLFTextField | ||
| pixelScrollV : int
A posição vertical do texto em um campo de texto, em pixeis, diferentemente de scrollV, que é baseado em linhas. | TLFTextField | ||
| restrict : String
Indica o conjunto de caracteres que um usuário pode digitar no campo de texto. | TLFTextField | ||
| root : DisplayObject [somente leitura]
Para um objeto de exibição em um arquivo SWF carregado, a propriedade "root" é o objeto de exibição na extremidade superior, na parte da estrutura em árvore da lista de exibição representada por esse arquivo SWF. | DisplayObject | |
| rotation : Number
Indica o giro da ocorrência de DisplayObject, em graus, a partir da sua orientação original. | DisplayObject | |
| rotationX : Number
Indica a rotação do eixo x da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | |
| rotationY : Number
Indica a rotação do eixo y da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | |
| rotationZ : Number
Indica a rotação do eixo z da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent. | DisplayObject | |
| scale9Grid : Rectangle
A grade de dimensionamento atual que está em vigor. | DisplayObject | |
| scaleX : Number
Indica a escala horizontal (porcentagem) do objeto aplicada a partir do ponto de registro. | DisplayObject | |
| scaleY : Number
Indica a escala vertical (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | |
| scaleZ : Number
Indica a escala de profundidade (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | |
| scrollH : int
A posição de rolagem horizontal atual. | TLFTextField | ||
| scrollRect : Rectangle
Os limites do retângulo de rolagem do objeto de exibição. | DisplayObject | |
| scrollV : int
A posição vertical do texto em um campo de texto. | TLFTextField | ||
| selectable : Boolean
Um valor booliano que indica se o campo de texto é selecionável. | TLFTextField | ||
| selectionBeginIndex : int [somente leitura]
O valor de índice de caractere com base em zero do primeiro caractere na seleção atual. | TLFTextField | ||
| selectionEndIndex : int [somente leitura]
O valor de índice de caractere com base em zero do último caractere na seleção atual. | TLFTextField | ||
| sharpness : Number
A nitidez não é aplicável a TextFields TLF. | TLFTextField | ||
| softKeyboard : String
Controla a aparência do teclado suave. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Define a área que deve permanecer na tela quando um teclado virtual for exibido (não disponível no iOS) | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Controla o som nesta entidade gráfica. | Sprite | |
| stage : Stage [somente leitura]
O Palco do objeto de exibição. | DisplayObject | |
| styleSheet : StyleSheet
Folhas de estilo para o TLF TextField. | TLFTextField | ||
| tabChildren : Boolean
Determina se os filhos do objeto estão ativados para tabulação. | DisplayObjectContainer | |
| tabEnabled : Boolean
Especifica se este objeto está na ordem de tabulação. | InteractiveObject | |
| tabIndex : int
Especifica a ordem de tabulação de objetos em um arquivo SWF. | InteractiveObject | |
| text : String
Uma string que é o texto atual no campo de texto. | TLFTextField | ||
| textColor : uint
A cor do texto em um campo de texto, em formato hexadecimal. | TLFTextField | ||
| textFlow : flashx.textLayout.elements:TextFlow
Use esta propriedade para atribuir a formatação das classes TLF nos pacotes flashx para a instância TLFTextField. | TLFTextField | ||
| textHeight : Number [somente leitura]
A altura do texto, em pixels. | TLFTextField | ||
| textSnapshot : flash.text:TextSnapshot [somente leitura]
Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | |
| textWidth : Number [somente leitura]
A largura do texto, em pixels. | TLFTextField | ||
| thickness : Number
A propriedade de espessura não é aplicável ao TextField TLF. | TLFTextField | ||
| tlfMarkup : String
Define ou adquire a marcação TLF do texto no campo de texto TLF. | TLFTextField | ||
| transform : flash.geom:Transform
Um objeto com propriedades relacionadas aos limites de pixels, matriz e transformação de cores de um objeto de exibição. | DisplayObject | |
| type : String
O tipo do campo de texto. | TLFTextField | ||
| useHandCursor : Boolean
Um valor booliano que indica se a mão que aponta (cursor de mão) aparece quando o ponteiro passa sobre uma entidade gráfica em que a propriedade buttonMode esteja definida como "true". | Sprite | |
| useRichTextClipboard : Boolean
Especifica se é preciso copiar a formatação de texto junto com o texto para a área de transferência. | TLFTextField | ||
| verticalAlign : String
Alinhamento vertical ou justificação (adota o valor padrão se indefinido durante a cascata). | TLFTextField | ||
| visible : Boolean
Se o objeto de exibição está ou não visível. | DisplayObject | |
| width : Number
Indica a largura do objeto de exibição, em pixels. | DisplayObject | |
| wordWrap : Boolean
Um valor booliano que indica se o campo de texto tem quebra automática. | TLFTextField | ||
| x : Number
Indica a coordenada x da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | DisplayObject | |
| y : Number
Indica a coordenada y da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | DisplayObject | |
| z : Number
Indica a posição da coordenada z ao longo do eixo z da ocorrência DisplayObject em relação ao contêiner 3D pai. | DisplayObject | |
| Método | Definido por | ||
|---|---|---|---|
Construtor de objetos TLFTextField. | TLFTextField | ||
|
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | |
|
Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. | DisplayObjectContainer | |
| 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. | EventDispatcher | |
Acrescenta a string especificada pelo parâmetro newText ao final do texto do campo de texto. | TLFTextField | ||
|
Indica se restrições de segurança fariam com que qualquer objeto de exibição fosse omitido da lista retornada com a chamada do método DisplayObjectContainer.getObjectsUnderPoint() junto com o ponto especificado. | DisplayObjectContainer | |
|
Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência. | DisplayObjectContainer | |
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
|
Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace. | DisplayObject | |
Retorna um retângulo que é a caixa delimitadora do caractere. | TLFTextField | ||
Retorna o valor de índice com base em zero do caractere no ponto especificado pelos parâmetros x e y. | TLFTextField | ||
|
Retorna a ocorrência do objeto de exibição-filho que existe no índice especificado. | DisplayObjectContainer | |
|
Retorna o objeto de exibição-filho que existe com o nome especificado. | DisplayObjectContainer | |
|
Retorna a posição de índice de uma ocorrência-filho de DisplayObject. | DisplayObjectContainer | |
Tendo sido fornecido um índice de caractere, retorna o índice do primeiro caractere no mesmo parágrafo. | TLFTextField | ||
Retorna uma referência DisplayObject para o id especificado, para uma imagem ou arquivo SWF que foi adicionado a um campo de texto formatado em HTML com o uso da marca <img>. | TLFTextField | ||
Retorna o valor de índice com base em zero da linha no ponto especificado pelos parâmetros x e y. | TLFTextField | ||
Retorna o valor de índice com base em zero da linha contendo o caractere especificado pelo parâmetro charIndex. | TLFTextField | ||
Retorna o número de caracteres em uma linha de texto específica. | TLFTextField | ||
Retorna informações de métrica de uma determinada linha de texto. | TLFTextField | ||
Retorna o índice de caractere do primeiro caractere na linha que o parâmetro lineIndex especifica. | TLFTextField | ||
Retorna o texto da linha especificada pelo parâmetro lineIndex. | TLFTextField | ||
|
Retorna uma matriz de objetos que estão dispostos no ponto especificado e são filhos (ou netos e assim por diante) desta ocorrência de DisplayObjectContainer. | DisplayObjectContainer | |
Tendo sido fornecido um índice de caractere, retorna o tamanho do parágrafo contendo o caractere específico. | TLFTextField | ||
|
Retorna um retângulo que define o limite do objeto de exibição, com base no sistema de coordenadas definido pelo parâmetro espaçoCoordenadasDestino, excluindo quaisquer traçados em formas. | DisplayObject | |
Retorna um objeto TextFormat que contém informações de formatação do intervalo de texto especificado pelos parâmetros beginIndex e endIndex. | TLFTextField | ||
|
Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais). | DisplayObject | |
|
Converte um ponto bidimensional das coordenadas do Palco (globais) em coordenadas do objeto de exibição tridimensional (locais). | DisplayObject | |
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Avalia a caixa delimitadora do objeto de exibição para ver se ela sobrepõe ou faz interseção com a caixa delimitadora do objeto de exibição obj. | DisplayObject | |
|
Avalia o objeto de exibição para ver se ele sobrepõe ou faz interseção com o ponto especificado pelos parâmetros x e y. | DisplayObject | |
Retorna true se uma fonte incorporada estiver disponível com os parâmetros fontName e fontStyle especificados, em que Font.fontType é flash.text.FontType.EMBEDDED_CFF. | TLFTextField | ||
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Converte um ponto tridimensional das coordenadas (locais) do objeto de exibição tridimensional em ponto bidimensional das coordenadas (globais) do Palco. | DisplayObject | |
|
Converte o objeto de ponto a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais). | DisplayObject | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove uma ocorrência-filho de DisplayObject especificada da lista de filhos da ocorrência de DisplayObjectContainer. | DisplayObjectContainer | |
|
Remove um DisplayObject filho da posição de índice especificada na lista de filhos de DisplayObjectContainer. | DisplayObjectContainer | |
|
Remove todas as instâncias filho DisplayObject especificadas da lista de filhos da instância DisplayObjectContainer. | DisplayObjectContainer | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
Substitui a seleção atual pelo conteúdo do parâmetro value. | TLFTextField | ||
Substitui o intervalo de caracteres especificado pelos parâmetros beginIndex e endIndex pelo conteúdo do parâmetro newText. | TLFTextField | ||
|
Ativa um teclado virtual. | InteractiveObject | |
|
Altera a posição de um filho existente no contêiner de objetos de exibição. | DisplayObjectContainer | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
Define, conforme selecionado, o texto designado pelos valores de índice do primeiro e último caracteres, que são especificados com os parâmetros beginIndex e endIndex. | TLFTextField | ||
Aplica a formatação de texto determinada pelo parâmetro format ao texto especificado em um campo de texto. | TLFTextField | ||
|
Permite ao usuário arrastar a entidade gráfica especificada. | Sprite | |
|
Deixa o usuário arrastar o sprite especificado em um dispositivo ativado pelo toque. | Sprite | |
|
Interrompe repetitivamente a execução da linha de tempo de todos os MovieClips enraizados neste objeto. | DisplayObjectContainer | |
|
Finaliza o método startDrag(). | Sprite | |
|
Termina o método startTouchDrag() para o uso com dispositivos ativados pelo toque. | Sprite | |
|
Alterna a ordem z (ordem da frente para trás) dos dois objetos filhos especificados. | DisplayObjectContainer | |
|
Alterna a ordem z (ordem da frente para trás) dos objetos-filho nas duas posições de índice especificadas na lista de filhos. | DisplayObjectContainer | |
|
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 | |
|
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher | |
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Despachado quando um objeto de exibição é adicionado à lista de exibição. | DisplayObject | ||
| Despachado quando um objeto de exibição é adicionado à lista de exibição no palco, seja diretamente ou através da adição de uma subárvore na qual esse objeto de exibição está contido. | DisplayObject | ||
| Despachado depois que um valor de controle é modificado, ao contrário do evento textInput, que é despachado antes de o valor ser modificado. | TLFTextField | |||
| Despachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto. | InteractiveObject | ||
| Despachado quando um usuário pressiona e solta o botão principal do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | ||
| Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR. | InteractiveObject | ||
| Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de copiar ou seleciona "Copy" no menu de contexto do texto. | InteractiveObject | ||
| Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de cortar ou seleciona "Cut" no menu de contexto do texto. | InteractiveObject | ||
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Despachado quando um usuário pressiona e solta o botão principal de um dispositivo apontador duas vezes em rápida sucessão sobre o mesmo InteractiveObject quando o sinalizador doubleClickEnabled desse objeto está definido como "true". | InteractiveObject | ||
| [evento de transmissão] Despachado quando o indicador de reprodução está entrando em um novo quadro. | DisplayObject | ||
| [evento de transmissão] Despachado quando o indicador de reprodução está deixando o quadro atual. | DisplayObject | ||
| Despachado depois que um objeto de exibição ganha foco. | InteractiveObject | ||
| Despachado depois que um objeto de exibição perde o foco. | InteractiveObject | ||
| [evento de transmissão] Despachado depois que são executados os construtores dos objetos de exibição de quadro, mas antes dos scripts. | DisplayObject | ||
| Enviado quando um usuário cria um ponto de contato na borda da superfície de toque com uma instância InteractiveObject (como tocar na borda da superfície de toque no Siri Remote da Apple TV). Alguns dispositivos também podem interpretar esse contato como uma combinação de vários eventos de toque. | InteractiveObject | ||
| Despachado quando o usuário aperta dois pontos de contato na mesma instância InteractiveObject em um dispositivo ativado pelo toque (como pressionar e soltar dois dedos em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | ||
| Despachado quando o usuário move um ponto de contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como mover os dedos da esquerda para a direita em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | ||
| Despachado quando o usuário executa uma rotação em um ponto do contato com uma instância InteractiveObject (como tocar com dois dedos e rodá-los em cima de um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | ||
| Despachado quando o usuário executa um gesto de arrastar em um ponto de contato com uma instância InteractiveObject (como tocar três dedos em uma tela e depois movê-los em paralelo sobre um objeto de exposição em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | ||
| Despachado quando o usuário cria um ponto do contato com uma instância InteractiveObject, depois toca com um dispositivo ativado pelo toque (como colocar vários dedos em um objeto da tela para abrir um menu e depois toca com um dedo para selecionar um item do menu em um celular ou tablet com tela sensível ao toque). | InteractiveObject | ||
| Despachado quando o usuário executa um zoom em um ponto do contato com uma instância InteractiveObject (como tocar dois dedos em uma tela e depois abrir os dedos por cima de um objeto de exposição em um celular ou tablet com uma tela de toque). | InteractiveObject | ||
| Este evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IME | InteractiveObject | ||
| Despachado quando o usuário pressiona uma tecla. | InteractiveObject | ||
| Despachado quando o usuário tenta alterar o foco usando a navegação pelo teclado. | InteractiveObject | ||
| Despachado quando o usuário solta uma tecla. | InteractiveObject | ||
| Despachado quando um usuário clica em um hiperlink em um campo de texto habilitado para HTML, em que o URL começa com "event:". | TLFTextField | |||
| Despachado quando um usuário pressiona e libera o botão do meio do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário tenta alterar o foco usando um dispositivo apontador. | InteractiveObject | ||
| Despachado quando um usuário move o dispositivo apontador enquanto ele está sobre InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | ||
| Despachado quando a roda do mouse rola sobre uma ocorrência InteractiveObject. | InteractiveObject | ||
| Despachado pelo iniciador de arrasto InteractiveObject quando o usuário libera o gesto de arrastar. | InteractiveObject | ||
| Despachado pelo InteractiveObject de destino quando um objeto arrastado é solto nele e a liberação tiver sido aceita com uma chamada para DragManager.acceptDragDrop(). | InteractiveObject | ||
| Despachado por um InteractiveObject quando o gesto de arrasto entra no respectivo limite. | InteractiveObject | ||
| Despachado por um InteractiveObject quando o gesto de arrasto deixa o respectivo limite. | InteractiveObject | ||
| Despachado continuamente por um InteractiveObject enquanto o gesto de arrasto permanecer dentro do respectivo limite. | InteractiveObject | ||
| Despachado no início de uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag(). | InteractiveObject | ||
| Despachado durante uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag(). | InteractiveObject | ||
| Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de colar ou seleciona "Paste" no menu de contexto do texto. | InteractiveObject | ||
| Despachado quando o usuário abaixa um estilo ativo para além do limite de detecção de proximidade da tela. | InteractiveObject | ||
| Despachado quando o usuário levanta um estilo ativo acima do limite de detecção de proximidade da tela. | InteractiveObject | ||
| Despachado quando o usuário move um estilo ativo sobre a tela enquanto permanece dentro do limite de detecção de proximidade. | InteractiveObject | ||
| Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela. | InteractiveObject | ||
| Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela. | InteractiveObject | ||
| Despachado quando o usuário move um estilo ativo deste InteractiveObject e algum de seus filhos enquanto permanece dentro do limite de detecção de proximidade da tela. | InteractiveObject | ||
| Despachado quando o usuário move um estilo ativo sobre este InteractiveObject do exterior da árvore do objeto de descendentes na lista de exibição (enquanto permanece dentro do limite de detecção de proximidade da tela). | InteractiveObject | ||
| Enviado quando um usuário solta o botão no dispositivo apontador depois que o usuário primeiro pressionou o botão sobre uma instância de InteractiveObject e moveu o dispositivo apontador de da instância para fora do InteractiveObject. | InteractiveObject | ||
| Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição. | DisplayObject | ||
| Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição, seja diretamente ou através da remoção de uma subárvore na qual esse objeto de exibição está contido. | DisplayObject | ||
| [evento de transmissão] Despachado quando a lista de exibição está prestes a ser atualizada e renderizada. | DisplayObject | ||
| Despachado quando um usuário pressiona e libera o botão direito do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. | InteractiveObject | ||
| Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | ||
| Despachado por um objeto TextField após a rolagem pelo usuário. | TLFTextField | |||
| Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de selecionar tudo ou seleciona "Select All" no menu de contexto do texto. | InteractiveObject | ||
| Despachado imediatamente depois que o teclado virtual é elevado. | InteractiveObject | ||
| Despachado imediatamente antes de o teclado virtual ser elevado. | InteractiveObject | ||
| Despachado imediatamente depois que o teclado virtual é baixado. | InteractiveObject | ||
| Despachado quando o valor do sinalizador tabChildren do objeto é alterado. | InteractiveObject | ||
| Despachado quando o sinalizador tabEnabled do objeto é alterado. | InteractiveObject | ||
| Despachado quando o valor da propriedade tabIndex do objeto é alterado. | InteractiveObject | ||
| O Flash Player despacha o evento textInput quando um usuário digita um ou mais caracteres de texto. | TLFTextField | |||
| Despachado quando o usuário entra em contato pela primeira vez com um dispositivo ativado pelo toque (como tocar com um dedo um celular ou tablet com uma tela sensível toque). | InteractiveObject | ||
| Despachado quando o usuário remove o contato com um dispositivo ativado pelo toque (como retirar o dedo de um celular ou tablet com uma tela de toque). | InteractiveObject | ||
| Despachado quando o usuário toca o dispositivo, e é despachado continuamente até que o ponto contato seja removido. | InteractiveObject | ||
| Despachado quando o usuário move o ponto do contato longe da instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para outro em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | ||
| Despachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | ||
| Despachado quando o usuário move o ponto do contato longe de uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para um ponto fora do objeto da tela em um celular ou tablet com uma tela sensível toque). | InteractiveObject | ||
| Despachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | ||
| Despachado quando o usuário levanta o ponto do contato na mesma instância InteractiveObject em que o contato foi iniciado em um dispositivo ativado pelo toque (como pressionar e soltar com o dedo um ponto único em um objeto da tela em um celular ou tablet com uma tela sensível ao toque). | InteractiveObject | ||
alwaysShowSelection | propriedade |
alwaysShowSelection:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Quando definida como true e o campo de texto não estiver em foco, o Flash Player realçará a seleção no campo de texto em azul claro. Quando definida como false e o campo de texto não está em foco, o Flash Player não realça a seleção no campo de texto.
Exemplo:
package
{
import flash.display.Sprite;
import fl.text.TLFTextField;
import flash.text.TextFieldType;
public class TLFTextField_alwaysShowSelection extends Sprite
{
public function TLFTextField_alwaysShowSelection()
{
var label1:TLFTextField = createTLFTextField(0, 20, 200, 20);
label1.text = "This text is selected.";
label1.setSelection(0, 9);
label1.alwaysShowSelection = true;
var label2:TLFTextField = createTLFTextField(0, 50, 200, 20);
label2.text = "Drag to select some of this text.";
}
private function createTLFTextField(x:Number, y:Number, width:Number, height:Number):TLFTextField
{
var result:TLFTextField = new TLFTextField();
result.x = x;
result.y = y;
result.width = width;
result.height = height;
addChild(result);
return result;
}
}
}
O valor padrão é false.
Implementação
public function get alwaysShowSelection():Boolean public function set alwaysShowSelection(value:Boolean):voidElementos da API relacionados
antiAliasType | propriedade |
antiAliasType:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O tipo de suavização de borda utilizado para esse campo de texto. Utilize as constantes de flash.text.AntiAliasType para essa propriedade. Você poderá controlar essa definição apenas se a fonte estiver incorporada (com a propriedade embedFonts definida como true).
Para definir valores para essa propriedade, utilize os seguintes valores de string:
| Valor de string | Descrição |
|---|---|
flash.text.AntiAliasType.NORMAL | Aplica a suavização de borda de texto regular. Corresponde ao tipo de suavização de borda que o Flash Player 7 e versões anteriores utilizaram. |
flash.text.AntiAliasType.ADVANCED | Aplica a suavização de borda avançada, que torna o texto mais legível. (Esse recurso tornou-se disponível no Flash Player 8.) A suavização de borda avançada possibilita a renderização de alta qualidade das faces de fonte em tamanhos pequenos. É melhor utilizada com aplicativos que têm uma grande quantidade de texto pequeno. A suavização de borda avançada não é recomendada para fontes superiores a 48 pontos. |
O valor padrão é flash.text.AntiAliasType.NORMAL.
Implementação
public function get antiAliasType():String public function set antiAliasType(value:String):voidElementos da API relacionados
autoSize | propriedade |
autoSize:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Controla o dimensionamento e o alinhamento automáticos de campos de texto. Valores aceitáveis para as constantes TextFieldAutoSize: TextFieldAutoSize.NONE (padrão), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT e TextFieldAutoSize.CENTER.
Se autoSize for definido como TextFieldAutoSize.NONE (padrão), nenhum redimensionamento ocorrerá.
Se autoSize for definido como TextFieldAutoSize.LEFT, o texto será tratado como texto justificado à esquerda; ou seja, a margem esquerda do campo de texto permanecerá fixa e o redimensionamento de uma linha única do campo de texto ocorrerá na margem direita. Se o texto incluir uma quebra de linha (por exemplo, "\n" ou "\r"), a parte inferior também será redimensionada para caber na próxima linha de texto. Se wordWrap também estiver definido como true, apenas a parte inferior do campo de texto será redimensionada e o lado direito permanecerá fixo.
Se autoSize for definido como TextFieldAutoSize.RIGHT, o texto será tratado como texto justificado à direita; ou seja, a margem direita do campo de texto permanecerá fixa e o redimensionamento de uma linha única do campo de texto ocorrerá na margem esquerda. Se o texto incluir uma quebra de linha (por exemplo, "\n" ou "\r"), a parte inferior também será redimensionada para caber na próxima linha de texto. Se wordWrap também estiver definido como true, apenas a parte inferior do campo de texto será redimensionada e o lado esquerdo permanecerá fixo.
Se autoSize for definido como TextFieldAutoSize.CENTER, o texto será tratado como texto justificado no centro; ou seja, qualquer redimensionamento de uma linha única do campo de texto será igualmente distribuído nas margens direita e esquerda. Se o texto incluir uma quebra de linha (por exemplo, "\n" ou "\r"), a parte inferior também será redimensionada para caber na próxima linha de texto. Se wordWrap também estiver definido como true, apenas a parte inferior do campo de texto será redimensionada e os lados esquerdo e direito permanecerão fixos.
Implementação
public function get autoSize():String public function set autoSize(value:String):voidLança
ArgumentError — O autoSize especificado não é um membro de flash.text.TextFieldAutoSize.
|
Elementos da API relacionados
background | propriedade |
background:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica se o campo de texto tem um preenchimento de plano de fundo. Se true, o campo de texto terá um preenchimento de plano de fundo. Se false, o campo de texto não terá um preenchimento de plano de fundo. Utilize a propriedade backgroundColor para definir a cor do plano de fundo de um campo de texto.
O valor padrão é false.
Implementação
public function get background():Boolean public function set background(value:Boolean):voidElementos da API relacionados
backgroundAlpha | propriedade |
backgroundAlpha:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica o valor alfa do plano de fundo do campo de texto. A alfa do plano de fundo pode ser definida para qualquer valor entre 0 (invisível) e 1 (sólido). Essa propriedade poderá ser recuperada ou definida, mesmo se, no momento, não houver um plano de fundo. Mas, o efeito alfa ficará visível apenas se o campo de texto tiver a propriedade background definida como true.
O valor padrão é 1.0.
Implementação
public function get backgroundAlpha():Number public function set backgroundAlpha(value:Number):voidElementos da API relacionados
backgroundColor | propriedade |
backgroundColor:uint| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica a cor do plano de fundo do campo de texto. Essa propriedade poderá ser recuperada ou definida, mesmo se, no momento, não houver um plano de fundo. Mas, a cor ficará visível apenas se o campo de texto tiver a propriedade background definida como true.
O valor padrão é 0xFFFFFF (white).
Implementação
public function get backgroundColor():uint public function set backgroundColor(value:uint):voidElementos da API relacionados
blockProgression | propriedade |
blockProgression:Object| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica uma progressão vertical ou horizontal da colocação de linha. As linhas são colocadas de cima para baixo (BlockProgression.TB, usado para textos na horizontal) ou da direita para a esquerda (BlockProgression.RL, usado para textos na vertical).
Os valores permitidos são flashx.textLayout.formats.BlockProgression.RL, flashx.textLayout.formats.BlockProgression.TB, flashx.textLayout.formats.FormatValue.INHERIT.
Se não for definido durante o cascateamento, esta propriedade herdará seu valor de um ancestral. Se nenhum ancestral tiver estabelecido esta propriedade, ele terá um valor de TB.
O valor padrão é undefined (indicates not set).
Implementação
public function get blockProgression():Object public function set blockProgression(value:Object):voidElementos da API relacionados
border | propriedade |
border:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica se o campo de texto tem uma borda. Se true, o campo de texto terá uma borda. Se false, o campo de texto não terá uma borda. Utilize a propriedade borderColor para definir a cor da borda.
O valor padrão é false.
Implementação
public function get border():Boolean public function set border(value:Boolean):voidElementos da API relacionados
borderAlpha | propriedade |
borderAlpha:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica o valor alfa da borda. A alfa da borda pode ser definida para qualquer valor entre 0 (invisível) e 1 (sólido). Essa propriedade poderá ser recuperada ou definida, mesmo se, no momento, não houver uma borda. Mas, o efeito alfa ficará visível apenas se o campo de texto tiver a propriedade border definida como true.
O valor padrão é 1.0.
Implementação
public function get borderAlpha():Number public function set borderAlpha(value:Number):voidElementos da API relacionados
borderColor | propriedade |
borderColor:uint| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica a cor da borda do campo de texto. O valor padrão é 0x000000 (preto). Essa propriedade poderá ser recuperada ou definida, mesmo se, no momento, não houver uma borda. Mas, a cor ficará visível apenas se o campo de texto tiver a propriedade border definida como true.
Implementação
public function get borderColor():uint public function set borderColor(value:uint):voidElementos da API relacionados
borderWidth | propriedade |
borderWidth:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica a largura da borda. A largura da borda pode ser definida como qualquer valor entre 1 e 100. Essa propriedade poderá ser recuperada ou definida, mesmo se, no momento, não houver uma borda. Mas, a largura ficará visível apenas se o campo de texto tiver a propriedade border definida como true.
A largura da borda é considerada quando a largura ou a altura do campo de texto é calculada. Para obter a largura ou a altura do contêiner de texto sem a borda, subtraia 2 vezes borderWidth do valor da altura ou da largura.
Por exemplo, txtHeight = tlf.height - (2 tlf.borderwidth);.
O valor padrão é 1.
Implementação
public function get borderWidth():Number public function set borderWidth(value:Number):voidElementos da API relacionados
bottomScrollV | propriedade |
bottomScrollV:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Um inteiro (índice com base 1) que indica a linha na extremidade inferior que está atualmente visível no campo de texto especificado. Considere o campo de texto como uma janela em um bloco de texto. A propriedade scrollV é o índice baseado no 1 da linha visível mais alta nesta janela, e bottomScroll é a última linha visível nesta janela.
Todo o texto entre as linhas indicadas por scrollV e bottomScrollV está visível no momento no campo de texto.
Implementação
public function get bottomScrollV():intElementos da API relacionados
caretIndex | propriedade |
caretIndex:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O índice da posição do ponto de inserção (circunflexo). Se nenhum ponto de inserção for exibido, o valor será a posição em que ponto de inserção estaria se você restaurasse o foco para o campo (normalmente, onde o ponto de inserção estava ou 0 se o campo não teve foco).
Os índices de extensão da seleção têm base em zero (por exemplo, a primeira posição é 0, a segunda posição é 1 e assim por diante).
Exemplo:
package
{
import flash.display.Sprite;
import flash.events.MouseEvent;
import fl.text.TLFTextField;
import flash.text.TextFieldType;
public class TLFTextField_caretIndex extends Sprite
{
public function TLFTextField_caretIndex()
{
var tlf:TLFTextField = createTLFTextField(10, 10, 100, 100);
tlf.wordWrap = true;
tlf.type = TextFieldType.INPUT;
tlf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text.";
tlf.addEventListener(MouseEvent.CLICK, printCursorPosition);
}
private function printCursorPosition(event:MouseEvent):void
{
var tlf:TLFTextField = TLFTextField(event.currentTarget);
trace("caretIndex:", tlf.caretIndex);
trace("selectionBeginIndex:", tlf.selectionBeginIndex);
trace("selectionEndIndex:", tlf.selectionEndIndex);
}
private function createTLFTextField(x:Number, y:Number, width:Number, height:Number):TLFTextField
{
var result:TLFTextField = new TLFTextField();
result.x = x;
result.y = y;
result.width = width;
result.height = height;
addChild(result);
return result;
}
}
}
Implementação
public function get caretIndex():intElementos da API relacionados
columnCount | propriedade |
columnCount:Object| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O número de colunas de texto (adota o valor padrão se indefinido durante a cascata). O número da coluna anula as outras configurações de coluna. O valor é um Inteiro, ou FormatValue.AUTO se não for especificado. Se columnCount não for especificado, columnWidth será usado para criar tantas colunas quantas couberem no contêiner.
Os valores permitidos como string são flashx.textLayout.formats.FormatValue.AUTO, flashx.textLayout.formats.FormatValue.INHERIT e de ints de 1 a 50.
Se indefinido durante a cascata esta propriedade terá um valor de AUTO.
O valor padrão é undefined (indicates not set).
Implementação
public function get columnCount():Object public function set columnCount(value:Object):voidElementos da API relacionados
columnGap | propriedade |
columnGap:Object| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica a quantidade do espaço de dobra, em pixels, para deixar entre as colunas (adota o valor padrão se indefinido durante a cascata).
Os valores permitidos são números de 0 a 1000 e flashx.textLayout.formats.FormatValue.INHERIT.
Se não for definido durante o cascateamento, esta propriedade terá seu valor de 20.
O valor padrão é undefined (indicates not set).
Implementação
public function get columnGap():Object public function set columnGap(value:Object):voidElementos da API relacionados
columnWidth | propriedade |
columnWidth:Object| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A largura da coluna em pixels (adota o valor padrão se indefinido durante a cascata). Se você especificar a largura das colunas, mas não o número, TextLayout criará o maior número possível dessas colunas, de acordo com a largura do contêiner e as configurações de columnGap. Qualquer espaço restante será deixado após a última coluna. O valor é um Número.
Os valores permitidos como strings são flashx.textLayout.formats.FormatValue.AUTO, flashx.textLayout.formats.FormatValue.INHERIT e números de 0 a 8000.
Se indefinido durante a cascata esta propriedade terá um valor de AUTO.
O valor padrão é undefined (indicates not set).
Implementação
public function get columnWidth():Object public function set columnWidth(value:Object):voidElementos da API relacionados
condenseWhite | propriedade |
condenseWhite:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Um valor booliano que especifica se o espaço em branco extra (espaços, quebras de linha, etc.) em um campo de texto com texto HTML ou marcas TLF deve ser removido. O valor padrão é false. A propriedade condenseWhite afeta apenas a marca TLF ou o texto definido com a propriedade htmlText, não a propriedade text. Se você definir o texto com a propriedade text, condenseWhite será ignorado.
Se condenseWhite for definido como true, use as marcas HTML padrão, como <BR> e <P>, para colocar quebras de linha no campo de texto.
A propriedade condenseWhite afeta apenas o texto definido com a propriedade htmlText ou a propriedade tlfMarkup.
O exemplo a seguir mostra como usar a propriedade condenseWhite para remover espaços extras do conteúdo tlfMarkup:
import fl.text.TLFTextField; var my_tlf:TLFTextField = new TLFTextField(); my_tlf.autoSize = 'left'; // This line removes white space from tlfMarkup my_tlf.condenseWhite = true; addChild(my_tlf); var my_markup:String = '<TextFlow xmlns="http://ns.adobe.com/textLayout/2008">' + ' <p>' + ' <span>Here is the first span.</span>' + ' \n' + ' <span>And here is the second span.</span>' + ' </p>' + '</TextFlow>'; my_tlf.tlfMarkup = my_markup;
O valor padrão é false.
Implementação
public function get condenseWhite():Boolean public function set condenseWhite(value:Boolean):voidElementos da API relacionados
defaultTextFormat | propriedade |
defaultTextFormat:flash.text:TextFormat| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica o formato aplicado ao texto recém-inserido, por exemplo, o texto inserido com o método replaceSelectedText() ou o texto digitado pelo usuário.
Implementação
public function get defaultTextFormat():flash.text:TextFormat public function set defaultTextFormat(value:flash.text:TextFormat):voidElementos da API relacionados
direction | propriedade |
direction:String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica o nível de incorporação bidirecional padrão do texto no bloco de texto. Ordem de leitura da esquerda para a direita, como nos tipos de letra do estilo latino, ou ordem de leitura da direita para a esquerda, como em Árabe ou Hebraico. Esta propriedade também afeta a direção da coluna quando ela é aplicada em nível de contêiner. As colunas podem ser ou da esquerda para a direita ou da direita para a esquerda, como o texto. Veja a seguir alguns exemplos:
Os valores permitidos são flashx.textLayout.formats.Direction.LTR, flashx.textLayout.formats.Direction.RTL, flashx.textLayout.formats.FormatValue.INHERIT.
Se não for definido durante o cascateamento, esta propriedade herdará seu valor de um ancestral. Se nenhum ancestral tiver definido esta propriedade, ela terá um valor de LTR.
O valor padrão é undefined (indicates not set).
Implementação
public function get direction():String public function set direction(value:String):voidElementos da API relacionados
displayAsPassword | propriedade |
displayAsPassword:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica se o campo de texto é um campo de texto de senha. Se o valor dessa propriedade for true, o campo de texto será tratado como um campo de texto de senha e ocultará os caracteres digitados utilizando asteriscos, em vez dos próprios caracteres. Se false, o campo de texto não será tratado como um campo de texto de senha. Quando o modo de senha for ativado, os comandos Recortar e Copiar e seus atalhos de teclado correspondentes não funcionarão. Esse mecanismo de segurança impede que um usuário inescrupuloso utilize os atalhos para descobrir uma senha em um computador desprotegido.
O valor padrão é false.
Implementação
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):voidembedFonts | propriedade |
embedFonts:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica se a renderização será feita com o uso de contornos de fontes incorporadas. Se false, o Flash Player renderizará o campo de texto utilizando fontes de dispositivo.
Se você definir a propriedade embedFonts como true para um campo de texto, será necessário especificar uma fonte para o texto utilizando a propriedade font de um objeto TextFormat aplicado ao campo de texto. Se a fonte especificada não for incorporada no arquivo SWF, o texto será exibido em uma fonte fallback.
O valor padrão é false.
Implementação
public function get embedFonts():Boolean public function set embedFonts(value:Boolean):voidElementos da API relacionados
firstBaselineOffset | propriedade |
firstBaselineOffset:Object| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica a posição de linha de base da primeira linha no container. A linha de base à qual esta propriedade se refere depende do local em nível de contêiner. No caso de textos em japonês e chinês, é TextBaseline.IDEOGRAPHIC_BOTTOM; para todos os outros, é TextBaseline.ROMAN. O deslocamento da inserção superior (ou inserção direita, se blockProgression for RL) do contêiner até a linha de base da primeira linha pode ser BaselineOffset.ASCENT, que significa igual à subida da linha,BaselineOffset.LINE_HEIGHT, que significa igual à altura dessa primeira linha, ou qualquer número fixo para especificar uma distância absoluta. BaselineOffset.AUTO alinha a subida da linha com a inserção superior do contêiner.
Os valores permitidos como strings são flashx.textLayout.formats.BaselineOffset.AUTO, flashx.textLayout.formats.BaselineOffset.ASCENT, flashx.textLayout.formats.BaselineOffset.LINE_HEIGHT, flashx.textLayout.formats.FormatValue.INHERIT e números de 0 A 1000.
Se não for definido durante o cascateamento, esta propriedade herdará seu valor de um ancestral. Se nenhum ancestral tiver definido esta propriedade, ela terá um valor do AUTO.
O valor padrão é undefined (indicates not set).
Implementação
public function get firstBaselineOffset():Object public function set firstBaselineOffset(value:Object):voidElementos da API relacionados
gridFitType | propriedade |
gridFitType:String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O tipo de ajuste à grade utilizado para esse campo de texto. Essa propriedade será aplicada apenas se a propriedade flash.text.AntiAliasType do campo de texto for definida como flash.text.AntiAliasType.ADVANCED.
O tipo de ajuste à grade utilizado determina se o Flash Player força as linhas fortes horizontais e verticais para que caibam em uma grade de pixels ou subpixels, ou não.
Para a propriedade flash.text.GridFitType, você pode utilizar os seguintes valores de string:
| Valor de string | Descrição |
|---|---|
flash.text.GridFitType.NONE | Não especifica um ajuste à grade. As linhas horizontais e verticais nos glifos não são forçadas para a grade de pixels. A definição é recomendada para animação ou tamanhos de fonte grandes. |
flash.text.GridFitType.PIXEL | Especifica que linhas fortes horizontais e verticais são ajustadas à grade de pixels. Essa definição funciona apenas para campos de texto alinhados à esquerda. Para usá-la, a propriedade flash.dispaly.AntiAliasType do campo de texto deve ser definida como flash.text.AntiAliasType.ADVANCED. Em geral, essa definição fornece a melhor legibilidade para o texto alinhado à esquerda. |
flash.text.GridFitType.SUBPIXEL | Especifica que linhas fortes horizontais e verticais são ajustadas à grade de subpixels em um monitor LCD. Para utilizar essa definição, a propriedade flash.text.AntiAliasType do campo de texto deve ser definida como flash.text.AntiAliasType.ADVANCED. A definição flash.text.GridFitType.SUBPIXEL é geralmente apropriada para texto dinâmico alinhado à direita ou centralizado e, às vezes, é uma compensação útil para animação versus qualidade de texto. |
O valor padrão é flash.text.GridFitType.PIXEL.
Implementação
public function get gridFitType():String public function set gridFitType(value:String):voidElementos da API relacionados
htmlText | propriedade |
htmlText:String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Contém a representação HTML do conteúdo do campo de texto.
Os exemplos de TLFTextField suportam as seguintes marcas de HTML:
| Marca | Descrição |
|---|---|
| Marca de âncora |
A marca <a> cria um link de hipertexto e oferece suporte aos seguintes atributos:
|
| Marca de negrito |
A marca <b> renderiza o texto como negrito. Uma face de tipo negrito deve estar disponível para a fonte utilizada.
|
| Marca de quebra |
A marca <br> cria uma quebra de linha no de texto.
|
| Marca de fonte |
A marca <font> especifica uma fonte ou uma lista de fontes para exibir o texto. A marca de fonte oferece suporte aos seguintes atributos:
|
| Marca de imagem |
A marca <img> permite que você incorpore arquivos de imagem externa (JPEG, GIF, PNG), arquivos SWF e clipes de vídeo dentro do texto.
A marca
Nota: diferentemente da classe TextField, os seguintes atributos não são suportados: |
| Marca de itálico |
A marca <i> exibe o texto selecionado em itálico. Uma face de tipo itálico deve estar disponível para a fonte utilizada.
|
| Marca de item da lista | Nota: diferentemente da classe TextField, a marca do Item de lista não é suportada. |
| Marca de parágrafo |
A marca <p> cria um novo parágrafo. A marca <p> oferece suporte aos seguintes atributos:
|
| Marca span |
A marca <span> oferece suporte aos seguintes atributos:
|
| Marca de formato de texto |
A marca A marca
|
| Marca de sublinhado |
A marca <u> sublinha o texto selecionado.
|
O Flash também oferece suporte para códigos de caractere explícitos, como & (E comercial ASCII) e € (Símbolo Unicode €).
Implementação
public function get htmlText():String public function set htmlText(value:String):voidElementos da API relacionados
length | propriedade |
maxChars | propriedade |
maxChars:int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O número máximo de caracteres que o campo de texto pode conter, conforme digitado por um usuário. Um script pode inserir mais texto do que é permitido por maxChars; a propriedade maxChars indica apenas quanto texto um usuário pode digitar. Se o valor dessa propriedade for 0, um usuário poderá digitar uma quantidade ilimitada de texto.
O valor padrão é 0.
Implementação
public function get maxChars():int public function set maxChars(value:int):voidmaxScrollH | propriedade |
maxScrollV | propriedade |
mouseWheelEnabled | propriedade |
mouseWheelEnabled:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Um valor booliano que indica se o Flash Player deverá rolar automaticamente os campos de texto de várias linhas quando o usuário clicar em um campo de texto e usar o botão de rolagem do mouse. Essa propriedade será útil se você quiser impedir a rolagem de campos de texto pela roda do mouse ou implementar sua própria rolagem de campo de texto.
O valor padrão é true.
Implementação
public function get mouseWheelEnabled():Boolean public function set mouseWheelEnabled(value:Boolean):voidmultiline | propriedade |
multiline:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Indica se o campo de texto é um campo de texto de várias linhas. Se o valor for true, o campo de texto será de várias linhas; se o valor for false, o campo de texto será de uma única linha. Em um campo de tipo TextFieldType.INPUT, o valor de multiline determina se a tecla Enter criará uma nova linha (com o valor false a tecla Enter será ignorada). Se você colar texto em um TextField com multiline de valor false, as novas linhas serão removidas do texto.
O valor padrão é false.
Implementação
public function get multiline():Boolean public function set multiline(value:Boolean):voidElementos da API relacionados
numLines | propriedade |
numLines:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Define o número de linhas de texto em um campo de texto de várias linhas. Se a propriedade wordWrap for definida como true, o número de linhas aumentará quando houver quebra automática.
Implementação
public function get numLines():intElementos da API relacionados
paddingBottom | propriedade |
paddingBottom:Object| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Margem interna inferior em pixels (adota o valor padrão se indefinido durante a cascata). O espaço entre a borda inferior do container e o texto. O valor é um Número.
Para textos horizontais, em contêineres roláveis com mais de uma coluna, a primeira coluna e as colunas seguintes apresentarão a margem como um espaço em branco na parte inferior do container. Mas na última coluna, se o texto não couber inteiro, poderá ser necessário realizar a rolagem para poder ver a margem.
Os valores permitidos são números de 0 a 1000 e flashx.textLayout.formats.FormatValue.INHERIT.
Se não for definido durante o cascateamento, esta propriedade terá seu valor de 0.
O valor padrão é undefined (indicates not set).
Implementação
public function get paddingBottom():Object public function set paddingBottom(value:Object):voidElementos da API relacionados
paddingLeft | propriedade |
paddingLeft:Object| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Margem interna esquerda em pixels (adota o valor padrão se indefinido durante a cascata). O espaço entre a borda esquerda do contêiner e o texto. O valor é um Número.
Para textos verticais, em contêineres roláveis com mais de uma coluna, a primeira coluna e as colunas seguintes apresentarão a margem como um espaço em branco no fim do contêiner, mas na última coluna, se o texto não couber inteiro, poderá ser necessário realizar a rolagem para poder ver a margem.
Os valores permitidos são números de 0 a 1000 e flashx.textLayout.formats.FormatValue.INHERIT.
Se não for definido durante o cascateamento, esta propriedade terá seu valor de 0.
O valor padrão é undefined (indicates not set).
Implementação
public function get paddingLeft():Object public function set paddingLeft(value:Object):voidElementos da API relacionados
paddingRight | propriedade |
paddingRight:Object| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Margem interna direita em pixels (adota o valor padrão se indefinido durante a cascata). O espaço entre a borda direita do container e o texto. O valor é um Número.
Os valores permitidos são números de 0 a 1000 e flashx.textLayout.formats.FormatValue.INHERIT.
Se não for definido durante o cascateamento, esta propriedade terá seu valor de 0.
O valor padrão é undefined (indicates not set).
Implementação
public function get paddingRight():Object public function set paddingRight(value:Object):voidElementos da API relacionados
paddingTop | propriedade |
paddingTop:Object| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Margem interna superior em pixels (adota o valor padrão se indefinido durante a cascata). O espaço entre a borda superior do contêiner e o texto. O valor é um Número.
Os valores permitidos são números de 0 a 1000 e flashx.textLayout.formats.FormatValue.INHERIT.
Se não for definido durante o cascateamento, esta propriedade terá seu valor de 0.
O valor padrão é undefined (indicates not set).
Implementação
public function get paddingTop():Object public function set paddingTop(value:Object):voidElementos da API relacionados
passwordCharacter | propriedade |
passwordCharacter:String [somente leitura] Obtém ou define o caractere usado para ocultar caracteres em um bloco de senha.
Implementação
tlf_internal function get passwordCharacter():StringpixelMaxScrollV | propriedade |
pixelMaxScrollV:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O valor máximo de pixelScrollV. As unidades de pixelMaxScrollV são pixels, diferentemente da propriedade maxScrollV, que é baseada em linha.
Implementação
public function get pixelMaxScrollV():intpixelScrollV | propriedade |
pixelScrollV:int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A posição vertical de texto em um campo de texto, em pixeis, diferentemente de scrollV, que é baseado em linhas. A propriedade pixelScrollV é útil para rolar suavemente em um campo de texto até uma posição determinada.
Implementação
public function get pixelScrollV():int public function set pixelScrollV(value:int):voidElementos da API relacionados
restrict | propriedade |
restrict:String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Indica o conjunto de caracteres que um usuário pode digitar no campo de texto. Se o valor da propriedade restrict for null, você poderá digitar qualquer caractere. Se o valor da propriedade restrict for uma string vazia, você não poderá digitar um caractere. Se o valor da propriedade restrict for uma string de caracteres, você poderá digitar apenas os caracteres da string no campo de texto. A string é pesquisada da esquerda para a direita. É possível especificar um intervalo usando o caractere hífen (-). Somente a interação do usuário está restrita; um script pode colocar qualquer texto no campo de texto. Essa propriedade não é sincronizada com as opções de Incorporar fonte no Inspetor de propriedades.
Se a string começar com um circunflexo (^), todos os caracteres serão inicialmente aceitos e os caracteres seguintes na string serão excluídos do conjunto de caracteres aceitos. Se a string não começar com um circunflexo (^), nenhum caractere será inicialmente aceito e os caracteres seguintes na string serão incluídos no conjunto de caracteres aceitos.
O seguinte exemplo só permite que caracteres em maiúsculas, espaços e números sejam digitados em um campo de texto:
my_txt.restrict = "A-Z 0-9";
O seguinte exemplo inclui todos os caracteres, mas exclui letras minúsculas:
my_txt.restrict = "^a-z";
Você pode utilizar uma barra invertida para inserir um ^ ou - textual. As sequências de barra invertida aceitas são \-, \^ ou \\. A barra invertida deve ser um caractere real na string, portanto, quando especificada no ActionScript, uma barra invertida dupla deve ser utilizada. Por exemplo, o seguinte código inclui apenas o traço (-) e o circunflexo (^):
my_txt.restrict = "\\-\\^";
O ^ pode ser usado em qualquer lugar da string para alternar entre a inclusão e a exclusão de caracteres. O seguinte código inclui apenas letras maiúsculas, mas exclui a letra maiúscula Q:
my_txt.restrict = "A-Z^Q";
Você pode utilizar a sequência de escape \u para construir strings restrict. O seguinte código inclui apenas os caracteres de ASCII 32 (espaço) a ASCII 126 (til).
my_txt.restrict = "\u0020-\u007E";
O valor padrão é null.
Implementação
public function get restrict():String public function set restrict(value:String):voidscrollH | propriedade |
scrollH:int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A posição de rolagem horizontal atual. Se a propriedade scrollH for 0, o texto não será rolado na horizontal. O valor dessa propriedade é um número inteiro que representa a posição horizontal em pixels.
As unidades de rolagem horizontal são pixels, enquanto que as unidades de rolagem vertical são linhas. A rolagem horizontal é medida em pixels porque a maioria das fontes que você normalmente usa tem espaçamento proporcional; ou seja, os caracteres podem ter diferentes larguras. O Flash Player executa a rolagem vertical por linha porque os usuários normalmente querem ver uma linha completa de texto em vez de uma linha parcial. Mesmo se uma linha utilizar várias fontes, sua altura será ajustada para acomodar a fonte maior em uso.
Observação: a propriedade scrollH será baseada em zero, não em 1 como a propriedade de rolagem vertical scrollV.
Implementação
public function get scrollH():int public function set scrollH(value:int):voidElementos da API relacionados
scrollV | propriedade |
scrollV:int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A posição vertical do texto em um campo de texto. A propriedade scrollV é útil para direcionar os usuários para um parágrafo específico, em uma longa passagem, ou para criar campos de texto de rolagem.
As unidades de rolagem vertical são linhas, enquanto que as unidades de rolagem horizontal são pixels. Se a primeira linha exibida for a primeira linha no campo de texto, scrollV será definido como 1 (não 0). A rolagem horizontal é medida em pixels porque a maioria das fontes tem espaçamento proporcional; ou seja, os caracteres podem ter diferentes larguras. O Flash executa a rolagem vertical por linha porque os usuários normalmente querem ver uma linha completa de texto em vez de uma linha parcial. Mesmo se existirem várias fontes em uma linha, sua altura será ajustada para acomodar a fonte maior em uso.
Implementação
public function get scrollV():int public function set scrollV(value:int):voidElementos da API relacionados
selectable | propriedade |
selectable:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Um valor booliano que indica se o campo de texto é selecionável. O valor true indica se o texto é selecionável. A propriedade selectable controla se um campo de texto for selecionável e não se ele for editável. Diferentemente de um clássico dinâmico ou campo de texto de entrada, se um campo de texto TLF for editável, ele é sempre selecionável. Se esta propriedade for definida para falsa e o tipo de entrada for definido para dinâmico, então o usuário não poderá selecionar o seu texto.
Se selectable for definido como false, o texto no campo de texto não responderá aos comandos de seleção do mouse nem do teclado, e o texto não poderá ser copiado com o comando Copiar. Se selectable for definido como true, o texto no campo de texto poderá ser selecionado com o mouse ou o teclado e também poderá ser copiado com o comando Copiar.
O valor padrão é true.
Implementação
public function get selectable():Boolean public function set selectable(value:Boolean):voidElementos da API relacionados
selectionBeginIndex | propriedade |
selectionBeginIndex:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O valor de índice de caractere com base em zero do primeiro caractere na seleção atual. Por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante. Se nenhum texto for selecionado, essa propriedade será o valor de caretIndex.
Implementação
public function get selectionBeginIndex():intElementos da API relacionados
selectionEndIndex | propriedade |
selectionEndIndex:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O valor de índice de caractere com base em zero do último caractere na seleção atual. Por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante. Se nenhum texto for selecionado, essa propriedade será o valor de caretIndex.
Implementação
public function get selectionEndIndex():intElementos da API relacionados
sharpness | propriedade |
sharpness:Number| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A nitidez não é aplicável a TextFields TLF. Qualquer valor fornecido será ignorado e zero sempre será retornado.
Implementação
public function get sharpness():Number public function set sharpness(value:Number):voidstyleSheet | propriedade |
styleSheet:StyleSheet| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Folhas de estilo para o TLF TextField.
Implementação
public function get styleSheet():StyleSheet public function set styleSheet(value:StyleSheet):voidtext | propriedade |
text:String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Uma string que é o texto atual no campo de texto. As linhas são separadas pelo caractere de retorno de carro ('\r', ASCII 13). Essa propriedade contém texto não formatado no campo de texto, sem marcas HTML.
Para obter o texto em formato HTML, utilize a propriedade htmlText.
Implementação
public function get text():String public function set text(value:String):voidElementos da API relacionados
textColor | propriedade |
textColor:uint| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A cor do texto em um campo de texto, em formato hexadecimal. O sistema de cores hexadecimais usa seis dígitos para representar os valores de cor. Cada dígito tem 16 valores ou caracteres possíveis. Os caracteres variam de 0 a 9 e de A a F. Por exemplo, o preto é 0x000000; o branco é 0xFFFFFF.
O valor padrão é 0 (0x000000).
Implementação
public function get textColor():uint public function set textColor(value:uint):voidtextFlow | propriedade |
textFlow:flashx.textLayout.elements:TextFlow| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Use esta propriedade para atribuir a formatação das classes TLF nos pacotes flashx para a instância TLFTextField. Por exemplo:
var myFormat:TextLayoutFormat = new TextLayoutFormat(); myFormat.textIndent = 8; myFormat.color = 0x336633; myFormat.fontFamily = "Arial, Helvetica, _sans"; myFormat.fontSize = 24; var myTextFlow:TextFlow = myTLFTextField.textFlow; myTextFlow.hostFormat = myFormat;
Implementação
public function get textFlow():flashx.textLayout.elements:TextFlow public function set textFlow(value:flashx.textLayout.elements:TextFlow):voidElementos da API relacionados
textHeight | propriedade |
textHeight:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A altura do texto, em pixels. O preenchimento superior e inferior não está incluído neste valor.
Implementação
public function get textHeight():NumberElementos da API relacionados
textWidth | propriedade |
textWidth:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A largura do texto, em pixels. O preenchimento direito e esquerdo não está incluído neste valor.
Implementação
public function get textWidth():NumberElementos da API relacionados
thickness | propriedade |
thickness:Number| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
A propriedade de espessura não é aplicável ao TextField TLF. Qualquer valor fornecido será ignorado e zero sempre será retornado.
Implementação
public function get thickness():Number public function set thickness(value:Number):voidtlfMarkup | propriedade |
tlfMarkup:String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Define ou adquire a marcação TLF do texto no campo de texto TLF.
A especificação de marcação é postada em http://sourceforge.net/projects/tlf.adobe/files/docs/TLF_2.0_specification.pdf/download.
Implementação
public function get tlfMarkup():String public function set tlfMarkup(value:String):voidElementos da API relacionados
type | propriedade |
type:String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O tipo do campo de texto. Uma das seguintes constantes de TextFieldType: TextFieldType.DYNAMIC, que especifica um campo de texto TLF selecionável, que um usuário não pode editar, ou TextFieldType.INPUT, que especifica um campo de texto TLF editável, que um usuário pode editar.
O valor padrão é dynamic.
Implementação
public function get type():String public function set type(value:String):voidLança
ArgumentError — O type especificado não é um membro de flash.text.TextFieldType.
|
Elementos da API relacionados
useRichTextClipboard | propriedade |
useRichTextClipboard:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Especifica se é preciso copiar a formatação de texto junto com o texto para a área de transferência. Quando estabelecido como true, copia a formatação (tal como alinhamento, negrito e itálico) no formato tlfMarkup para a área de transferência.
O valor padrão é false.
Implementação
public function get useRichTextClipboard():Boolean public function set useRichTextClipboard(value:Boolean):voidElementos da API relacionados
verticalAlign | propriedade |
verticalAlign:String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Alinhamento vertical ou justificação (adota o valor padrão se indefinido durante a cascata). Determina como os elementos do TextFlow se alinharão dentro do contêiner.
Os valores permitidos são flashx.textLayout.formats.VerticalAlign.TOP, flashx.textLayout.formats.VerticalAlign.MIDDLE, flashx.textLayout.formats.VerticalAlign.BOTTOM, flashx.textLayout.formats.VerticalAlign.JUSTIFY, flashx.textLayout.formats.FormatValue.INHERIT.
Se indefinido durante a cascata, esta propriedade terá um valor de TOP.
O valor padrão é undefined (indicates not set).
Implementação
public function get verticalAlign():String public function set verticalAlign(value:String):voidElementos da API relacionados
wordWrap | propriedade |
wordWrap:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Um valor booliano que indica se o campo de texto tem quebra automática. Se o valor de wordWrap for true, o campo de texto terá uma quebra automática; se o valor for false, o campo de texto não terá uma quebra automática.
O valor padrão é false.
Implementação
public function get wordWrap():Boolean public function set wordWrap(value:Boolean):voidElementos da API relacionados
TLFTextField | () | Construtor |
public function TLFTextField()| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Construtor de objetos TLFTextField. Crie um objeto TLFTextField do mesmo modo que você cria um campo de texto com a classe TextField mas use o construtor de TLFTextField(). Por exemplo:
var myTLFTextField:TLFTextField = new TLFTextField();
Elementos da API relacionados
appendText | () | método |
public function appendText(newText:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Acrescenta a string especificada pelo parâmetro newText ao final do texto do campo de texto. Este método é mais eficiente do que uma atribuição de adição (+=) em uma propriedade text (como someTextField.text += moreText), particularmente para um campo de texto que contém uma quantidade significativa de conteúdo.
Parâmetros
newText:String — A string a ser acrescentada ao texto existente.
|
createTextLayoutFormat | () | método |
tlf_internal static function createTextLayoutFormat(format:flash.text:TextFormat):flashx.textLayout.formats:TextLayoutFormatParâmetros
format:flash.text:TextFormat |
flashx.textLayout.formats:TextLayoutFormat |
getCharBoundaries | () | método |
public function getCharBoundaries(charIndex:int):Rectangle| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna um retângulo que é a caixa delimitadora do caractere.
Parâmetros
charIndex:int — O valor de índice com base em zero do caractere (por exemplo, a primeira posição é 0, a segunda posição é 1 e assim por diante).
|
Rectangle — Um retângulo com os valores mínimo e máximo x e y definindo a caixa delimitadora do caractere.
|
Elementos da API relacionados
getCharIndexAtPoint | () | método |
public function getCharIndexAtPoint(x:Number, y:Number):int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna o valor de índice com base em zero do caractere no ponto especificado pelos parâmetros x e y.
Parâmetros
x:Number — A coordenada x do caractere.
| |
y:Number — A coordenada y do caractere.
|
int — O valor de índice com base em zero do caractere (por exemplo, a primeira posição é 0, a segunda posição é 1 e assim por diante). Retorna -1 se o ponto não estiver sobre um caractere.
|
getFirstCharInParagraph | () | método |
public function getFirstCharInParagraph(charIndex:int):int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Tendo sido fornecido um índice de caractere, retorna o índice do primeiro caractere no mesmo parágrafo.
Parâmetros
charIndex:int — O valor de índice com base em zero do caractere (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).
|
int — O valor de índice com base em zero do primeiro caractere no mesmo parágrafo.
|
Lança
RangeError — O índice de caractere especificado está fora do intervalo.
|
getImageReference | () | método |
public function getImageReference(id:String):DisplayObject| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna uma referência DisplayObject para o id especificado, referente a um arquivo SWF ou de imagem que foi adicionado a um campo de texto formatado em HTML com o uso de uma marca <img>. A marca <img> está no seguinte formato:
<img src = 'filename.jpg' id = 'instanceName' >Parâmetros
id:String — A id para correspondência (no atributo id da marca <img>).
|
DisplayObject — O objeto de exibição relacionado ao arquivo de imagem ou SWF com o atributo id correspondente na marca <img> do campo de texto. Para a mídia carregada de uma fonte externa, esse objeto será um objeto Loader e, uma vez carregado, o objeto de mídia será o filho do objeto Loader. Para a mídia incorporada no arquivo SWF, esse será o objeto carregado. Se não houver uma marca <img> com o id correspondente, o método retornará null.
|
Elementos da API relacionados
getLineIndexAtPoint | () | método |
public function getLineIndexAtPoint(x:Number, y:Number):int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna o valor de índice com base em zero da linha no ponto especificado pelos parâmetros x e y.
Parâmetros
x:Number — A coordenada x da linha.
| |
y:Number — A coordenada y da linha.
|
int — O valor de índice com base em zero da linha (por exemplo, a primeira linha é 0, a segunda linha é 1 e assim por diante). Retorna -1 se o ponto não estiver sobre uma linha.
|
getLineIndexOfChar | () | método |
public function getLineIndexOfChar(charIndex:int):int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna o valor de índice com base em zero da linha contendo o caractere especificado pelo parâmetro charIndex.
Parâmetros
charIndex:int — O valor de índice com base em zero do caractere (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).
|
int — O valor de índice com base em zero da linha.
|
Lança
RangeError — O índice de caractere especificado está fora do intervalo.
|
getLineLength | () | método |
public function getLineLength(lineIndex:int):int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna o número de caracteres em uma linha de texto específica.
Parâmetros
lineIndex:int — O número da linha da qual você quer o tamanho.
|
int — O número de caracteres na linha.
|
Lança
RangeError — O número da linha especificado está fora do intervalo.
|
getLineMetrics | () | método |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna informações de métrica de uma determinada linha de texto.
Parâmetros
lineIndex:int — O número da linha da qual você quer informações de métrica.
|
flash.text:TextLineMetrics — Um objeto TextLineMetrics.
|
Lança
RangeError — O número da linha especificado está fora do intervalo.
|
Elementos da API relacionados
getLineOffset | () | método |
public function getLineOffset(lineIndex:int):int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna o índice de caractere do primeiro caractere na linha que o parâmetro lineIndex especifica.
Parâmetros
lineIndex:int — O valor de índice com base em zero da linha (por exemplo, a primeira linha é 0, a segunda linha é 1 e assim por diante).
|
int — O valor de índice com base em zero do primeiro caractere na linha.
|
Lança
RangeError — O número da linha especificado está fora do intervalo.
|
getLineText | () | método |
public function getLineText(lineIndex:int):String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna o texto da linha especificada pelo parâmetro lineIndex.
Parâmetros
lineIndex:int — O valor de índice com base em zero da linha (por exemplo, a primeira linha é 0, a segunda linha é 1 e assim por diante).
|
String — A string de texto contida na linha especificada.
|
Lança
RangeError — O número da linha especificado está fora do intervalo.
|
getParagraphLength | () | método |
public function getParagraphLength(charIndex:int):int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Tendo sido fornecido um índice de caractere, retorna o tamanho do parágrafo contendo o caractere específico. O tamanho é relativo ao primeiro caractere no parágrafo (conforme retornado por getFirstCharInParagraph()), não ao índice de caractere passado.
Parâmetros
charIndex:int — O valor de índice com base em zero do caractere (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).
|
int — Retorna o número de caracteres no parágrafo.
|
Lança
RangeError — O índice de caractere especificado está fora do intervalo.
|
Elementos da API relacionados
getTextFormat | () | método |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna um objeto TextFormat que contém informações de formatação do intervalo de texto especificado pelos parâmetros beginIndex e endIndex. Apenas as propriedades comuns a todo o texto especificado são definidas no objeto TextFormat resultante. Qualquer propriedade que seja mixed, o que significa que ela tem diferentes valores em diferentes pontos no texto, tem um valor null.
Se você não especificar valores para esses parâmetros, esse método será aplicado a todo o texto no campo de texto.
A seguinte tabela descreve três possíveis usos:
| Uso | Descrição |
|---|---|
my_textField.getTextFormat() | Retorna um objeto TextFormat contendo informações de formatação para todo o texto em um campo de texto. Apenas as propriedades comuns a todo o texto no campo de texto são definidas no objeto TextFormat resultante. Qualquer propriedade que seja mixed, o que significa que ela tem diferentes valores em diferentes pontos no texto, tem um valor null. |
my_textField.getTextFormat(beginIndex:Number) | Retorna um objeto TextFormat contendo uma cópia do formato de texto do caractere na posição beginIndex. |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Retorna um objeto TextFormat contendo informações de formatação para a extensão de texto de beginIndex a endIndex-1. Apenas as propriedades comuns a todo o texto no intervalo especificado são definidas no objeto TextFormat resultante. Qualquer propriedade mixed (ou seja, tem diferentes valores em diferentes pontos no intervalo) tem seu valor definido como null. |
Parâmetros
beginIndex:int (default = -1) | |
endIndex:int (default = -1)beginIndex e endIndex, o texto de beginIndex a endIndex-1 será lido.
|
flash.text:TextFormat — O objeto TextFormat que representa as propriedades de formatação do texto especificado.
|
Lança
RangeError — O beginIndex ou endIndex especificado está fora do intervalo.
|
Elementos da API relacionados
isFontCompatible | () | método |
public function isFontCompatible(fontName:String, fontStyle:String):Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Retorna true se uma fonte incorporada estiver disponível com os parâmetros fontName e fontStyle especificados, em que Font.fontType é flash.text.FontType.EMBEDDED_CFF. A partir do Flash Player 10, dois tipos de fontes incorporadas podem aparecer em um arquivo SWF. As fontes FontType.EMBEDDED só são usadas com objetos TextField, e as fontes FontType. EMBEDDED_CFF são usadas com TLFTextField e com as classes flash.text.engine. Os dois tipos são diferenciados pela propriedade fontType da classe Font, conforme retornados pela função enumerateFonts().
TextField não pode usar uma fonte de tipo EMBEDDED. Se embedFonts for definido como true e a única fonte disponível no tempo de execução com o nome e o estilo especificados for do tipo EMBEDDED, o Flash Player apresentará o texto com uma fonte fallback.
Se as fontes EMBEDDED e EMBEDDED_CFF estiverem disponíveis com o mesmo nome e o mesmo estilo, a fonte EMBEDDED_CFF será selecionada e o texto será convertido para a fonte EMBEDDED_CFF.
Parâmetros
fontName:String — O nome da fonte incorporada a ser verificada.
| |
fontStyle:String — Especifica o estilo de fonte a ser verificado. Use flash.text.FontStyle
|
Boolean — true se houver uma fonte compatível incorporada está disponível, caso contrário, será false.
|
Lança
ArgumentError — O fontStyle especificado não é membro de flash.text.FontStyle.
|
Elementos da API relacionados
replaceSelectedText | () | método |
public function replaceSelectedText(value:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Substitui a seleção atual pelo conteúdo do parâmetro value. O texto é inserido na posição da seleção atual, utilizando o formato de caractere padrão e o formato de parágrafo padrão atuais. O texto não é tratado como HTML.
Você pode utilizar o método replaceSelectedText() para inserir e excluir texto sem romper a formatação de caractere e parágrafo do restante do texto.
Parâmetros
value:String — A string que substituirá o texto atualmente selecionado.
|
Elementos da API relacionados
replaceText | () | método |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Substitui o intervalo de caracteres especificado pelos parâmetros beginIndex e endIndex pelo conteúdo do parâmetro newText. Conforme desejado, o texto de beginIndex a endIndex-1 é substituído.
Parâmetros
beginIndex:int — O valor de índice com base em zero da posição inicial do intervalo de substituição.
| |
endIndex:int — A posição do índice com base em zero do primeiro caractere após a extensão de texto desejada.
| |
newText:String — O texto a ser utilizado para substituir o intervalo especificado de caracteres.
|
setSelection | () | método |
public function setSelection(begIdx:int, endIdx:int):void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Define, conforme selecionado, o texto designado pelos valores de índice do primeiro e último caracteres, que são especificados com os parâmetros beginIndex e endIndex. Se os dois valores de parâmetro forem iguais, este método definirá o ponto de inserção, como se você tivesse definido a propriedade caretIndex.
Parâmetros
begIdx:int — O valor de índice com base em zero do primeiro caractere na seleção (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).
| |
endIdx:int — O valor de índice com base em zero do último caractere na seleção.
|
Elementos da API relacionados
setTextFormat | () | método |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Aplica a formatação de texto determinada pelo parâmetro format ao texto especificado em um campo de texto. O valor de format deve ser um objeto TextFormat que especifica as alterações desejadas na formatação do texto. Apenas as propriedades que não são nulas de format são aplicadas ao campo de texto. Qualquer propriedade de format definida como null não é aplicada. Por padrão, todas as propriedades de um objeto TextFormat recém-criado são definidas como null.
O método setTextFormat() altera a formatação de texto aplicada a um intervalo de caracteres ou a todo o corpo do texto em um campo de texto. Para aplicar as propriedades de format a todo o texto no campo de texto, não especifique valores para beginIndex e endIndex. Para aplicar as propriedades de format a um intervalo de texto, especifique valores para os parâmetros beginIndex e endIndex. Você pode utilizar a propriedade length para determinar os valores de índice.
Os dois tipos de informações de formatação em um objeto TextFormat são formatação em nível de caractere e formatação em nível de parágrafo. Cada caractere em um campo de texto pode ter suas próprias definições de formatação de caractere, como nome de fonte, tamanho de fonte, negrito e itálico.
Para parágrafos, o primeiro caractere do parágrafo é examinado quanto às definições de formatação de todo o parágrafo. Exemplos de definições de formatação de parágrafo são margem à esquerda, margem à direita e recuo.
Qualquer texto inserido manualmente pelo usuário, ou substituído pelo método replaceSelectedText(), recebe a formatação padrão do campo de texto do novo texto e não a formatação especificada para o ponto de inserção de texto. Para definir a formatação padrão do novo texto, use defaultTextFormat.
Parâmetros
format:flash.text:TextFormat — Um objeto TextFormat que contém informações de formatação de caractere e parágrafo.
| |||||||||
beginIndex:int (default = -1) | |||||||||
endIndex:int (default = -1)beginIndex e endIndex, o texto de beginIndex a endIndex-1 será atualizado.
Observe que qualquer texto inserido manualmente pelo usuário, ou substituído pelo método |
Lança
RangeError — O beginIndex ou endIndex especificado está fora do intervalo.
|
Elementos da API relacionados
change | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.CHANGE| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Despachado depois que um valor de controle é modificado, ao contrário do evento textInput, que é despachado antes de o valor ser modificado. Diferente da versão do Modelo de evento W3C DOM do evento change, que despacha o evento somente depois que o controle perde o foco, a versão ActionScript 3.0 do evento change é despachada toda vez que o controle é alterado. Por exemplo, se um usuário digitar texto em um campo de texto, um evento change será despachado depois de cada pressionamento de tecla.
Exemplo:
package {
import flash.display.Sprite;
import fl.text.TLFTextField;
import flash.text.TextFieldType;
import flash.text.TextFormat;
import flash.text.TextFormatAlign;
import flash.events.Event;
import flash.events.TextEvent;
public class TLFTextField_Event_changeExample extends Sprite {
private var inputTLFTextField:TLFTextField = new TLFTextField();
private var headingTLFTextField:TLFTextField = new TLFTextField();
private var newFormat:TextFormat = new TextFormat();
public function TLFTextField_Event_changeExample() {
newFormat.bold = true;
newFormat.size = 18;
newFormat.color = 0xFF0000;
newFormat.align = TextFormatAlign.CENTER;
headingTLFTextField.defaultTextFormat = newFormat;
headingTLFTextField.x = 10;
headingTLFTextField.y = 10;
headingTLFTextField.background = true;
headingTLFTextField.backgroundColor = 0xF5F5DC;
headingTLFTextField.selectable = false;
this.addChild(headingTLFTextField);
headingTLFTextField.height = 30;
headingTLFTextField.width = 400;
inputTLFTextField.x = 10;
inputTLFTextField.y = 70;
inputTLFTextField.background = true;
inputTLFTextField.border = true;
inputTLFTextField.maxChars = 40;
inputTLFTextField.wordWrap = true;
inputTLFTextField.type = TextFieldType.INPUT;
this.addChild(inputTLFTextField);
inputTLFTextField.height = 20;
inputTLFTextField.width = 230;
inputTLFTextField.addEventListener(Event.CHANGE, changeHandler);
}
private function changeHandler(e:Event):void {
headingTLFTextField.text = inputTLFTextField.text;
}
}
}
A constante Event.CHANGE define o valor da propriedade type de um objeto de evento change.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto que tem seus respectivos valores modificados. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
link | Evento |
flash.events.TextEventpropriedade TextEvent.type =
flash.events.TextEvent.LINK| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Despachado quando um usuário clica em um hiperlink em um campo de texto habilitado para HTML, em que o URL começa com "event:". O restante do URL depois de "event:" é colocado na propriedade de texto do evento LINK.
Observação: o comportamento padrão, adicionar texto ao campo de texto, ocorre apenas quando o Flash Player gera o evento, que, nesse caso, acontece quando um usuário tenta inserir texto. Você não pode colocar texto em um campo de texto enviando eventos textInput a ele.
type de um objeto de evento link.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O campo de texto que contém o hiperlink que foi clicado. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
text | O restante do URL depois de "event:" |
scroll | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.SCROLL| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
Despachado por um objeto TextField após a rolagem pelo usuário.
A constanteEvent.SCROLL define o valor da propriedade type de um objeto de evento scroll.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto TextField que foi rolado. A propriedade target nem sempre é o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
textInput | Evento |
flash.events.TextEventpropriedade TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flash CS5 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
O Flash Player despacha o evento textInput quando um usuário insere um ou mais caracteres de texto. Vários métodos de entrada de texto podem gerar esse evento, incluindo teclados padrão, IMEs (Editores de método de entrada), sistemas de reconhecimento de voz ou fala e até mesmo o ato de colar texto sem formatação ou informações de estilo.
type de um objeto de evento textInput.
Observação: Este evento não é despachado para as teclas Excluir ou Backspace.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | true; chama o método preventDefault() para cancelar o comportamento padrão. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O campo de texto no qual os caracteres estão sendo inseridos. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
text | O caractere ou a string de caracteres inserida pelo usuário. |
Wed Jun 13 2018, 11:10 AM Z