Pacote | mx.core |
Interface | public interface IUITextField extends IIMESupport , IFlexModule , IInvalidating , ISimpleStyleClient , IToolTipManagerClient , IUIComponent , IFlexDisplayObject , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
Implementadores | UIFTETextField, UITextField |
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Propriedade | Definido por | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
As opções de acessibilidade atuais para este objeto de exibição. | IFlexDisplayObject | ||
alpha : Number
Indica o valor de transparência alfa do objeto especificado. | IFlexDisplayObject | ||
alwaysShowSelection : Boolean
Quando definida como true e o campo de texto não está em foco, o Flash Player realça a seleção no campo de texto em cinza. | IUITextField | ||
antiAliasType : String
O tipo de suavização de borda utilizado para esse campo de texto. | IUITextField | ||
autoSize : String
Controla o dimensionamento e o alinhamento automáticos de campos de texto. | IUITextField | ||
background : Boolean
Especifica se o campo de texto tem um preenchimento de plano de fundo. | IUITextField | ||
backgroundColor : uint
A cor do plano de fundo do campo de texto. | IUITextField | ||
baselinePosition : Number [somente leitura]
The y-coordinate of the baseline
of the first line of text of the component. | IUIComponent | ||
blendMode : String
Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado. | IFlexDisplayObject | ||
border : Boolean
Especifica se o campo de texto tem uma borda. | IUITextField | ||
borderColor : uint
A cor da borda do campo de texto. | IUITextField | ||
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. | IUITextField | ||
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. | IFlexDisplayObject | ||
caretIndex : int [somente leitura]
O índice da posição do ponto de inserção (circunflexo). | IUITextField | ||
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 deve ser removido. | IUITextField | ||
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. | IUITextField | ||
displayAsPassword : Boolean
Especifica se o campo de texto é um campo de texto de senha. | IUITextField | ||
document : Object
A reference to the document object associated with this component. | IUIComponent | ||
doubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick. | IUITextField | ||
embedFonts : Boolean
Especifica se a renderização será feita com o uso de contornos de fontes incorporadas. | IUITextField | ||
enabled : Boolean
Whether the component can accept user interaction. | IUIComponent | ||
enableIME : Boolean [somente leitura]
Specifies whether the IME should be enabled when
this component has focus. | IIMESupport | ||
explicitHeight : Number
The explicitly specified height for the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMaxHeight : Number [somente leitura]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMaxWidth : Number [somente leitura]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinHeight : Number [somente leitura]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinWidth : Number [somente leitura]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitWidth : Number
The explicitly specified width for the component,
in pixels, as the component's coordinates. | IUIComponent | ||
filters : Array
Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição. | IFlexDisplayObject | ||
focusPane : Sprite
A single Sprite object that is shared among components
and used as an overlay for drawing the focus indicator. | IUIComponent | ||
focusRect : Object
Especifica se este objeto exibe um retângulo de foco. | IUITextField | ||
gridFitType : String
O tipo de ajuste à grade utilizado para esse campo de texto. | IUITextField | ||
height : Number
Indica a altura do objeto de exibição, em pixels. | IFlexDisplayObject | ||
htmlText : String
Contém a representação HTML do conteúdo do campo de texto. | IUITextField | ||
ignorePadding : Boolean
If true, the paddingLeft and
paddingRight styles will not add space
around the text of the component. | IUITextField | ||
imeMode : String
The IME mode of the component. | IIMESupport | ||
includeInLayout : Boolean
Specifies whether this component is included in the layout of the
parent container. | IUIComponent | ||
inheritingStyles : Object
The beginning of this UITextField's chain of inheriting styles. | IUITextField | ||
isPopUp : Boolean
Set to true by the PopUpManager to indicate
that component has been popped up. | IUIComponent | ||
length : int [somente leitura]
O número de caracteres em um campo de texto. | IUITextField | ||
loaderInfo : LoaderInfo [somente leitura]
Retorna um objeto LoaderInfo contendo informações sobre o carregamento do arquivo ao qual esse objeto de exibição pertence. | IFlexDisplayObject | ||
mask : DisplayObject
O objeto de exibição de chamada é mascarado pelo objeto "mask" especificado. | IFlexDisplayObject | ||
maxChars : int
O número máximo de caracteres que o campo de texto pode conter, conforme digitado por um usuário. | IUITextField | ||
maxHeight : Number [somente leitura]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
maxScrollH : int [somente leitura]
O valor máximo de scrollH. | IUITextField | ||
maxScrollV : int [somente leitura]
O valor máximo de scrollV. | IUITextField | ||
maxWidth : Number [somente leitura]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
measuredHeight : Number [somente leitura]
The measured height of this object. | IFlexDisplayObject | ||
measuredMinHeight : Number
The default minimum height of the component, in pixels. | IUIComponent | ||
measuredMinWidth : Number
The default minimum width of the component, in pixels. | IUIComponent | ||
measuredWidth : Number [somente leitura]
The measured width of this object. | IFlexDisplayObject | ||
minHeight : Number [somente leitura]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
minWidth : Number [somente leitura]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
mouseEnabled : Boolean
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. | IUITextField | ||
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. | IUITextField | ||
mouseX : Number [somente leitura]
Indica a coordenada x da posição do dispositivo do mouse ou de entrada do usuário, em pixels. | IFlexDisplayObject | ||
mouseY : Number [somente leitura]
Indica a coordenada y da posição do dispositivo do mouse ou de entrada do usuário, em pixels. | IFlexDisplayObject | ||
multiline : Boolean
Indica se o campo é um campo de texto de várias linhas. | IUITextField | ||
name : String
Indica o nome da ocorrência de DisplayObject. | IFlexDisplayObject | ||
nestLevel : int
Depth of this object in the containment hierarchy. | IUITextField | ||
nonInheritingStyles : Object
The beginning of this UITextField's chain of non-inheriting styles. | IUITextField | ||
nonZeroTextHeight : Number [somente leitura]
Unlike textHeight, this returns a non-zero value
even when the text is empty. | IUITextField | ||
numLines : int [somente leitura]
Define o número de linhas de texto em um campo de texto de várias linhas. | IUITextField | ||
opaqueBackground : Object
Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo. | IFlexDisplayObject | ||
owner : DisplayObjectContainer
The owner of this IVisualElement object. | IUIComponent | ||
parent : DisplayObjectContainer [somente leitura]
Indica o objeto DisplayObjectContainer que contém esse objeto de exibição. | IFlexDisplayObject | ||
percentHeight : Number
Number that specifies the height of a component as a
percentage of its parent's size. | IUIComponent | ||
percentWidth : Number
Number that specifies the width of a component as a
percentage of its parent's size. | IUIComponent | ||
restrict : String
Indica o conjunto de caracteres que um usuário pode digitar no campo de texto. | IUITextField | ||
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. | IFlexDisplayObject | ||
rotation : Number
Indica o giro da ocorrência de DisplayObject, em graus, a partir da sua orientação original. | IFlexDisplayObject | ||
scale9Grid : Rectangle
A grade de dimensionamento atual que está em vigor. | IFlexDisplayObject | ||
scaleX : Number
Indica a escala horizontal (porcentagem) do objeto aplicada a partir do ponto de registro. | IFlexDisplayObject | ||
scaleY : Number
Indica a escala vertical (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | IFlexDisplayObject | ||
scrollH : int
A posição de rolagem horizontal atual. | IUITextField | ||
scrollRect : Rectangle
Os limites do retângulo de rolagem do objeto de exibição. | IFlexDisplayObject | ||
scrollV : int
A posição vertical do texto em um campo de texto. | IUITextField | ||
selectable : Boolean
Um valor booliano que indica se o campo de texto é selecionável. | IUITextField | ||
selectionBeginIndex : int [somente leitura]
O valor de índice de caractere com base em zero do primeiro caractere na seleção atual. | IUITextField | ||
selectionEndIndex : int [somente leitura]
O valor de índice de caractere com base em zero do último caractere na seleção atual. | IUITextField | ||
sharpness : Number
A nitidez das bordas de glifo neste campo de texto. | IUITextField | ||
stage : Stage [somente leitura]
O Palco do objeto de exibição. | IFlexDisplayObject | ||
styleName : Object
The source of this object's style values. | ISimpleStyleClient | ||
styleSheet : StyleSheet
Anexa uma folha de estilo ao campo de texto. | IUITextField | ||
systemManager : ISystemManager
A reference to the SystemManager object for this component. | IUIComponent | ||
tabEnabled : Boolean
Especifica se este objeto está na ordem de tabulação. | IUITextField | ||
tabIndex : int
Especifica a ordem de tabulação de objetos em um arquivo SWF. | IUITextField | ||
text : String
Uma string que é o texto atual no campo de texto. | IUITextField | ||
textColor : uint
A cor do texto em um campo de texto, em formato hexadecimal. | IUITextField | ||
textHeight : Number [somente leitura]
A altura do texto, em pixels. | IUITextField | ||
textWidth : Number [somente leitura]
A largura do texto, em pixels. | IUITextField | ||
thickness : Number
A espessura das bordas de glifo neste campo de texto. | IUITextField | ||
toolTip : String
The text of this component's tooltip. | IToolTipManagerClient | ||
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. | IFlexDisplayObject | ||
tweeningProperties : Array
Used by EffectManager. | IUIComponent | ||
type : String
O tipo do campo de texto. | IUITextField | ||
useRichTextClipboard : Boolean
Especifica se a formatação do texto será ou não copiada e colada junto com o texto. | IUITextField | ||
visible : Boolean
Se o objeto de exibição está ou não visível. | IFlexDisplayObject | ||
width : Number
Indica a largura do objeto de exibição, em pixels. | IFlexDisplayObject | ||
wordWrap : Boolean
Um valor booliano que indica se o campo de texto tem quebra automática. | IUITextField | ||
x : Number
Indica a coordenada x da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | IFlexDisplayObject | ||
y : Number
Indica a coordenada y da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | IFlexDisplayObject |
Método | Definido por | ||
---|---|---|---|
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. | IEventDispatcher | ||
Acrescenta a string especificada pelo parâmetro newText ao final do texto do campo de texto. | IUITextField | ||
Envia um evento para o fluxo de eventos. | IEventDispatcher | ||
Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace. | IFlexDisplayObject | ||
Retorna um retângulo que é a caixa delimitadora do caractere. | IUITextField | ||
Retorna o valor de índice com base em zero do caractere no ponto especificado pelos parâmetros x e y. | IUITextField | ||
A convenience method for determining whether to use the
explicit or measured height
| IUIComponent | ||
A convenience method for determining whether to use the
explicit or measured width
| IUIComponent | ||
Tendo sido fornecido um índice de caractere, retorna o índice do primeiro caractere no mesmo parágrafo. | IUITextField | ||
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>. | IUITextField | ||
Retorna o valor de índice com base em zero da linha no ponto especificado pelos parâmetros x e y. | IUITextField | ||
Retorna o valor de índice com base em zero da linha contendo o caractere especificado pelo parâmetro charIndex. | IUITextField | ||
Retorna o número de caracteres em uma linha de texto específica. | IUITextField | ||
Retorna informações de métrica de uma determinada linha de texto. | IUITextField | ||
Retorna o índice de caractere do primeiro caractere na linha que o parâmetro lineIndex especifica. | IUITextField | ||
Retorna o texto da linha especificada pelo parâmetro lineIndex. | IUITextField | ||
Tendo sido fornecido um índice de caractere, retorna o tamanho do parágrafo contendo o caractere específico. | IUITextField | ||
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. | IFlexDisplayObject | ||
Gets a style property that has been set anywhere in this
component's style lookup chain. | IUITextField | ||
Retorna um objeto TextFormat que contém informações de formatação do intervalo de texto especificado pelos parâmetros beginIndex e endIndex. | IUITextField | ||
Returns a UITextFormat object that contains formatting information for this component. | IUITextField | ||
Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais). | IFlexDisplayObject | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | IEventDispatcher | ||
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. | IFlexDisplayObject | ||
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. | IFlexDisplayObject | ||
Initialize the object. | IUIComponent | ||
Calling this method results in a call to the component's
validateDisplayList() method
before the display list is rendered. | IInvalidating | ||
Calling this method results in a call to the component's
validateProperties() method
before the display list is rendered. | IInvalidating | ||
Calling this method results in a call to the component's
validateSize() method
before the display list is rendered. | IInvalidating | ||
Converte o objeto de ponto a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais). | IFlexDisplayObject | ||
Moves this object to the specified x and y coordinates. | IFlexDisplayObject | ||
Returns true if the chain of owner properties
points from child to this UIComponent. | IUIComponent | ||
Called by Flex when a UIComponent object is added to or removed from a parent. | IUIComponent | ||
Remove um ouvinte do objeto EventDispatcher. | IEventDispatcher | ||
Substitui a seleção atual pelo conteúdo do parâmetro value. | IUITextField | ||
Substitui o intervalo de caracteres especificado pelos parâmetros beginIndex e endIndex pelo conteúdo do parâmetro newText. | IUITextField | ||
Sets the actual size of this object. | IFlexDisplayObject | ||
Sets the font color of the text. | IUITextField | ||
Sets the focus to this component. | IUITextField | ||
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. | IUITextField | ||
Aplica a formatação de texto determinada pelo parâmetro format ao texto especificado em um campo de texto. | IUITextField | ||
Called when the visible property changes. | IUIComponent | ||
Called when the value of a style property is changed. | ISimpleStyleClient | ||
Truncate text to make it fit horizontally in the area defined for the control,
and append an ellipsis, three periods (...), to the text. | IUITextField | ||
Validates and updates the properties and layout of this object
by immediately calling validateProperties(),
validateSize(), and validateDisplayList(),
if necessary. | IInvalidating | ||
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | IEventDispatcher |
alwaysShowSelection | propriedade |
alwaysShowSelection:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Quando definida como true
e o campo de texto não está em foco, o Flash Player realça a seleção no campo de texto em cinza. 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.
Implementação
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
antiAliasType | propriedade |
antiAliasType:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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
). A definição padrão é flash.text.AntiAliasType.NORMAL
.
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. Este valor corresponde ao tipo de suavização de borda que o Flash Player 7 e versões anteriores usavam. |
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. |
Implementação
public function get antiAliasType():String
public function set antiAliasType(value:String):void
autoSize | propriedade |
autoSize:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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):void
background | propriedade |
background:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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.
Implementação
public function get background():Boolean
public function set background(value:Boolean):void
backgroundColor | propriedade |
backgroundColor:uint
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
A cor do plano de fundo do campo de texto. O valor padrão é 0xFFFFFF
(branco). 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
.
Implementação
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
border | propriedade |
border:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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.
Implementação
public function get border():Boolean
public function set border(value:Boolean):void
borderColor | propriedade |
borderColor:uint
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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):void
bottomScrollV | propriedade |
bottomScrollV:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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 com base 1 da linha visível mais alta na 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():int
caretIndex | propriedade |
caretIndex:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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).
Implementação
public function get caretIndex():int
condenseWhite | propriedade |
condenseWhite:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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 deve ser removido. O valor padrão é false
. A propriedade condenseWhite
afeta apenas 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 os comandos HTML padrão, como <BR>
e <P>
, para colocar quebras de linha no campo de texto.
Defina a propriedade condenseWhite
antes da propriedade htmlText
.
Implementação
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
defaultTextFormat | propriedade |
defaultTextFormat:flash.text:TextFormat
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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.
Observação: na seleção de caracteres que serão substituídos por setSelection()
e replaceSelectedText()
, o defaultTextFormat
só será aplicado se o texto tiver sido selecionado até e inclusive o último caractere. Veja um exemplo:
var my_txt:TextField new TextField(); my_txt.text = "Flash Macintosh version"; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_txt.defaultTextFormat = my_fmt; my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied my_txt.replaceSelectedText("Windows version");
Quando você acessa a propriedade defaultTextFormat
, o objeto TextFormat retornado tem todas as sua propriedades definidas. Nenhuma propriedade é null
.
Observação: não será possível definir essa propriedade se uma folha de estilo for aplicada ao campo de texto.
Implementação
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
displayAsPassword | propriedade |
displayAsPassword:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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.
Implementação
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
doubleClickEnabled | propriedade |
doubleClickEnabled:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Especifica se o objeto recebe eventos doubleClick
. O valor padrão é false
, o que significa que, por padrão, qualquer ocorrência de InteractiveObject não recebe eventos doubleClick
. Se a propriedade doubleClickEnabled
estiver definida como true
, a ocorrência receberá eventos doubleClick
dentro de seus limites. A propriedade mouseEnabled
da ocorrência de InteractiveObject também deve ser definida como true
para que o objeto receba eventos doubleClick
.
Nenhum evento é despachado com o uso dessa propriedade. Você deve usar o método addEventListener()
para adicionar um ouvinte de evento para o evento doubleClick
.
Implementação
public function get doubleClickEnabled():Boolean
public function set doubleClickEnabled(value:Boolean):void
embedFonts | propriedade |
embedFonts:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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 estiver incorporada ao arquivo SWF, o texto não será exibido.
Implementação
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
focusRect | propriedade |
focusRect:Object
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Especifica se este objeto exibe um retângulo de foco. Pode ser um dos três valores: true
, false
ou null
. Os valores de true
e false
funcionam como esperado, especificando se o retângulo de foco aparece ou não. Um valor null
indica que esse objeto obedece à propriedade stageFocusRect
no Palco.
Implementação
public function get focusRect():Object
public function set focusRect(value:Object):void
gridFitType | propriedade |
gridFitType:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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. |
Implementação
public function get gridFitType():String
public function set gridFitType(value:String):void
htmlText | propriedade |
htmlText:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Contém a representação HTML do conteúdo do campo de texto.
O Flash Player oferece suporte para marcas 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 campo de texto. Defina o campo de texto como um campo de texto de várias linhas para usar essa marca.
|
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 aos campos de texto. O texto flui automaticamente pelas imagens que você incorpora nos campos de texto. Defina o campo de texto como sendo de várias linhas para dispor o texto ao redor de uma imagem.
A marca
O Flash exibe a mídia incorporada em um campo de texto com o tamanho total. Para especificar as dimensões da mídia que você está incorporando, use os atributos Em geral, uma imagem incorporada em um campo de texto é exibida na linha que segue a marca Para o conteúdo do AIR na área de segurança do aplicativo, o AIR ignora tags |
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 |
A marca <li> coloca um marcador na frente do texto que ela envolve. Observação: Como o Flash Player e o AIR não reconhecem as marcas de lista ordenada e não ordenada (<ol> e <ul> ), elas não modificam como a sua lista será renderizada. Todas as listas não estão ordenadas e todos os itens da lista utilizam marcadores.
|
Marca de parágrafo |
A marca <p> cria um novo parágrafo. O campo de texto deve ser definido como um campo de texto de várias linhas para usar essa marca. A marca <p> oferece suporte aos seguintes atributos:
|
Marca span |
A marca <span> está disponível apenas para uso com estilos de texto CSS. Ela oferece suporte ao seguinte atributo:
|
Marca de formato de texto |
A marca A marca
|
Marca de sublinhado |
A marca <u> sublinha o texto selecionado.
|
O Flash Player e o AIR oferecem suporte às seguintes entidades HTML:
Entidade | Descrição |
---|---|
< | < (menor que) |
> | > (maior que) |
& | & (E comercial) |
" | " (aspas duplas) |
' | ' (apóstrofo, aspas simples) |
O Flash e o AIR também oferecem suporte a 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):void
ignorePadding | propriedade |
ignorePadding:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
If true
, the paddingLeft
and
paddingRight
styles will not add space
around the text of the component.
Implementação
public function get ignorePadding():Boolean
public function set ignorePadding(value:Boolean):void
inheritingStyles | propriedade |
inheritingStyles:Object
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
The beginning of this UITextField's chain of inheriting styles.
The getStyle()
method accesses
inheritingStyles[styleName]
to search the entire
prototype-linked chain.
This object is set up by the initProtoChain()
method.
You typically never need to access this property directly.
Implementação
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void
length | propriedade |
maxChars | propriedade |
maxChars:int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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.
Implementação
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | propriedade |
maxScrollV | propriedade |
mouseEnabled | propriedade |
mouseEnabled:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. O valor padrão é true
, o que significa que, por padrão, qualquer instância de InteractiveObject na lista de exibição receberá eventos do mouse. Se mouseEnabled
for definido como false
, a instância não recebe nenhum evento de mouse (ou outros eventos de entrada de usuário como eventos do teclado). Nenhum filho dessa ocorrência na lista de exibição será afetado. Para alterar o comportamento de mouseEnabled
para todos os filhos de um objeto na lista de objetos, use flash.display.DisplayObjectContainer.mouseChildren
.
Nenhum evento é despachado com o uso dessa propriedade. É necessário usar o método addEventListener()
para criar uma funcionalidade interativa.
Implementação
public function get mouseEnabled():Boolean
public function set mouseEnabled(value:Boolean):void
mouseWheelEnabled | propriedade |
mouseWheelEnabled:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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. Por padrão, esse valor é true
. 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.
Implementação
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | propriedade |
multiline:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Indica se o campo é 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.
Implementação
public function get multiline():Boolean
public function set multiline(value:Boolean):void
nestLevel | propriedade |
nestLevel:int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Depth of this object in the containment hierarchy. This number is used by the measurement and layout code. The value is 0 if this component is not on the DisplayList.
Implementação
public function get nestLevel():int
public function set nestLevel(value:int):void
nonInheritingStyles | propriedade |
nonInheritingStyles:Object
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
The beginning of this UITextField's chain of non-inheriting styles.
The getStyle()
method accesses
nonInheritingStyles[styleName]
method to search the entire
prototype-linked chain.
This object is set up by the initProtoChain()
method.
You typically never need to access this property directly.
Implementação
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void
nonZeroTextHeight | propriedade |
nonZeroTextHeight:Number
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Unlike textHeight, this returns a non-zero value even when the text is empty. In this case, it returns what the textHeight would be if the text weren't empty.
Implementação
public function get nonZeroTextHeight():Number
numLines | propriedade |
numLines:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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():int
restrict | propriedade |
restrict:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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";
Implementação
public function get restrict():String
public function set restrict(value:String):void
scrollH | propriedade |
scrollH:int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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):void
scrollV | propriedade |
scrollV:int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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):void
selectable | propriedade |
selectable:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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 é selecionável e não se ele é editável. Um campo de texto dinâmico poderá ser selecionável mesmo se ele não for editável. Se um campo de texto dinâmico não for selecionável, o usuário não poderá selecionar o texto nele contido.
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. Você pode selecionar o texto dessa maneira, mesmo se o campo de texto for um campo de texto dinâmico e não de entrada.
Implementação
public function get selectable():Boolean
public function set selectable(value:Boolean):void
selectionBeginIndex | propriedade |
selectionBeginIndex:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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():int
selectionEndIndex | propriedade |
selectionEndIndex:int
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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():int
sharpness | propriedade |
sharpness:Number
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
A nitidez das bordas de glifo neste 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 intervalo de sharpness
é um número de -400 a 400. Se você tentar definir sharpness
como um valor fora desse intervalo, o Flash definirá a propriedade para o valor mais próximo no intervalo (-400 ou 400).
Implementação
public function get sharpness():Number
public function set sharpness(value:Number):void
styleSheet | propriedade |
styleSheet:StyleSheet
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Anexa uma folha de estilo ao campo de texto. Para obter informações sobre como criar planilhas, consulte a classe StyleSheet e o Guia do Desenvolvedor do ActionScript 3.0.
Você pode alterar a folha de estilo associada a um campo de texto a qualquer momento. Se você alterar a folha de estilo em uso, o campo de texto será redesenhado com a nova folha de estilo. Você pode definir a folha de estilo como null
ou undefined
para removê-la. Se a folha de estilo em uso for removida, o campo de texto será redesenhado sem uma folha de estilo.
Observação: se a folha de estilo for removida, o conteúdo de TextField.text
e TextField.htmlText
será alterado para incorporar a formatação anteriormente aplicada pela folha de estilo. Para preservar o conteúdo de TextField.htmlText
sem a formatação, salve o valor em uma variável antes de remover a folha de estilo.
Implementação
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
tabEnabled | propriedade |
tabEnabled:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Especifica se este objeto está na ordem de tabulação. Se o objeto estiver na ordem de tabulação, o valor será true
; caso contrário, o valor será false
. Por padrão, o valor é false
, exceto pelo seguinte:
- Para um objeto SimpleButton, o valor é
true
. - Para um objeto TextField com
type = "input"
, o valor étrue
. - Para um objeto Sprite ou MovieClip com
buttonMode = true
, o valor étrue
.
Implementação
public function get tabEnabled():Boolean
public function set tabEnabled(value:Boolean):void
tabIndex | propriedade |
tabIndex:int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Especifica a ordem de tabulação de objetos em um arquivo SWF. A propriedade tabIndex
é -1 por padrão, significando que nenhum índice de tabulação é definido para o objeto.
Se qualquer objeto atualmente exibido no arquivo SWF contiver uma propriedade tabIndex
, a ordenação de tabulação automática será desativada e essa ordenação será calculada a partir das propriedades tabIndex
de objetos no arquivo SWF. A ordenação de tabulação personalizada inclui apenas objetos que possuem propriedades tabIndex
.
A propriedade tabIndex
pode ser um inteiro não negativo. Os objetos são ordenados de acordo com suas propriedades tabIndex
, em ordem crescente. Um objeto com um valor tabIndex
de 1 precede um objeto com um valor tabIndex
de 2. Não use o mesmo valor tabIndex
para vários objetos.
A ordenação de guia personalizada definida pela propriedade tabIndex
é flat. Isso significa que nenhuma atenção é dada aos relacionamentos hierárquicos de objetos no arquivo SWF. Todos os objetos no arquivo SWF com propriedades tabIndex
são inseridos na ordem de tabulação, que é determinada pela ordem dos valores tabIndex
.
Nota: para definir a ordem de tabulação das instâncias TLFTextField, envie o filho do objeto de exibição de TLFTextField como um InteractiveObject e, em seguida, defina a propriedade tabIndex
. Por exemplo:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Para reverter a ordem das guia a partir da configuração padrão para as três instâncias de um objeto TLFTextField (
tlfInstance1
, tlfInstance2
e tlfInstance3
), use:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementação
public function get tabIndex():int
public function set tabIndex(value:int):void
text | propriedade |
text:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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
.
Nota: Se uma folha de estilos for aplicada ao conteúdo do campo de texto, o conteúdo da propriedade text
será interpretado como HTML.
Implementação
public function get text():String
public function set text(value:String):void
textColor | propriedade |
textColor:uint
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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
.
Implementação
public function get textColor():uint
public function set textColor(value:uint):void
textHeight | propriedade |
textWidth | propriedade |
thickness | propriedade |
thickness:Number
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
A espessura das bordas de glifo neste campo de texto. Essa propriedade será aplicada apenas quando flash.text.AntiAliasType
for definida como flash.text.AntiAliasType.ADVANCED
.
O intervalo de thickness
é um número de -200 a 200. Se você tentar definir thickness
como um valor fora desse intervalo, a propriedade será definida como o valor mais próximo no intervalo (-200 ou 200).
Implementação
public function get thickness():Number
public function set thickness(value:Number):void
type | propriedade |
type:String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
O tipo do campo de texto. Uma das seguintes constantes de TextFieldType: TextFieldType.DYNAMIC
, que especifica um campo de texto dinâmico, que um usuário não pode editar, ou TextFieldType.INPUT
, que especifica um campo de texto de entrada, que um usuário pode editar.
Implementação
public function get type():String
public function set type(value:String):void
useRichTextClipboard | propriedade |
useRichTextClipboard:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Especifica se a formatação do texto será ou não copiada e colada junto com o texto. Quando definida como true
, o Flash Player copiará e colará a formatação (como alinhamento, negrito e itálico) quando você copiar e colar entre os campos de texto. Os campos de texto de origem e de destino para o procedimento de cópia e colagem devem ter useRichTextClipboard
definida como true
. O valor padrão é false
.
Implementação
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
wordWrap | propriedade |
wordWrap:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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):void
appendText | () | método |
public function appendText(newText:String):void
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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 — The string to append to the existing text.
|
getCharBoundaries | () | método |
public function getCharBoundaries(charIndex:int):Rectangle
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Retorna um retângulo que é a caixa delimitadora do caractere.
Parâmetros
charIndex:int — The zero-based index value for the character (for example, the first
position is 0, the second position is 1, and so on).
|
Rectangle — A rectangle with x and y minimum and maximum values
defining the bounding box of the character.
|
getCharIndexAtPoint | () | método |
public function getCharIndexAtPoint(x:Number, y:Number):int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Retorna o valor de índice com base em zero do caractere no ponto especificado pelos parâmetros x
e y
.
Parâmetros
x:Number — The x coordinate of the character.
| |
y:Number — The y coordinate of the character.
|
int — The zero-based index value of the character (for example, the first position is 0,
the second position is 1, and so on). Returns -1 if the point is not over any character.
|
getFirstCharInParagraph | () | método |
public function getFirstCharInParagraph(charIndex:int):int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Tendo sido fornecido um índice de caractere, retorna o índice do primeiro caractere no mesmo parágrafo.
Parâmetros
charIndex:int — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — The zero-based index value of the first character in the same paragraph.
|
getImageReference | () | método |
public function getImageReference(id:String):DisplayObject
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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 — The id to match (in the id attribute of the
<img> tag).
|
DisplayObject — The display object corresponding to the image or SWF file with the matching id
attribute in the <img> tag of the text field. For media loaded from an external source,
this object is a Loader object, and, once loaded, the media object is a child of that Loader object. For media
embedded in the SWF file, it is the loaded object. If no <img> tag with
the matching id exists, the method returns null .
|
getLineIndexAtPoint | () | método |
public function getLineIndexAtPoint(x:Number, y:Number):int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Retorna o valor de índice com base em zero da linha no ponto especificado pelos parâmetros x
e y
.
Parâmetros
x:Number — The x coordinate of the line.
| |
y:Number — The y coordinate of the line.
|
int — The zero-based index value of the line (for example, the first line is 0, the
second line is 1, and so on). Returns -1 if the point is not over any line.
|
getLineIndexOfChar | () | método |
public function getLineIndexOfChar(charIndex:int):int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Retorna o valor de índice com base em zero da linha contendo o caractere especificado pelo parâmetro charIndex
.
Parâmetros
charIndex:int — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — The zero-based index value of the line.
|
getLineLength | () | método |
public function getLineLength(lineIndex:int):int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Retorna o número de caracteres em uma linha de texto específica.
Parâmetros
lineIndex:int — The line number for which you want the length.
|
int — The number of characters in the line.
|
getLineMetrics | () | método |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Retorna informações de métrica de uma determinada linha de texto.
Parâmetros
lineIndex:int — The line number for which you want metrics information.
|
flash.text:TextLineMetrics — A TextLineMetrics object.
|
getLineOffset | () | método |
public function getLineOffset(lineIndex:int):int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Retorna o índice de caractere do primeiro caractere na linha que o parâmetro lineIndex
especifica.
Parâmetros
lineIndex:int — The zero-based index value of the line (for example, the first line is 0,
the second line is 1, and so on).
|
int — The zero-based index value of the first character in the line.
|
getLineText | () | método |
public function getLineText(lineIndex:int):String
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Retorna o texto da linha especificada pelo parâmetro lineIndex
.
Parâmetros
lineIndex:int — The zero-based index value of the line (for example, the first line is 0,
the second line is 1, and so on).
|
String — The text string contained in the specified line.
|
getParagraphLength | () | método |
public function getParagraphLength(charIndex:int):int
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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 — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — Returns the number of characters in the paragraph.
|
getStyle | () | método |
public function getStyle(styleProp:String):*
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Gets a style property that has been set anywhere in this component's style lookup chain.
This same method is used to get any kind of style property, so the value returned can be a Boolean, String, Number, int, uint (for an RGB color), Class (for a skin), or any kind of object. Therefore the return type is simply specified as *.
If you are getting a particular style property, you know its type and often want to store the result in a variable of that type. No casting from * to that type is necessary.
var backgroundColor:uint = getStyle("backgroundColor");
If the style property has not been set anywhere in the
style lookup chain, the value returned by getStyle()
is undefined
.
Note that undefined
is a special value that is
not the same as false
, ""
,
NaN
, 0
, or null
.
No valid style value is ever undefined
.
You can use the method
IStyleManager2.isValidStyleValue()
to test whether the value was set.
Parâmetros
styleProp:String — Name of the style property.
|
* — Style value.
|
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: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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 ) — Optional; an integer that specifies the starting location of a range of text within the text field.
| |
endIndex:int (default = -1 ) — Optional; an integer that specifies the position of the first character after the desired
text span. As designed, if you specify beginIndex and endIndex values,
the text from beginIndex to endIndex-1 is read.
|
flash.text:TextFormat — The TextFormat object that represents the formatting properties for the specified text.
|
getUITextFormat | () | método |
public function getUITextFormat():mx.core:UITextFormat
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Returns a UITextFormat object that contains formatting information for this component.
This method is similar to the getTextFormat()
method of the
flash.text.TextField class, but it returns a UITextFormat object instead
of a TextFormat object.
The UITextFormat class extends the TextFormat class to add the text measurement methods
measureText()
and measureHTMLText()
.
mx.core:UITextFormat — An object that contains formatting information for this component.
|
replaceSelectedText | () | método |
public function replaceSelectedText(value:String):void
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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.
Observação: Esse método não funcionará se uma folha de estilo for aplicada ao campo de texto.
Parâmetros
value:String — The string to replace the currently selected text.
|
replaceText | () | método |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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.
Observação: Esse método não funcionará se uma folha de estilo for aplicada ao campo de texto.
Parâmetros
beginIndex:int — The zero-based index value for the start position of the replacement range.
| |
endIndex:int — The zero-based index position of the first character after the desired
text span.
| |
newText:String — The text to use to replace the specified range of characters.
|
setColor | () | método |
setFocus | () | método |
public function setFocus():void
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Sets the focus to this component. The component can in turn pass focus to a subcomponent.
Note: Only the TextInput and TextArea controls show a highlight when this method sets the focus. All controls show a highlight when the user tabs to the control.
setSelection | () | método |
public function setSelection(beginIndex:int, endIndex:int):void
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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
beginIndex:int — The zero-based index value of the first character in the selection
(for example, the first character is 0, the second character is 1, and so on).
| |
endIndex:int — The zero-based index value of the last character in the selection.
|
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: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
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
.
Observação: Esse método não funcionará se uma folha de estilo for aplicada ao campo de texto.
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 — A TextFormat object that contains character and paragraph formatting information.
| |||||||||
beginIndex:int (default = -1 ) — Optional; an integer that specifies the zero-based index position specifying the
first character of the desired range of text.
| |||||||||
endIndex:int (default = -1 ) — Optional; an integer that specifies the first character after the desired text span.
As designed, if you specify beginIndex and endIndex values,
the text from beginIndex to endIndex-1 is updated.
Notice that any text inserted manually by the user, or replaced by the
|
truncateToFit | () | método |
public function truncateToFit(truncationIndicator:String = null):Boolean
Versão da linguagem: | ActionScript 3.0 |
Versão de produto: | Flex 3 |
Versões de runtime: | Flash Player 9, AIR 1.1 |
Truncate text to make it fit horizontally in the area defined for the control, and append an ellipsis, three periods (...), to the text.
Parâmetros
truncationIndicator:String (default = null ) — The text to be appended after truncation.
If you pass null , a localizable string
such as "..." will be used.
|
Boolean — true if the text needed truncation.
|
Wed Jun 13 2018, 11:10 AM Z