Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: Recuperando datos del servidor...
Recuperando datos del servidor...
spark.core 

IEditableText  - AS3 Flex

Paquetespark.core
Interfazpublic 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

The IEditableText interface defines the properties and methods for editable text.



Propiedades públicas
 PropiedadDefinido 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
 InheritedisTruncated : 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
 Inheritedtext : String
The text displayed by this text component.
IDisplayText
  verticalScrollPosition : Number
The vertical scroll position of the text.
IEditableText
Métodos públicos
 MétodoDefinido por
 Inherited
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
 Inherited
Distribuye un evento en el flujo del evento.
IEventDispatcher
 Inherited
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
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
IEventDispatcher
  
scrollToRange(anchorPosition:int, activePosition:int):void
Scroll so the specified range is in view.
IEditableText
  
Selects all of the text.
IEditableText
  
selectRange(anchorIndex:int, activeIndex:int):void
Selects a specified range of characters.
IEditableText
  
Set focus to this text field.
IEditableText
 Inherited
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
Información sobre propiedades

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
Información sobre métodos

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.





[ X ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.