Paquete | spark.core |
Interfaz | public interface IEditableText extends IDisplayText , IEventDispatcher |
Implementadores | RichEditableText, StyleableStageText, StyleableTextField |
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Propiedad | Definido por | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización. | IEditableText | ||
displayAsPassword : Boolean
Especifica si el campo de texto es de contraseña. | 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 [solo lectura]
A flag that indicates whether the text has been truncated. | IDisplayText | ||
lineBreak : String
Controls word wrapping within the text. | IEditableText | ||
maxChars : int
El número máximo de caracteres que puede incluir el campo de texto, tal y como los ha introducido el usuario. | IEditableText | ||
multiline : Boolean
Indica si el campo de texto es multilínea. | IEditableText | ||
restrict : String
Indica el conjunto de caracteres que los usuarios pueden introducir en el campo de texto. | IEditableText | ||
selectable : Boolean
Valor booleano que indica si el campo de texto puede seleccionarse. | IEditableText | ||
selectionActivePosition : int [solo lectura]
The active, or last clicked position, of the selection. | IEditableText | ||
selectionAnchorPosition : int [solo lectura]
The anchor, or first clicked position, of the selection. | IEditableText | ||
tabIndex : int
Especifica el orden de tabulación de los objetos de un archivo 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 un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | IEventDispatcher | ||
Appends the specified text to the end of the text component,
as if you had clicked at the end and typed. | IEditableText | ||
Distribuye un evento en el flujo del evento. | IEventDispatcher | ||
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | IEventDispatcher | ||
Inserts the specified text into the text component
as if you had typed it. | IEditableText | ||
Elimina un detector del 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 | ||
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | IEventDispatcher |
accessibilityProperties | propiedad |
accessibilityProperties:AccessibilityProperties
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Las opciones de accesibilidad actuales para este objeto de visualización. Si modifica la propiedad accessibilityProperties
o alguno de los campos contenidos en accessibilityProperties
, deberá llamar al método Accessibility.updateProperties()
para que los cambios surtan efecto.
Nota: en el caso de un objeto creado en el entorno de edición de Flash, el valor de accessibilityProperties
se rellena previamente con la información que haya introducido en el panel Accesibilidad para dicho objeto.
Implementación
public function get accessibilityProperties():AccessibilityProperties
public function set accessibilityProperties(value:AccessibilityProperties):void
displayAsPassword | propiedad |
displayAsPassword:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Especifica si el campo de texto es de contraseña. Si el valor de esta propiedad es true
, el campo de texto se trata como una contraseña y oculta la entrada de caracteres empleando asteriscos en lugar de los caracteres reales. Si su valor es false
, el campo de texto no se trata como una contraseña. Cuando está activado el modo de contraseña, los comandos Cortar y Copiar y sus correspondientes métodos abreviados de teclado no funcionan. Este mecanismo de seguridad impide que un usuario sin escrúpulos pueda utilizar los métodos abreviados para descubrir una contraseña en un equipo en el que no haya nadie presente.
Implementación
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | propiedad |
editable:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Flag that indicates whether the text is editable.
El valor predeterminado es false.
Implementación
public function get editable():Boolean
public function set editable(value:Boolean):void
enabled | propiedad |
enabled:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | 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.
Implementación
public function get enabled():Boolean
public function set enabled(value:Boolean):void
focusEnabled | propiedad |
focusEnabled:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | 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
.
Implementación
public function get focusEnabled():Boolean
public function set focusEnabled(value:Boolean):void
horizontalScrollPosition | propiedad |
horizontalScrollPosition:Number
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
The horizontal scroll position of the text.
Implementación
public function get horizontalScrollPosition():Number
public function set horizontalScrollPosition(value:Number):void
lineBreak | propiedad |
lineBreak:String
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Controls word wrapping within the text. This property corresponds to the lineBreak style.
Implementación
public function get lineBreak():String
public function set lineBreak(value:String):void
Elementos de API relacionados
maxChars | propiedad |
maxChars:int
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
El número máximo de caracteres que puede incluir el campo de texto, tal y como los ha introducido el usuario. Un script puede insertar más texto que maxChars
; la propiedad maxChars
sólo indica cuánto texto puede introducir el usuario. Si el valor de esta propiedad es 0
, el usuario puede introducir una cantidad ilimitada de texto.
Implementación
public function get maxChars():int
public function set maxChars(value:int):void
multiline | propiedad |
multiline:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Indica si el campo de texto es multilínea. Si el valor es true
, el campo de texto es multilínea; si el valor es false
, se trata de un campo de texto de una sola línea. En un tipo de campo TextFieldType.INPUT
, el valor multiline
determina si la tecla Intro
creará una nueva línea (si el valor es false
, se ignorará la tecla Intro
). Si pega texto en un objeto TextField
cuyo valor multiline
sea false
, las nuevas líneas se eliminarán del texto.
Implementación
public function get multiline():Boolean
public function set multiline(value:Boolean):void
restrict | propiedad |
restrict:String
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Indica el conjunto de caracteres que los usuarios pueden introducir en el campo de texto. Si el valor de la propiedad restrict
es null
, puede introducir cualquier carácter. Si el valor de la propiedad restrict
es una cadena vacía, no se puede introducir ningún carácter. Si el valor de la propiedad restrict
es una cadena de caracteres, puede introducir caracteres solamente en la cadena del campo de texto. La cadena se examina de izquierda a derecha. Se puede especificar un rango utilizando el carácter de guión (-). Sólo se limita la interacción del usuario; los scripts pueden incluir cualquier texto en el campo de texto. Esta propiedad no se sincroniza con las opciones de incorporación de fuentes del inspector de propiedades.
Si la cadena empieza por un carácter de intercalación (^), en un principio se aceptan todos los caracteres; los caracteres posteriores de la cadena se excluyen del conjunto de caracteres aceptados. Si la cadena no empieza por un carácter de intercalación (^), inicialmente no se acepta ningún carácter; los caracteres posteriores de la cadena se incluyen en el conjunto de caracteres aceptados.
En el ejemplo siguiente, sólo se permite que se introduzcan caracteres en mayúsculas, espacios y números en un campo de texto:
my_txt.restrict = "A-Z 0-9";
En el ejemplo siguiente, se incluyen todos los caracteres, con excepción de las letras en mayúsculas:
my_txt.restrict = "^a-z";
Puede utilizar una barra invertida para introducir un ^ o - literalmente. Las secuencias con barras invertidas aceptadas son \-, \^ o \\. La barra invertida debe ser un carácter real de la cadena, por lo que cuando se especifica en ActionScript, se debe utilizar una barra doble. Por ejemplo, el código siguiente incluye sólo el guión (-) y el símbolo de intercalación (^):
my_txt.restrict = "\\-\\^";
El carácter ^ se puede utilizar en cualquier lugar de la cadena para incluir o excluir caracteres. El código siguiente incluye sólo letras en mayúsculas, pero excluye la letra Q en mayúscula:
my_txt.restrict = "A-Z^Q";
Puede usar la secuencia de escape \u
para construir cadenas restrict
. El código siguiente incluye solamente los caracteres desde el ASCII 32 (espacio) al ASCII 126 (tilde).
my_txt.restrict = "\u0020-\u007E";
Implementación
public function get restrict():String
public function set restrict(value:String):void
selectable | propiedad |
selectable:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Valor booleano que indica si el campo de texto puede seleccionarse. El valor true
indica que el texto se puede seleccionar. La propiedad selectable
controla si un campo de texto se puede seleccionar y no si un campo de texto es editable. Un campo dinámico puede seleccionarse aunque no sea editable. Si un campo de texto dinámico no es seleccionable, el usuario no puede seleccionar su texto.
Si selectable
se define como false
, el texto del campo de texto no responderá a los comandos de selección del ratón o el teclado y el texto no se podrá copiar con el comando Copiar. Si selectable
se define como true
, el texto del campo de texto se puede seleccionar con el ratón o el teclado y se puede copiar utilizando el comando Copiar. Puede seleccionar texto de esta forma aunque el campo de texto sea dinámico en lugar de un campo de entrada de texto.
Implementación
public function get selectable():Boolean
public function set selectable(value:Boolean):void
selectionActivePosition | propiedad |
selectionActivePosition:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | 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.
Implementación
public function get selectionActivePosition():int
selectionAnchorPosition | propiedad |
selectionAnchorPosition:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | 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.
Implementación
public function get selectionAnchorPosition():int
tabIndex | propiedad |
tabIndex:int
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Especifica el orden de tabulación de los objetos de un archivo SWF. La propiedad tabIndex
es -1 de manera predeterminada, lo que significa que no se ha establecido el índice de tabulación para el objeto.
Si algún objeto mostrado actualmente en el archivo SWF contiene una propiedad tabIndex
, se desactivará el orden de tabulación automático y el orden de tabulación se calculará a partir de las propiedades tabIndex
de los objetos del archivo SWF. El orden de tabulación personalizado sólo incluye objetos que tienen propiedades tabIndex
.
La propiedad tabIndex
puede ser un entero no negativo. Los objetos se ordenan conforme a lo que indiquen las propiedades tabIndex
y en orden ascendente. Un objeto que tenga un valor tabIndex
de 1 precederá a otro objeto que tenga un valor tabIndex
de 2. No utilice el mismo valor de tabIndex
para varios objetos.
El orden de tabulación personalizado que define la propiedad tabIndex
es flat (plano o no jerárquico). Esto significa que no se tienen en cuenta las relaciones jerárquicas entre los objetos del archivo SWF. Todos los objetos del archivo SWF con propiedades tabIndex
tendrán su lugar en el orden de tabulación, que se determinará por el orden de los valores de tabIndex
.
Nota: para definir el orden de tabulación de instancias de TLFTextField, asigne el elemento secundario del objeto de visualización de TLFTextField como un objeto InteractiveObject y después establezca la propiedad tabIndex
. Por ejemplo:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Para invertir el orden de tabulación en el ajuste predeterminado de tres instancias de un objeto TLFTextField (
tlfInstance1
, tlfInstance2
y tlfInstance3
), utilice:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementación
public function get tabIndex():int
public function set tabIndex(value:int):void
verticalScrollPosition | propiedad |
verticalScrollPosition:Number
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
The vertical scroll position of the text.
Implementación
public function get verticalScrollPosition():Number
public function set verticalScrollPosition(value:Number):void
appendText | () | método |
public function appendText(text:String):void
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Selects all of the text.
selectRange | () | método |
public function selectRange(anchorIndex:int, activeIndex:int):void
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 4.5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2.0 |
Set focus to this text field.
Tue Jun 12 2018, 02:12 PM Z