Paquete | mx.core |
Interfaz | public interface IUITextField extends IIMESupport , IFlexModule , IInvalidating , ISimpleStyleClient , IToolTipManagerClient , IUIComponent , IFlexDisplayObject , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
Implementadores | UIFTETextField, UITextField |
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Propiedad | Definido por | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización. | IFlexDisplayObject | ||
alpha : Number
Indica el valor de transparencia alfa del objeto especificado. | IFlexDisplayObject | ||
alwaysShowSelection : Boolean
Cuando se establece como true y el campo de texto no está seleccionado, Flash Player resalta la selección del campo de texto en color gris. | IUITextField | ||
antiAliasType : String
Tipo de suavizado que se utiliza en este campo de texto. | IUITextField | ||
autoSize : String
Controla la asignación de tamaño y alineación automáticas de los campos de texto. | IUITextField | ||
background : Boolean
Especifica si el campo de texto tiene relleno de fondo. | IUITextField | ||
backgroundColor : uint
Color del fondo del campo de texto. | IUITextField | ||
baselinePosition : Number [solo lectura]
The y-coordinate of the baseline
of the first line of text of the component. | IUIComponent | ||
blendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse. | IFlexDisplayObject | ||
border : Boolean
Especifica si el campo de texto tiene un borde. | IUITextField | ||
borderColor : uint
Color del borde del campo de texto. | IUITextField | ||
bottomScrollV : int [solo lectura]
Un entero (índice basado en uno) que indica la última línea visible en el campo de texto especificado. | IUITextField | ||
cacheAsBitmap : Boolean
Si se define como true, los motores de ejecución de Flash dejan en caché una representación interna de mapa de bits del objeto de visualización. | IFlexDisplayObject | ||
caretIndex : int [solo lectura]
El índice de la posición del punto de inserción (intercalación). | IUITextField | ||
condenseWhite : Boolean
Un valor booleano que especifica si se eliminarán los espacios en blanco adicionales (espacios, saltos de línea, etc.) en el campo de texto con texto HTML. | IUITextField | ||
defaultTextFormat : flash.text:TextFormat
Especifica el formato aplicado al texto nuevo insertado, por ejemplo, texto introducido por un usuario o insertado mediante el método replaceSelectedText(). | IUITextField | ||
displayAsPassword : Boolean
Especifica si el campo de texto es de contraseña. | IUITextField | ||
document : Object
A reference to the document object associated with this component. | IUIComponent | ||
doubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick. | IUITextField | ||
embedFonts : Boolean
Especifica si representar utilizando contornos de fuentes incorporadas. | IUITextField | ||
enabled : Boolean
Whether the component can accept user interaction. | IUIComponent | ||
enableIME : Boolean [solo lectura]
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 [solo lectura]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMaxWidth : Number [solo lectura]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinHeight : Number [solo lectura]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinWidth : Number [solo lectura]
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
Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización. | 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 si este objeto muestra un rectángulo de selección. | IUITextField | ||
gridFitType : String
Tipo de ajuste de cuadrícula que se utiliza en este campo de texto. | IUITextField | ||
height : Number
Indica la altura del objeto de visualización, expresada en píxeles. | IFlexDisplayObject | ||
htmlText : String
Contiene la representación HTML del contenido del 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 [solo lectura]
El número de caracteres de un campo de texto. | IUITextField | ||
loaderInfo : LoaderInfo [solo lectura]
Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización. | IFlexDisplayObject | ||
mask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado. | IFlexDisplayObject | ||
maxChars : int
El número máximo de caracteres que puede incluir el campo de texto, tal y como los ha introducido el usuario. | IUITextField | ||
maxHeight : Number [solo lectura]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
maxScrollH : int [solo lectura]
Valor máximo de scrollH. | IUITextField | ||
maxScrollV : int [solo lectura]
Valor máximo de scrollV. | IUITextField | ||
maxWidth : Number [solo lectura]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
measuredHeight : Number [solo lectura]
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 [solo lectura]
The measured width of this object. | IFlexDisplayObject | ||
minHeight : Number [solo lectura]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
minWidth : Number [solo lectura]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
mouseEnabled : Boolean
Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes. | IUITextField | ||
mouseWheelEnabled : Boolean
Valor booleano que indica si Flash Player desplazará automáticamente campos de texto multilínea cuando el usuario haga clic en un campo de texto y gire la rueda del ratón. | IUITextField | ||
mouseX : Number [solo lectura]
Indica la coordenada x de la posición del ratón o del dispositivo de entrada del usuario, en píxeles. | IFlexDisplayObject | ||
mouseY : Number [solo lectura]
Indica la coordenada y de la posición del ratón o del dispositivo de entrada del usuario, en píxeles. | IFlexDisplayObject | ||
multiline : Boolean
Indica si el campo de texto es multilínea. | IUITextField | ||
name : String
Indica el nombre de instancia 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 [solo lectura]
Unlike textHeight, this returns a non-zero value
even when the text is empty. | IUITextField | ||
numLines : int [solo lectura]
Define el número de líneas de texto de un campo de varias líneas. | IUITextField | ||
opaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo. | IFlexDisplayObject | ||
owner : DisplayObjectContainer
The owner of this IVisualElement object. | IUIComponent | ||
parent : DisplayObjectContainer [solo lectura]
Indica el objeto DisplayObjectContainer que contiene este objeto de visualización. | 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 el conjunto de caracteres que los usuarios pueden introducir en el campo de texto. | IUITextField | ||
root : DisplayObject [solo lectura]
Para un objeto de visualización en un archivo SWF cargado, la propiedad root es el objeto de visualización de nivel más alto en la parte de la estructura de árbol de la lista de visualización representada por dicho archivo SWF. | IFlexDisplayObject | ||
rotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original. | IFlexDisplayObject | ||
scale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente. | IFlexDisplayObject | ||
scaleX : Number
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro. | IFlexDisplayObject | ||
scaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto. | IFlexDisplayObject | ||
scrollH : int
La posición de desplazamiento horizontal actual. | IUITextField | ||
scrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización. | IFlexDisplayObject | ||
scrollV : int
La posición vertical del texto de un campo de texto. | IUITextField | ||
selectable : Boolean
Valor booleano que indica si el campo de texto puede seleccionarse. | IUITextField | ||
selectionBeginIndex : int [solo lectura]
El valor de índice basado en cero del primer carácter de la selección actual. | IUITextField | ||
selectionEndIndex : int [solo lectura]
El valor de índice basado en cero del último carácter de la selección actual. | IUITextField | ||
sharpness : Number
La nitidez de los bordes de glifo en este campo de texto. | IUITextField | ||
stage : Stage [solo lectura]
El escenario del objeto de visualización. | IFlexDisplayObject | ||
styleName : Object
The source of this object's style values. | ISimpleStyleClient | ||
styleSheet : StyleSheet
Asocia una hoja de estilos al campo de texto. | IUITextField | ||
systemManager : ISystemManager
A reference to the SystemManager object for this component. | IUIComponent | ||
tabEnabled : Boolean
Especifica si este objeto está en el orden de tabulación. | IUITextField | ||
tabIndex : int
Especifica el orden de tabulación de los objetos de un archivo SWF. | IUITextField | ||
text : String
Una cadena que es el texto actual del campo de texto. | IUITextField | ||
textColor : uint
El color del texto de un campo de texto, expresado en formato hexadecimal. | IUITextField | ||
textHeight : Number [solo lectura]
La altura del texto, expresada en píxeles. | IUITextField | ||
textWidth : Number [solo lectura]
La anchura del texto, expresada en píxeles. | IUITextField | ||
thickness : Number
El grosor de los bordes de glifo en este campo de texto. | IUITextField | ||
toolTip : String
The text of this component's tooltip. | IToolTipManagerClient | ||
transform : flash.geom:Transform
Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización. | IFlexDisplayObject | ||
tweeningProperties : Array
Used by EffectManager. | IUIComponent | ||
type : String
Tipo del campo de texto. | IUITextField | ||
useRichTextClipboard : Boolean
Especifica si se copia y se pega el formato del texto junto con el propio texto. | IUITextField | ||
visible : Boolean
Indica si el objeto de visualización es visible. | IFlexDisplayObject | ||
width : Number
Indica la anchura del objeto de visualización, expresada en píxeles. | IFlexDisplayObject | ||
wordWrap : Boolean
Valor booleano que indica si el campo de texto tiene ajuste de texto. | IUITextField | ||
x : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. | IFlexDisplayObject | ||
y : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. | IFlexDisplayObject |
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 | ||
Añade la cadena especifica por el parámetro newText al final del texto del campo de texto. | IUITextField | ||
Distribuye un evento en el flujo del evento. | IEventDispatcher | ||
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace. | IFlexDisplayObject | ||
Devuelve un rectángulo como recuadro de delimitación del carácter. | IUITextField | ||
Devuelve un valor de índice basado en cero del carácter en el punto especificado por los 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 | ||
Dado un índice del carácter, devuelve el índice del primer carácter del mismo párrafo. | IUITextField | ||
Devuelve una referencia DisplayObject para el id dado, ya que se ha añadido una imagen o un archivo SWF a un campo de texto con formato HTML mediante la etiqueta <img>. | IUITextField | ||
Devuelve un valor de índice basado en cero de la línea en el punto especificado por los parámetros x e y. | IUITextField | ||
Devuelve un valor de índice basado en cero de la línea que contiene el carácter especificado por el parámetro | IUITextField | ||
Devuelve el número de caracteres de una línea de texto específica. | IUITextField | ||
Devuelve información de medidas sobre una línea de texto dada. | IUITextField | ||
Devuelve el índice de carácter del primer carácter de la línea especificada por el parámetro lineIndex. | IUITextField | ||
Devuelve el texto de la línea especificada por el parámetro lineIndex. | IUITextField | ||
Dado un índice de carácter, devuelve la longitud del párrafo que contiene dicho carácter. | IUITextField | ||
Devuelve un rectángulo que define el límite del objeto de visualización, basado en el sistema de coordenadas definido por el parámetro targetCoordinateSpace, excluyendo los trazos en las formas. | IFlexDisplayObject | ||
Gets a style property that has been set anywhere in this
component's style lookup chain. | IUITextField | ||
Devuelve un objeto TextFormat que contiene información de formato para el rango de texto especificado por los parámetros beginIndex y endIndex. | IUITextField | ||
Returns a UITextFormat object that contains formatting information for this component. | IUITextField | ||
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales). | IFlexDisplayObject | ||
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | IEventDispatcher | ||
Calcula el cuadro delimitador del objeto de visualización para ver si se solapa o corta con el cuadro delimitador del objeto de visualización obj. | IFlexDisplayObject | ||
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el punto especificado por los 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 | ||
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales). | 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 | ||
Elimina un detector del objeto EventDispatcher. | IEventDispatcher | ||
Reemplaza la selección actual por el contenido del parámetro del valor. | IUITextField | ||
Reemplaza el rango de caracteres especificados por los parámetros beginIndex y endIndex con el contenido del 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 | ||
Establece como seleccionado el texto designado por los valores de índice de los primeros y últimos caracteres, especificados por los parámetros beginIndex y endIndex. | IUITextField | ||
Aplica el formato de texto especificado por el parámetro format al texto especificado en un 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 | ||
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 |
alwaysShowSelection | propiedad |
alwaysShowSelection:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Cuando se establece como true
y el campo de texto no está seleccionado, Flash Player resalta la selección del campo de texto en color gris. Cuando se define como false
y el campo de texto no está seleccionado, Flash Player no resalta la selección del campo de texto.
Implementación
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
antiAliasType | propiedad |
antiAliasType:String
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Tipo de suavizado que se utiliza en este campo de texto. Utilice constantes flash.text.AntiAliasType
para esta propiedad. Sólo puede controlar este parámetro de configuración si la fuente está incorporada (con la propiedad embedFonts
definida como true
). El valor predeterminado es flash.text.AntiAliasType.NORMAL
.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
Valor de la cadena | Descripción |
---|---|
flash.text.AntiAliasType.NORMAL | Aplica el suavizado de texto regular. Este valor equivale al tipo de suavizado que utilizaba Flash Player en la versión 7 y anteriores. |
flash.text.AntiAliasType.ADVANCED | Aplica suavizado avanzado, que aumenta la legibilidad del texto. (Esta función pasó a estar disponible en Flash Player 8.) El suavizado avanzado proporciona máxima calidad de representación para las fuentes de tamaño pequeño. Ofrece mejores resultados con aplicaciones que presentan gran cantidad de texto pequeño. No se recomienda utilizarlo con fuentes de más de 48 puntos. |
Implementación
public function get antiAliasType():String
public function set antiAliasType(value:String):void
autoSize | propiedad |
autoSize:String
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Controla la asignación de tamaño y alineación automáticas de los campos de texto. Los valores válidos para las constantes TextFieldAutoSize
son: TextFieldAutoSize.NONE
(predeterminado), TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
y TextFieldAutoSize.CENTER
.
Si autoSize
se define como TextFieldAutoSize.NONE
(predeterminado), no se produce cambio de tamaño.
Si autoSize
se define como TextFieldAutoSize.LEFT
, se considerará que el texto está justificado a la izquierda, lo que significa que el lado izquierdo del campo de texto permanecerá fijo y el cambio de tamaño de un campo de texto de una sola línea tendrá lugar en el lado derecho. Si el texto incluye un salto de línea (por ejemplo, "\n"
o "\r"
), también se cambiará el tamaño del lado inferior para dar cabida a la siguiente línea de texto. Si wordWrap
también se ha definido como true
, sólo se cambiará el tamaño del lado inferior del campo de texto, mientras que el lado derecho permanecerá fijo.
Si autoSize
se define como TextFieldAutoSize.RIGHT
, se considerará que el texto está justificado a la izquierda, lo que significa que el lado derecho del campo de texto permanecerá fijo y el cambio de tamaño de un campo de texto de una sola línea tendrá lugar en el lado izquierdo. Si el texto incluye un salto de línea (por ejemplo, "\n" o "\r"
), también se cambiará el tamaño del lado inferior para dar cabida a la siguiente línea de texto. Si wordWrap
también se ha definido como true
, sólo se cambiará el tamaño del lado inferior del campo de texto, mientras que el lado izquierdo permanecerá fijo.
Si autoSize
se define como TextFieldAutoSize.CENTER
, se considerará que el texto está centrado, lo que significa que el cambio de tamaño de un campo de texto de una sola línea se distribuirá por igual entre los márgenes derecho e izquierdo. Si el texto incluye un salto de línea (por ejemplo, "\n"
o "\r"
), también se cambiará el tamaño del lado inferior para dar cabida a la siguiente línea de texto. Si wordWrap
también se define como true
, sólo se cambiará el tamaño del lado inferior del campo de texto, mientras que los lados izquierdo y derecho permanecerán fijos.
Implementación
public function get autoSize():String
public function set autoSize(value:String):void
background | propiedad |
background:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Especifica si el campo de texto tiene relleno de fondo. Si es true
, el campo de texto tiene relleno de fondo. Si es false
, el campo de texto no tiene relleno de fondo. Utilice la propiedad backgroundColor
para establecer el color de fondo de un campo de texto.
Implementación
public function get background():Boolean
public function set background(value:Boolean):void
backgroundColor | propiedad |
backgroundColor:uint
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Color del fondo del campo de texto. El valor predeterminado es 0xFFFFFF
(blanco). Esta propiedad puede recuperarse o establecerse aunque no haya actualmente ningún fondo, pero el color sólo estará visible si el campo de texto tiene la propiedad background
definida como true
.
Implementación
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
border | propiedad |
border:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Especifica si el campo de texto tiene un borde. Si es true
, especifica si el campo de texto tiene un borde. Si es false
, el campo de texto no tiene borde. Utilice la propiedad borderColor
para definir el color del borde.
Implementación
public function get border():Boolean
public function set border(value:Boolean):void
borderColor | propiedad |
borderColor:uint
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Color del borde del campo de texto. El valor predeterminado es 0x000000
(negro). Esta propiedad puede recuperarse o definirse aunque no haya actualmente ningún borde, pero el color sólo estará visible si el campo de texto tiene la propiedad border
definida como true
.
Implementación
public function get borderColor():uint
public function set borderColor(value:uint):void
bottomScrollV | propiedad |
bottomScrollV:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Un entero (índice basado en uno) que indica la última línea visible en el campo de texto especificado. Considere el campo de texto como una ventana en un bloque de texto. La propiedad scrollV
es el índice basado en uno de la primera línea visible en la ventana.
El texto existente entre las líneas indicado por scrollV
y bottomScrollV
está visible actualmente en el campo de texto.
Implementación
public function get bottomScrollV():int
caretIndex | propiedad |
caretIndex:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
El índice de la posición del punto de inserción (intercalación). Si no se muestra ningún punto de inserción, el valor es la posición en la que estaría el punto de inserción si se recuperase la selección en el campo (normalmente, la última posición del punto de inserción o un valor 0 si el campo no se ha seleccionado nunca).
Los índices de espacio de selección están basados en cero (por ejemplo, la primera posición es 0, la segunda es 1, etc.).
Implementación
public function get caretIndex():int
condenseWhite | propiedad |
condenseWhite:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Un valor booleano que especifica si se eliminarán los espacios en blanco adicionales (espacios, saltos de línea, etc.) en el campo de texto con texto HTML. El valor predeterminado es false
. La propiedad condenseWhite
sólo afecta al texto definido con la propiedad htmlText
, no con la propiedad text
. Si define texto con la propiedad text
, condenseWhite
se omitirá.
Si la propiedad condenseWhite
se establece como true
, utilice comandos HTML estándar, como <BR>
y <P>
, para incluir saltos de línea en el campo de texto.
Defina la propiedad condenseWhite
antes de hacer lo propio con htmlText
.
Implementación
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
defaultTextFormat | propiedad |
defaultTextFormat:flash.text:TextFormat
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Especifica el formato aplicado al texto nuevo insertado, por ejemplo, texto introducido por un usuario o insertado mediante el método replaceSelectedText()
.
Nota: cuando se seleccionan caracteres para reemplazar con setSelection()
y replaceSelectedText()
, defaultTextFormat
se aplica únicamente si el texto se ha seleccionado hasta el último carácter. A continuación, se muestra un ejemplo:
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");
Cuando se accede a la propiedad defaultTextFormat
, el objeto TextFormat devuelto tiene todas sus propiedades definidas. Ninguna de las propiedades tiene el valor null
.
Nota: no se puede establecer esta propiedad si se aplica una hoja de estilos al campo de texto.
Implementación
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
displayAsPassword | propiedad |
displayAsPassword:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
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
doubleClickEnabled | propiedad |
doubleClickEnabled:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Especifica si este objeto recibe eventos doubleClick
. El valor predeterminado es false
, lo que significa que, de manera predeterminada, toda instancia de InteractiveObject no recibe eventos doubleClick
. Si la propiedad doubleClickEnabled
se establece con el valor true
, la instancia recibirá eventos doubleClick
dentro de sus límites. La propiedad mouseEnabled
de la instancia de InteractiveObject debe también estar configurada con el valor true
para que el objeto reciba eventos doubleClick
.
No se distribuye ningún evento al establecer esta propiedad. Debe utilizar el método addEventListener()
para añadir un detector de eventos para el evento doubleClick
.
Implementación
public function get doubleClickEnabled():Boolean
public function set doubleClickEnabled(value:Boolean):void
embedFonts | propiedad |
embedFonts:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Especifica si representar utilizando contornos de fuentes incorporadas. Si es false
, Flash Player representa el campo de texto empleando fuentes de dispositivo.
Si define la propiedad embedFonts
como true
para un campo de texto, debe especificar una fuente para ese texto mediante la propiedad font
de un objeto TextFormat aplicado al campo de texto. Si la fuente especificada no está incorporada en el archivo SWF, el texto no se mostrará.
Implementación
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
focusRect | propiedad |
focusRect:Object
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Especifica si este objeto muestra un rectángulo de selección. Puede tener uno de estos tres valores: true
, false
o null
. Los valores true
y false
funcionan como siempre: especifican si aparece o no el rectángulo seleccionado. El valor null
indica que este objeto obedece a la propiedad stageFocusRect
establecida en el escenario.
Implementación
public function get focusRect():Object
public function set focusRect(value:Object):void
gridFitType | propiedad |
gridFitType:String
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Tipo de ajuste de cuadrícula que se utiliza en este campo de texto. Esta propiedad sólo se aplica si la propiedad flash.text.AntiAliasType
del campo de texto se define como flash.text.AntiAliasType.ADVANCED
.
El tipo de ajuste de cuadrícula empleado determina si Flash Player hará que las líneas horizontales y verticales se ajusten a una cuadrícula de píxeles o de subpíxeles o si no realizará ningún ajuste.
Para la propiedad flash.text.GridFitType
, puede utilizar los siguientes valores de cadena:
Valor de la cadena | Descripción |
---|---|
flash.text.GridFitType.NONE | Sin ajuste de cuadrícula. Las líneas horizontales y verticales de los glifos no se ajustan a la cuadrícula de píxeles. Se recomienda utilizar este valor con animaciones o tamaños de fuente grandes. |
flash.text.GridFitType.PIXEL | Especifica que las líneas horizontales y verticales intensas se ajustan a la cuadrícula de píxeles. Este parámetro sólo funciona para campos de texto alineados a la izquierda. Para usar este parámetro de configuración, la propiedad flash.dispaly.AntiAliasType del campo de texto debe estar definida como flash.text.AntiAliasType.ADVANCED . En general, es la opción que más facilita la lectura de texto con alineación a la izquierda. |
flash.text.GridFitType.SUBPIXEL | Especifica que las líneas horizontales y verticales intensas se ajusten a la cuadrícula de subpíxeles en monitores LCD. Para usar este parámetro de configuración, la propiedad flash.text.AntiAliasType del campo de texto debe estar definida como flash.text.AntiAliasType.ADVANCED . La configuración de flash.text.GridFitType.SUBPIXEL suele ser una buena opción para texto dinámico con alineación central o alineación a la derecha y en ocasiones ofrece un buen equilibrio entre animación y calidad de texto. |
Implementación
public function get gridFitType():String
public function set gridFitType(value:String):void
htmlText | propiedad |
htmlText:String
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Contiene la representación HTML del contenido del campo de texto.
Flash Player admite las siguientes etiquetas HTML:
Etiqueta | Descripción |
---|---|
Etiqueta de anclaje |
La etiqueta <a> crea un vínculo de hipertexto y admite los atributos siguientes:
|
Etiqueta de negrita |
La etiqueta <b> muestra el texto en negrita. Debe haber un tipo de letra en negrita disponible para la fuente utilizada.
|
Etiqueta de salto de línea |
La etiqueta <br> crea un salto de línea en el campo de texto. Configure el campo de texto como multilínea para poder utilizar esta etiqueta.
|
Etiqueta de fuente |
La etiqueta <font> especifica una fuente o una lista de fuentes para mostrar el texto. La etiqueta de fuente admite los atributos siguientes:
|
Etiqueta de imagen |
La etiqueta <img> permite incorporar archivos de imagen externos (JPEG, GIF, PNG), archivos SWF y clips de película en los campos de texto. El texto fluye automáticamente alrededor de las imágenes incorporadas en los campos de texto. Debe configurar el campo de texto como multilínea para que se ajuste el texto en torno a una imagen.
La etiqueta
Flash muestra los medios incorporados en un campo de texto con su tamaño completo. Para especificar las dimensiones de los medios que está incorporando, utilice los atributos En general, las imágenes incorporadas a un campo de texto aparecen en la línea que sigue a la etiqueta En contenido de AIR del entorno limitado de seguridad de la aplicación, AIR omite las etiquetas |
Etiqueta de cursiva |
La etiqueta <i> muestra el texto encerrado en cursiva. Debe haber un tipo de letra en cursiva disponible para la fuente utilizada.
|
Etiqueta de elemento de lista |
La etiqueta <li> coloca un viñeta delante del texto incluido en la etiqueta. Nota: debido a que Flash Player y AIR no reconocen etiquetas de lista ordenadas y no ordenadas (<ol> y <ul> ), no afectan al modo en que se muestra la lista. Todas las listas son no ordenadas y todos sus elementos utilizan viñetas.
|
Etiqueta de párrafo |
La etiqueta <p> crea un párrafo nuevo. El campo de texto se debe configurar como multilínea para poder utilizar esta etiqueta. La etiqueta <p> admite los siguientes atributos:
|
Etiqueta de espacio |
La etiqueta <span> sólo está disponible para uso con los estilos de texto CSS. Admite el atributo siguiente:
|
Etiqueta de formato de texto |
La etiqueta La etiqueta
|
Etiqueta de subrayado |
La etiqueta <u> subraya el texto encerrado.
|
Flash Player y AIR admiten las siguientes entidades HTML:
Entidad | Descripción |
---|---|
< | < (menor que) |
> | > (mayor que) |
& | & (ampersand) |
" | " (comillas dobles) |
' | ' (apóstrofe, comilla simple) |
Flash Player y AIR también admiten códigos de caracteres explícitos, como & (ampersand ASCII) y € (símbolo € Unicode).
Implementación
public function get htmlText():String
public function set htmlText(value:String):void
ignorePadding | propiedad |
ignorePadding:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
If true
, the paddingLeft
and
paddingRight
styles will not add space
around the text of the component.
Implementación
public function get ignorePadding():Boolean
public function set ignorePadding(value:Boolean):void
inheritingStyles | propiedad |
inheritingStyles:Object
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | 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.
Implementación
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void
length | propiedad |
maxChars | propiedad |
maxChars:int
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
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
maxScrollH | propiedad |
maxScrollV | propiedad |
mouseEnabled | propiedad |
mouseEnabled:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes. El valor predeterminado es true
, lo que significa que, de manera predeterminada, toda instancia de InteractiveObject que esté en la lista de visualización recibirá eventos de ratón u otros eventos de entrada del usuario. Si mouseEnabled
se establece en false
, la instancia no recibirá ningún evento de ratón (o cualquier otra entrada de usuario como eventos de teclado). Los elementos secundarios de esta instancia en la lista de visualización no se verán afectados. Para cambiar el comportamiento mouseEnabled
de todos los elementos secundarios de un objeto de la lista de visualización, utilice flash.display.DisplayObjectContainer.mouseChildren
.
No se distribuye ningún evento al establecer esta propiedad. Debe utilizar el método addEventListener()
para crear funcionalidad interactiva.
Implementación
public function get mouseEnabled():Boolean
public function set mouseEnabled(value:Boolean):void
mouseWheelEnabled | propiedad |
mouseWheelEnabled:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Valor booleano que indica si Flash Player desplazará automáticamente campos de texto multilínea cuando el usuario haga clic en un campo de texto y gire la rueda del ratón. De forma predeterminada, este valor es true
. Esta propiedad resulta útil si desea impedir que la rueda del ratón pueda desplazar campos de texto o si desea implementar su propio desplazamiento de campo de texto.
Implementación
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | propiedad |
multiline:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
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
nestLevel | propiedad |
nestLevel:int
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | 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.
Implementación
public function get nestLevel():int
public function set nestLevel(value:int):void
nonInheritingStyles | propiedad |
nonInheritingStyles:Object
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | 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.
Implementación
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void
nonZeroTextHeight | propiedad |
nonZeroTextHeight:Number
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | 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.
Implementación
public function get nonZeroTextHeight():Number
numLines | propiedad |
numLines:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Define el número de líneas de texto de un campo de varias líneas. Si la propiedad wordWrap
se establece como true
, el número de líneas aumenta al ajustarse el texto.
Implementación
public function get numLines():int
restrict | propiedad |
restrict:String
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
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
scrollH | propiedad |
scrollH:int
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
La posición de desplazamiento horizontal actual. Si la propiedad scrollH
es 0, el texto no se desplazará horizontalmente. El valor de esta propiedad es un entero que representa la posición horizontal, expresada en píxeles.
Las unidades de desplazamiento horizontal son píxeles, mientras que las de desplazamiento vertical son líneas. El desplazamiento horizontal se mide en píxeles porque la mayoría de las fuentes que utiliza normalmente tienen espaciado proporcional, lo que significa que los caracteres tienen anchuras diferentes. Flash Player realiza el desplazamiento vertical por líneas, ya que el usuario normalmente desea ver una línea de texto completa y no sólo parte de ella. Aunque en una línea se utilicen varias fuentes, la altura de la línea se ajusta a la de la fuente más grande.
Nota: la propiedad scrollH
está basada en cero (a diferencia de la propiedad de desplazamiento vertical scrollV
, que está basada en uno).
Implementación
public function get scrollH():int
public function set scrollH(value:int):void
scrollV | propiedad |
scrollV:int
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
La posición vertical del texto de un campo de texto. La propiedad scrollV
es útil para dirigir a los usuarios a un párrafo específico en un pasaje largo o para crear campos de texto con desplazamiento.
Las unidades de desplazamiento vertical son líneas, mientras que las de desplazamiento horizontal son píxeles. Si la primera línea mostrada es la primera línea del campo de texto, scrollV se establece como 1 (no como 0). El desplazamiento horizontal se mide en píxeles porque la mayoría de las fuentes que utiliza tienen espaciado proporcional, lo que significa que los caracteres tienen anchuras diferentes. Flash realiza el desplazamiento vertical por líneas, ya que el usuario normalmente desea ver una línea de texto completa y no sólo parte de ella. Aunque en una línea se utilicen varias fuentes, la altura de la línea se ajusta a la de la fuente más grande.
Implementación
public function get scrollV():int
public function set scrollV(value:int):void
selectable | propiedad |
selectable:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
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
selectionBeginIndex | propiedad |
selectionBeginIndex:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
El valor de índice basado en cero del primer carácter de la selección actual. Por ejemplo, el primer carácter es 0, el segundo es 1, etc. Si no hay texto seleccionado, esta propiedad es el valor de caretIndex
.
Implementación
public function get selectionBeginIndex():int
selectionEndIndex | propiedad |
selectionEndIndex:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
El valor de índice basado en cero del último carácter de la selección actual. Por ejemplo, el primer carácter es 0, el segundo es 1, etc. Si no hay texto seleccionado, esta propiedad es el valor de caretIndex
.
Implementación
public function get selectionEndIndex():int
sharpness | propiedad |
sharpness:Number
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
La nitidez de los bordes de glifo en este campo de texto. Esta propiedad sólo se aplica si la propiedad flash.text.AntiAliasType
del campo de texto se define como flash.text.AntiAliasType.ADVANCED
. El rango de sharpness
es un número entre -400 y 400. Si intenta definir sharpness
con un valor fuera del rango, Flash selecciona el valor más cercano en el rango (-400 o 400) para la propiedad.
Implementación
public function get sharpness():Number
public function set sharpness(value:Number):void
styleSheet | propiedad |
styleSheet:StyleSheet
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Asocia una hoja de estilos al campo de texto. Para más información sobre la creación de hojas de estilos, consulte la clase StyleSheet y la Guía del desarrollador de ActionScript 3.0.
La hoja de estilos asociada a un campo de texto se puede cambiar en cualquier momento. Si se cambia la hoja de estilos en uso, el campo de texto vuelve a dibujarse utilizando la nueva hoja de estilos. Se puede definir la hoja de estilos como null
o undefined
para eliminarla. Si se elimina la hoja de estilos en uso, el campo de texto vuelve a dibujarse sin ninguna hoja de estilos.
Nota: si se elimina la hoja de estilos, cambia el contenido de TextField.text
y TextField.htmlText
para incorporar el formato aplicado anteriormente por la hoja de estilos. Para conservar el contenido original de TextField.htmlText
sin el formato, guarde el valor en una variable antes de eliminar la hoja de estilos.
Implementación
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
tabEnabled | propiedad |
tabEnabled:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Especifica si este objeto está en el orden de tabulación. Si este objeto está en el orden de tabulación, el valor es true
; en caso contrario, el valor es false
. De forma predeterminada, el valor es false
, salvo en lo siguiente:
- En un objeto SimpleButton, el valor es
true
. - En un objeto TextField con
type = "input"
, el valor estrue
. - En un objeto Sprite o MovieClip con
buttonMode = true
, el valor estrue
.
Implementación
public function get tabEnabled():Boolean
public function set tabEnabled(value:Boolean):void
tabIndex | propiedad |
tabIndex:int
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
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
text | propiedad |
text:String
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Una cadena que es el texto actual del campo de texto. Las líneas se separan mediante el carácter de retorno de carro ('\r'
, ASCII 13). La propiedad contiene texto sin formato en el campo de texto, sin etiquetas HTML.
Para obtener el texto en formato HTML, utilice la propiedad htmlText
.
Nota: si se aplica una hoja de estilos al campo de texto, el contenido de la propiedad text
se interpreta como HTML.
Implementación
public function get text():String
public function set text(value:String):void
textColor | propiedad |
textColor:uint
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
El color del texto de un campo de texto, expresado en formato hexadecimal. El sistema de colores hexadecimal utiliza seis dígitos para representar los valores de color. Cada dígito tiene 16 valores o caracteres posibles. El rango de caracteres oscila entre 0 y 9, y entre A y F. Por ejemplo, el color negro es 0x000000
; el color blanco es 0xFFFFFF
.
Implementación
public function get textColor():uint
public function set textColor(value:uint):void
textHeight | propiedad |
textWidth | propiedad |
thickness | propiedad |
thickness:Number
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
El grosor de los bordes de glifo en este campo de texto. Esta propiedad sólo se aplica cuando flash.text.AntiAliasType
es flash.text.AntiAliasType.ADVANCED
.
El rango de thickness
es un número entre -200 y 200. Si intenta definir thickness
con un valor fuera del rango, la propiedad se define como el valor más cercano en el rango (-200 ó 200).
Implementación
public function get thickness():Number
public function set thickness(value:Number):void
type | propiedad |
type:String
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Tipo del campo de texto. Puede ser una de las siguientes constantes TextFieldType: TextFieldType.DYNAMIC
, que especifica un campo de texto dinámico que el usuario no puede editar, o bien TextFieldType.INPUT
, que especifica un campo de introducción de texto que el usuario sí puede editar.
Implementación
public function get type():String
public function set type(value:String):void
useRichTextClipboard | propiedad |
useRichTextClipboard:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Especifica si se copia y se pega el formato del texto junto con el propio texto. Cuando se establece como true
, Flash Player también copia y pega el formato (alineación, negrita y cursiva) al copiar y pegar entre dos campos de texto. Tanto el campo de texto de origen como el de destino en el procedimiento de copiar y pegar deben tener useRichTextClipboard
definido como true
. El valor predeterminado es false
.
Implementación
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
wordWrap | propiedad |
wordWrap:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Valor booleano que indica si el campo de texto tiene ajuste de texto. Si el valor de wordWrap
es true
, el campo de texto tiene ajuste de texto; si el valor es false
, el campo de texto no tiene ajuste de texto. El valor predeterminado es false
.
Implementación
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
appendText | () | método |
public function appendText(newText:String):void
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Añade la cadena especificada por el parámetro newText
al final del texto del campo de texto. Este método es más eficaz que una asignación de suma (+=
) en una propiedad text
(por ejemplo, someTextField.text += moreText
), especialmente para un campo de texto que incluye una importante cantidad de contenido.
Parámetros
newText:String — The string to append to the existing text.
|
getCharBoundaries | () | método |
public function getCharBoundaries(charIndex:int):Rectangle
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Devuelve un rectángulo como recuadro de delimitación del carácter.
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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Devuelve un valor de índice basado en cero del carácter en el punto especificado por los 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Dado un índice del carácter, devuelve el índice del primer carácter del mismo párrafo.
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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Devuelve una referencia DisplayObject para el id
dado, ya que se ha añadido una imagen o un archivo SWF a un campo de texto con formato HTML mediante la etiqueta <img>
. La etiqueta <img>
tiene el siguiente 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Devuelve un valor de índice basado en cero de la línea en el punto especificado por los 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Devuelve un valor de índice basado en cero de la línea que contiene el carácter especificado por el 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Devuelve el número de caracteres de una línea 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Devuelve información de medidas sobre una línea de texto dada.
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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Devuelve el índice de carácter del primer carácter de la línea especificada por el 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).
|
int — The zero-based index value of the first character in the line.
|
getLineText | () | método |
public function getLineText(lineIndex:int):String
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Devuelve el texto de la línea especificada por el 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Dado un índice de carácter, devuelve la longitud del párrafo que contiene dicho carácter. La longitud se mide con respecto al primer carácter del párrafo (tal como la devuelve getFirstCharInParagraph()
), no con respecto al índice de carácter.
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):*
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Devuelve un objeto TextFormat que contiene información de formato para el rango de texto especificado por los parámetros beginIndex
y endIndex
. En el objeto TextFormat resultante, sólo se establecen las propiedades que son comunes a todo el texto del campo de texto. Todas las propiedades que sean mixtas, es decir, que tengan valores diferentes en distintos puntos del texto, tendrán el valor null
.
Si no se especifican valores para estos parámetros, el método se aplicará a todo el texto del campo de texto.
La tabla siguiente describe tres posibles usos:
Uso | Descripción |
---|---|
my_textField.getTextFormat() | Devuelve un objeto TextFormat que contiene información de formato para todo el texto de un campo de texto. En el objeto TextFormat resultante, sólo se establecen las propiedades que son comunes a todo el texto del campo de texto. Todas las propiedades que sean mixtas, es decir, que tengan valores diferentes en distintos puntos del texto, tendrán el valor null . |
my_textField.getTextFormat(beginIndex:Number) | Devuelve un objeto TextFormat que contiene una copia del formato del texto del carácter en la posición de beginIndex . |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Devuelve un objeto TextFormat que contiene información de formato para el texto comprendido entre beginIndex y endIndex-1 . En el objeto TextFormat resultante, sólo se establecen las propiedades que son comunes a todo el texto del rango especificado. Todas las propiedades que sean mixtas (es decir, que tengan valores diferentes en distintos puntos del rango), estarán configuradas con el valor 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Reemplaza la selección actual por el contenido del parámetro value
. El texto se inserta en la posición de la selección actual empleando el formato de carácter predeterminado y el formato de párrafo predeterminado actuales. El texto no se crea como HTML.
Puede utilizar el método replaceSelectedText()
para insertar y eliminar texto sin modificar el formato de carácter y de párrafo del resto del texto.
Nota: este método no funcionará si se aplica una hoja de estilos al 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Reemplaza el rango de caracteres especificados por los parámetros beginIndex
y endIndex
con el contenido del parámetro newText.
Según su diseño, se sustituye el texto de beginIndex
a endIndex-1
.
Nota: este método no funcionará si se aplica una hoja de estilos al 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Define como seleccionado el texto designado por los valores de índice de los primeros y últimos caracteres, especificados por los parámetros beginIndex
y endIndex
. Si los dos valores de parámetro coinciden, este método definirá un punto de inserción, del mismo modo que al establecer la propiedad 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Aplica el formato de texto especificado por el parámetro format
al texto especificado en un campo de texto. El valor de format
debe ser un objeto TextFormat que especifique los cambios de formato deseados del texto. Sólo se aplican al campo de texto las propiedades de format
que no tengan valor null. No se aplicará ninguna propiedad de format
definida como null
. De manera predeterminada, todas las propiedades del objeto TextFormat de nueva creación están configuradas con el valor null
.
Nota: este método no funcionará si se aplica una hoja de estilos al campo de texto.
El método setTextFormat()
cambia el formato de texto aplicado a un rango de caracteres o a todo el cuerpo del texto de un campo de texto. Para aplicar las propiedades del formato a todo el texto del campo de texto, no especifique valores para beginIndex
y endIndex
. Para aplicar las propiedades del formato a un rango de texto, especifique valores para los parámetros beginIndex
y endIndex
. Se puede utilizar la propiedad length
para determinar los valores de índice.
Los dos tipos de información de formato en un objeto TextFormat son el formato de nivel de carácter y el formato de nivel de párrafo. Cada carácter de un campo de texto puede tener su propia configuración de formato de carácter, como nombre de fuente, tamaño de fuente, negrita y cursiva.
En el caso de los párrafos, se examina el primer carácter del párrafo en busca de la configuración de formato de párrafo para el párrafo completo. Margen izquierdo, margen derecho y sangría son ejemplos de configuración de formato de párrafo.
El texto insertado manualmente por el usuario o sustituido mediante el método replaceSelectedText()
recibe el formato predeterminado de campo de texto para texto nuevo, no el formato especificado para el punto de inserción del texto. Para definir el formato predeterminado para texto nuevo, utilice 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
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flex 3 |
Versiones de motor de ejecución: | 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.
|
Tue Jun 12 2018, 02:12 PM Z