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):void
displayAsPassword | 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):void
editable | 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):void
enabled | 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):void
focusEnabled | 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):void
horizontalScrollPosition | 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):void
lineBreak | 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):void
Elementos 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):void
multiline | 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):void
restrict | 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):void
selectable | 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):void
selectionActivePosition | 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():int
selectionAnchorPosition | 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():int
tabIndex | 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):void
verticalScrollPosition | 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):void
appendText | () | 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