| Pacote | spark.core |
| Interface | public interface IEditableText extends IDisplayText , IEventDispatcher |
| Implementadores | RichEditableText, StyleableStageText, StyleableTextField |
| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
| Propriedade | Definido por | ||
|---|---|---|---|
| accessibilityProperties : AccessibilityProperties
As opções de acessibilidade atuais para este objeto de exibição. | IEditableText | ||
| displayAsPassword : Boolean
Especifica se o campo de texto é um campo de texto de senha. | IEditableText | ||
| editable : Boolean
Flag that indicates whether the text is editable. | IEditableText | ||
| enabled : Boolean
Whether the component can accept user interaction. | IEditableText | ||
| focusEnabled : Boolean
Indicates whether the component can receive focus when tabbed to. | IEditableText | ||
| horizontalScrollPosition : Number
The horizontal scroll position of the text. | IEditableText | ||
![]() | isTruncated : Boolean [somente leitura]
A flag that indicates whether the text has been truncated. | IDisplayText | |
| lineBreak : String
Controls word wrapping within the text. | IEditableText | ||
| maxChars : int
O número máximo de caracteres que o campo de texto pode conter, conforme digitado por um usuário. | IEditableText | ||
| multiline : Boolean
Indica se o campo é um campo de texto de várias linhas. | IEditableText | ||
| restrict : String
Indica o conjunto de caracteres que um usuário pode digitar no campo de texto. | IEditableText | ||
| selectable : Boolean
Um valor booliano que indica se o campo de texto é selecionável. | IEditableText | ||
| selectionActivePosition : int [somente leitura]
The active, or last clicked position, of the selection. | IEditableText | ||
| selectionAnchorPosition : int [somente leitura]
The anchor, or first clicked position, of the selection. | IEditableText | ||
| tabIndex : int
Especifica a ordem de tabulação de objetos em um arquivo SWF. | IEditableText | ||
![]() | text : String
The text displayed by this text component. | IDisplayText | |
| verticalScrollPosition : Number
The vertical scroll position of the text. | IEditableText | ||
| 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 | |
Appends the specified text to the end of the text component,
as if you had clicked at the end and typed. | IEditableText | ||
![]() |
Envia um evento para o fluxo de eventos. | IEventDispatcher | |
![]() |
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | IEventDispatcher | |
Inserts the specified text into the text component
as if you had typed it. | IEditableText | ||
![]() |
Remove um ouvinte do objeto EventDispatcher. | IEventDispatcher | |
Scroll so the specified range is in view. | IEditableText | ||
Selects all of the text. | IEditableText | ||
Selects a specified range of characters. | IEditableText | ||
Set focus to this text field. | IEditableText | ||
![]() |
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 | |
accessibilityProperties | propriedade |
accessibilityProperties:AccessibilityProperties| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
As opções de acessibilidade atuais para este objeto de exibição. Se você modificar a propriedade accessibilityProperties ou qualquer um dos campos em accessibilityProperties, deverá chamar o método Accessibility.updateProperties() para que as alterações sejam efetivadas.
Observação: Para um objeto criado no ambiente de autoria do Flash, o valor de accessibilityProperties é pré-preenchido com todas as informações inseridas no painel Acessibilidade desse objeto.
Implementação
public function get accessibilityProperties():AccessibilityProperties public function set accessibilityProperties(value:AccessibilityProperties):voiddisplayAsPassword | propriedade |
displayAsPassword:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
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):voideditable | propriedade |
editable:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
Flag that indicates whether the text is editable.
O valor padrão é false.
Implementação
public function get editable():Boolean public function set editable(value:Boolean):voidenabled | propriedade |
enabled:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
Whether the component can accept user interaction. After setting the enabled
property to false, some components still respond to mouse interactions such
as mouseOver. As a result, to fully disable UIComponents,
you should also set the value of the mouseEnabled property to false.
If you set the enabled property to false
for a container, Flex dims the color of the container and of all
of its children, and blocks user input to the container
and to all of its children.
Implementação
public function get enabled():Boolean public function set enabled(value:Boolean):voidfocusEnabled | propriedade |
focusEnabled:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
Indicates whether the component can receive focus when tabbed to.
You can set focusEnabled to false
when a UIComponent is used as a subcomponent of another component
so that the outer component becomes the focusable entity.
If this property is false, focus is transferred to
the first parent that has focusEnable
set to true.
The default value is true, except for the
spark.components.Scroller component.
For that component, the default value is false.
Implementação
public function get focusEnabled():Boolean public function set focusEnabled(value:Boolean):voidhorizontalScrollPosition | propriedade |
horizontalScrollPosition:Number| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
The horizontal scroll position of the text.
Implementação
public function get horizontalScrollPosition():Number public function set horizontalScrollPosition(value:Number):voidlineBreak | propriedade |
lineBreak:String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
Controls word wrapping within the text. This property corresponds to the lineBreak style.
Implementação
public function get lineBreak():String public function set lineBreak(value:String):voidElementos da API relacionados
maxChars | propriedade |
maxChars:int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
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):voidmultiline | propriedade |
multiline:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
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):voidrestrict | propriedade |
restrict:String| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
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):voidselectable | propriedade |
selectable:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
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):voidselectionActivePosition | propriedade |
selectionActivePosition:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
The active, or last clicked position, of the selection. If the implementation does not support selection anchor this is the last character of the selection.
Implementação
public function get selectionActivePosition():intselectionAnchorPosition | propriedade |
selectionAnchorPosition:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
The anchor, or first clicked position, of the selection. If the implementation does not support selection anchor this is the first character of the selection.
Implementação
public function get selectionAnchorPosition():inttabIndex | propriedade |
tabIndex:int| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
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):voidverticalScrollPosition | propriedade |
verticalScrollPosition:Number| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
The vertical scroll position of the text.
Implementação
public function get verticalScrollPosition():Number public function set verticalScrollPosition(value:Number):voidappendText | () | método |
public function appendText(text:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
Appends the specified text to the end of the text component, as if you had clicked at the end and typed.
An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.
Parâmetros
text:String — The text to be appended.
|
insertText | () | método |
public function insertText(text:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
Inserts the specified text into the text component as if you had typed it.
If a range was selected, the new text replaces the selected text. If there was an insertion point, the new text is inserted there.
An insertion point is then set after the new text. If necessary, the text will scroll to ensure that the insertion point is visible.
Parâmetros
text:String — The text to be inserted.
|
scrollToRange | () | método |
public function scrollToRange(anchorPosition:int, activePosition:int):void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
Scroll so the specified range is in view.
Parâmetros
anchorPosition:int — The anchor position of the selection range.
| |
activePosition:int — The active position of the selection range.
|
selectAll | () | método |
public function selectAll():void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
Selects all of the text.
selectRange | () | método |
public function selectRange(anchorIndex:int, activeIndex:int):void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
Selects a specified range of characters.
If either position is negative, it will deselect the text range.
Parâmetros
anchorIndex:int — The character position specifying the end
of the selection that stays fixed when the selection is extended.
| |
activeIndex:int — The character position specifying the end
of the selection that moves when the selection is extended.
|
setFocus | () | método |
public function setFocus():void| Versão da linguagem: | ActionScript 3.0 |
| Versão de produto: | Flex 4.5 |
| Versões de runtime: | Flash Player 10.1, AIR 2.0 |
Set focus to this text field.
Wed Jun 13 2018, 11:10 AM Z
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas