| Paquete | flash.text |
| Clase | public final class StageText |
| Herencia | StageText  EventDispatcher Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Esta clase permite aplicaciones móviles para recopilar datos introducidos por el usuario utilizando controles de entrada de texto nativo en dispositivos móviles. Los controles de entrada en dispositivos móviles tienen a menudo interfaces de usuario detalladas y admiten comportamientos que no existen en el escritorio. Por ejemplo, muchos dispositivos móviles admiten funciones de entrada texto como las siguientes:
- completar automáticamente
- corregir automáticamente
- selección táctil de texto
- teclas programables personalizables
El sistema operativo subyacente (o una biblioteca de componentes incluida en el sistema operativo) dibuja campos de entrada de texto nativo. Los campos de entrada de texto nativo brindan una experiencia familiar para cualquiera que haya utilizado otras aplicaciones en el mismo dispositivo. Sin embargo, dado que es el sistema operativo y no el reproductor quien dibuja los campos de entrada de texto, no se pueden utilizar fuentes incorporadas.
Compatibilidad con perfil de AIR: esta función es compatible en las plataformas iOS y Android. StageText utiliza campos de entrada de texto nativo en dispositivos móviles iOS y Android. En otras plataformas, StageText utiliza el objeto TextField del motor de ejecución de Flash.
Cuando se utiliza entrada nativa, los objetos StageText no son objetos de visualización y no se pueden añadir a la lista de visualización de Flash. En su lugar, muestre un objeto StageText adjuntándolo directamente a un escenario con la propiedad stage. La instancia de StageText unida a un escenario se muestra por encima de cualquier objeto de visualización de Flash. Puede controlar el tamaño y la posición del área representación con la propiedad viewPort. No hay forma de controlar la ordenación de profundidad de distintos objetos StageText. No se recomienda superponer dos instancias.
Cuando un objeto StageText tiene la selección, es el primero en poder tratar la entrada del teclado. El escenario al que se asocia el objeto StageText no distribuye ningún evento de entrada de teclado.
Como la clase StageText engloba un control nativo distinto en cada plataforma, el grado de compatibilidad varía según la plataforma. Aunque se admitan las mismas funciones, es posible que su comportamiento sea distinto en función de la plataforma. Si se intenta utilizar una característica concreta en una plataforma en particular, lo mejor es probar el comportamiento. Sólo en plataformas de escritorio donde no se utilizan controles nativos el comportamiento de StageText será similar al comportamiento del texto del motor de ejecución de Flash.
StageText en Apple TV se enfoca de forma predeterminada. Para administrar el foco entre distintos objetos en su aplicación, tenga en cuenta los puntos siguientes:
- Para sustituir el foco predeterminado de StageText o asignar el foco a cualquier otro objeto de visualización, utilice stage.focus.
- Para asignar un foco a StageText, utilice stageText.assignFocus ().
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
| autoCapitalize : String
Controla cómo un dispositivo automático aplica minúsculas y mayúsculas a la entrada del usuario. | StageText | ||
| autoCorrect : Boolean
Indica si un dispositivo corrige automáticamente la ortografía de la entrada del usuario o si detecta errores de puntuación. | StageText | ||
| clearButtonMode : String [solo escritura]
Modo de clearButton del objeto StageText actual. | StageText | ||
| color : uint
Especifica el color del texto. | StageText | ||
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| displayAsPassword : Boolean
Indica si el campo de texto es un campo de texto de contraseña. | StageText | ||
| editable : Boolean
Indica si el usuario puede modificar el campo de texto. | StageText | ||
| fontFamily : String
Indica el nombre de la familia actual de fuentes. | StageText | ||
| fontPosture : String
Especifica la postura de la fuente con constantes definidas en la clase FontPosture. | StageText | ||
| fontSize : int
El tamaño en píxeles de la familia actual de fuentes. | StageText | ||
| fontWeight : String
Especifica el peso de la fuente con constantes definidas en la clase FontWeight. | StageText | ||
| locale : String
Indica la configuración regional del texto. | StageText | ||
| maxChars : int
Indica el número máximo de caracteres que los usuarios pueden introducir en el campo de texto. | StageText | ||
| multiline : Boolean [solo lectura]
Indica si el objeto StageText puede visualizar más de una línea de texto. | StageText | ||
| restrict : String
Limita el conjunto de caracteres que los usuarios pueden introducir en el campo de texto. | StageText | ||
| returnKeyLabel : String
Indica la etiqueta de la tecla Retorno para dispositivos que disponen de teclado virtual. | StageText | ||
| selectionActiveIndex : int [solo lectura]
El valor de índice basado en cero del último carácter de la selección actual. | StageText | ||
| selectionAnchorIndex : int [solo lectura]
El valor de índice basado en cero del primer carácter de la selección actual. | StageText | ||
| softKeyboardType : String
Controla la apariencia del teclado virtual. | StageText | ||
| stage : Stage
El escenario en el que se visualiza el objeto StageText. | StageText | ||
| text : String
El texto actual del campo de texto. | StageText | ||
| textAlign : String
Indica la alineación del párrafo. | StageText | ||
| viewPort : Rectangle
El área del escenario en la que se visualiza el objeto StageText. | StageText | ||
| visible : Boolean
Indica si el objeto StageText está visible. | StageText | ||
| Método | Definido por | ||
|---|---|---|---|
Crea un objeto StageText. | StageText | ||
| 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. | EventDispatcher | |
Asigna la selección al objeto StageText. | StageText | ||
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
Se deshace de este objeto StageText. | StageText | ||
Dibuja el puerto de la vista de StageText en un mapa de bits. | StageText | ||
|
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Elimina un detector del objeto EventDispatcher. | EventDispatcher | |
Selecciona el texto especificado por los valores de índice de los caracteres primero y último. | StageText | ||
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
|
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher | |
| Evento | Resumen | Definido por | ||
|---|---|---|---|---|
| [evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | ||
| Se distribuye una vez modificado el contenido del texto. | StageText | |||
| Se distribuye después de configurar un escenario con valor no null y un objeto viewPort no vacío. | StageText | |||
| [evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | ||
| Se distribuye cuando el usuario está editando texto y el control tiene la selección del teclado. | StageText | |||
| Se distribuye cuando el usuario deja de editar texto y el control deja de tener la selección del teclado. | StageText | |||
| Se distribuye cuando el usuario pulsa una tecla. | StageText | |||
| Se distribuye cuando el usuario suelta una tecla. | StageText | |||
| Se distribuye después de activar el teclado virtual, cuando el objeto StageText adquiere la selección. | StageText | |||
| Se distribuye antes de activar el teclado virtual, cuando el objeto StageText adquiere la selección. | StageText | |||
| Se distribuye después de desactivar el teclado virtual, cuando el objeto StageText pierde la selección. | StageText | |||
autoCapitalize | propiedad |
autoCapitalize:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Controla cómo un dispositivo automático aplica minúsculas y mayúsculas a la entrada del usuario. Los valores válidos se definen como constantes en la clase AutoCapitalize.
- "none"
- "palabra"
- "frase"
- "all"
Esta propiedad es solamente una sugerencia para la plataforma subyacente, ya que no todos los dispositivos y sistemas operativos admiten esta funcionalidad.
Nota: si se activa autoCapitalize mientras se edita o se trabaja con texto, el comportamiento actualizado no se aplica hasta que el foco de atención cambia y se restablece.
El valor predeterminado es AutoCapitalize.NONE.
Implementación
public function get autoCapitalize():String public function set autoCapitalize(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de AutoCapitalize
|
Elementos de API relacionados
autoCorrect | propiedad |
autoCorrect:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Indica si un dispositivo corrige automáticamente la ortografía de la entrada del usuario o si detecta errores de puntuación.
Esta propiedad es solamente una sugerencia para la plataforma subyacente, ya que no todos los dispositivos y sistemas operativos admiten esta funcionalidad.
Nota: si se activa autoCorrect mientras se edita o se trabaja con texto, el comportamiento actualizado no se aplica hasta que el foco de atención cambia y se restablece.
El valor predeterminado es false.
Implementación
public function get autoCorrect():Boolean public function set autoCorrect(value:Boolean):void clearButtonMode | propiedad |
clearButtonMode:String [solo escritura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 23 |
Modo de clearButton del objeto StageText actual. Existen cuatro modos asociados a esta propiedad:
-
Para mostrar clearButton durante la edición:
StageTextClearButtonMode.WHILE_EDITING -
Para no mostrar nunca clearButton:
StageTextClearButtonMode.NEVER -
Para mostrar siempre clearButton:
StageTextClearButtonMode.ALWAYS -
Para mostrar clearButton siempre que no se esté editando:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode está definida como StageTextClearButtonMode.WHILE_EDITING.
Nota: Esta propiedad solo es compatible con iOS.
Implementación
public function set clearButtonMode(value:String):void color | propiedad |
color:uint| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Especifica el color del texto. Especifique el color del texto como un número con tres componentes RGB de 8 bits. El primer componente representa el rojo, el segundo representa el verde y el tercer componente representa el azul. Por ejemplo, 0xFF0000 especifica el rojo, 0x00FF00 especifica el verde y 0x0000FF especifica el azul. El color de texto predeterminado es negro (0x000000).
El valor predeterminado es 0x000000.
Implementación
public function get color():uint public function set color(value:uint):void displayAsPassword | propiedad |
displayAsPassword:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Indica si el campo de texto es un campo de texto de contraseña. Si es true, el campo de texto oculta la entrada de caracteres empleando caracteres de sustitución (por ejemplo, asteriscos).
Nota: si se activa displayAsPassword mientras se edita o se trabaja con texto, el comportamiento actualizado no se aplica hasta que el foco de atención cambia y se restablece.
Importante: en iOS, un objeto de texto multilínea no muestra caracteres de sustitución incluso si el valor de esta propiedad es true.
El valor predeterminado es false.
Implementación
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):void editable | propiedad |
fontFamily | propiedad |
fontFamily:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Indica el nombre de la familia actual de fuentes. Un valor null indica el valor predeterminado del sistema. Para enumerar las fuentes disponibles utilice flash.text.Font.enumerateFonts(). Si no se reconoce la familia de fuentes, se utilizará la familia de fuentes predeterminada.
El valor predeterminado es null.
Implementación
public function get fontFamily():String public function set fontFamily(value:String):void fontPosture | propiedad |
fontPosture:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Especifica la postura de la fuente con constantes definidas en la clase FontPosture.
El valor predeterminado es FontPosture.NORMAL.
Implementación
public function get fontPosture():String public function set fontPosture(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de FontPosture
|
Elementos de API relacionados
fontSize | propiedad |
fontWeight | propiedad |
fontWeight:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Especifica el peso de la fuente con constantes definidas en la clase FontWeight.
El valor predeterminado es FontWeight.NORMAL.
Implementación
public function get fontWeight():String public function set fontWeight(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de FontWeight
|
Elementos de API relacionados
locale | propiedad |
locale:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Indica la configuración regional del texto. StageText utiliza los identificadores estándar de configuración regional. Por ejemplo "en", "en_US" y "en-US" se refieren a inglés y "ja" a japonés. Consulte la lista de códigos iso639-2 para obtener una lista de códigos de configuración regional.
El valor predeterminado es en.
Implementación
public function get locale():String public function set locale(value:String):void maxChars | propiedad |
maxChars:int| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Indica el número máximo de caracteres que los usuarios pueden introducir en el campo de texto. Un script puede insertar más texto del que se permite en maxChars. Si maxChars igual a cero, el usuario puede introducir una cantidad ilimitada de texto en el campo de texto.
El valor predeterminado es 0.
Implementación
public function get maxChars():int public function set maxChars(value:int):void multiline | propiedad |
multiline:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Indica si el objeto StageText puede visualizar más de una línea de texto. Sólo lectura. Este valor coincide con el de la propiedad multiline en el objeto StageTextInitOptions que se utiliza durante la construcción.
Implementación
public function get multiline():BooleanElementos de API relacionados
restrict | propiedad |
restrict:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Limita el conjunto de caracteres que los usuarios pueden introducir en el campo de texto. El sistema busca la cadena restrict de izquierda a derecha.
El valor de restrict especifica las siguientes reglas de restricción de texto entrada:
- Si el valor es
null, el usuario puede introducir cualquier carácter. - Si el valor es una cadena vacía, el usuario no puede ningún carácter.
- Si el valor es una cadena de caracteres, el usuario puede introducir sólo los caracteres de la cadena.
- Si el valor incluye un signo de intercalación (^), el usuario no puede introducir los caracteres que siguen la intercalación.
- El valor puede especificar un rango de caracteres de entrada permitidos mediante el carácter guión (-).
- El valor puede utilizar la secuencia de escape
\upara construir una cadenarestrict.
Caracteres especiales:
Utilice una barra invertida para introducir un carácter literal de símbolo de intercalación (^) o guión (-). Las secuencias con barras invertidas aceptadas son \-, \^ y \\. La barra invertida debe ser un carácter real de la cadena. Si quiere especificar una barra invertida en ActionScript, utilice un barra invertida doble.
Ejemplos de ajustes de la propiedad restrict:
El siguiente ejemplo permite que el usuario introduzca sólo los caracteres de guión (-) y símbolo de intercalación (^):
my_txt.restrict = "\\-\\^";
El siguiente ejemplo permite que el usuario introduzca sólo caracteres en mayúscula, espacios y números:
my_txt.restrict = "A-Z 0-9";
El siguiente ejemplo sólo excluye las minúsculas:
my_txt.restrict = "^a-z";
El siguiente ejemplo permite que el usuario introduzca sólo letras en mayúscula, pero excluye la letra Q mayúscula:
my_txt.restrict = "A-Z^Q";
El siguiente ejemplo permite que el usuario introduzca sólo los caracteres desde el ASCII 32 (espacio) al ASCII 126 (tilde).
my_txt.restrict = "\u0020-\u007E";
Nota: sólo se aplican restricciones a la entrada del usuario; un script puede insertar los caracteres en el campo de texto.
El valor predeterminado es null.
Implementación
public function get restrict():String public function set restrict(value:String):void returnKeyLabel | propiedad |
returnKeyLabel:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Indica la etiqueta de la tecla Retorno para dispositivos que disponen de teclado virtual. Los valores disponibles son constantes definidas en la clase ReturnKeyLabel:
- "default"
- "hecho"
- "ir"
- "next"
- "search"
Esta propiedad es solamente una sugerencia para la plataforma subyacente, ya que no todos los dispositivos y sistemas operativos admiten estos valores. Esta propiedad no afecta a los dispositivos que no disponen de teclado virtual.
El valor predeterminado es ReturnKeyLabel.DEFAULT.
Implementación
public function get returnKeyLabel():String public function set returnKeyLabel(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de ReturnKeyLabel
|
Elementos de API relacionados
selectionActiveIndex | propiedad |
selectionActiveIndex:int [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
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, este método devuelve el punto de inserción. Si la instancia StageText no es el foco de atención, este método devuelve -1.
En iOS, esta propiedad no se admite para objetos StageText no multilínea y devuelve -1.
Implementación
public function get selectionActiveIndex():intElementos de API relacionados
selectionAnchorIndex | propiedad |
selectionAnchorIndex:int [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
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, este método devuelve el punto de inserción. Si la instancia StageText no es el foco de atención, este método devuelve -1.
En iOS, esta propiedad no se admite para objetos StageText no multilínea y devuelve -1.
Implementación
public function get selectionAnchorIndex():intElementos de API relacionados
softKeyboardType | propiedad |
softKeyboardType:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Controla la apariencia del teclado virtual.
Los dispositivos con teclado virtual pueden personalizar los botones del teclado para que coincidan con el tipo de entrada esperado. Por ejemplo, si se esperan entradas numéricas, el dispositivo puede utilizar SoftKeyboardType.NUMBER para mostrar sólo números en el teclado virtual. Los valores válidos se definen como constantes en la clase SoftKeyboardType:
- "default"
- "puntuación"
- "url"
- "number"
- "contact"
- "correo electrónico"
- “phone”
- “decimalpad”
Estos valores sirven de sugerencia para que el dispositivo muestre el mejore teclado para cada operación.
El valor predeterminado es SoftKeyboardType.DEFAULT.
Implementación
public function get softKeyboardType():String public function set softKeyboardType(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de SoftKeyboardType
|
Elementos de API relacionados
stage | propiedad |
stage:Stage| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
El escenario en el que se visualiza el objeto StageText.
Establezca stage como null para ocultar este objeto StageText.
El valor predeterminado es null.
Implementación
public function get stage():Stage public function set stage(value:Stage):void text | propiedad |
text:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
El texto actual del campo de texto. El carácter de retorno de carro ('\r', ASCII 13) separa las líneas de texto. El texto incluido en esta propiedad no tiene formato (no tiene etiquetas de formato).
El valor predeterminado es null.
Implementación
public function get text():String public function set text(value:String):void textAlign | propiedad |
textAlign:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Indica la alineación del párrafo. Los valores válidos se definen como constantes en la clase TextFormatAlign:
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
No todas las plataformas admiten todos los valores de textAlign. En el caso de valores de textAlign no admitidos, las plataformas utilizan el valor predeterminado (TextFormatAlign.START).
El valor predeterminado es TextFormatAlign.START.
Implementación
public function get textAlign():String public function set textAlign(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de TextFormatAlign
|
Elementos de API relacionados
viewPort | propiedad |
viewPort:Rectangle| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
El área del escenario en la que se visualiza el objeto StageText. El valor predeterminado es rect cero.
Implementación
public function get viewPort():Rectangle public function set viewPort(value:Rectangle):voidEmite
RangeError — El valor de Rectangle no es válido.
|
visible | propiedad |
StageText | () | Información sobre |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Crea un objeto StageText.
El objeto StageText es invisible hasta que se asocia a un escenario o se define correctamente la propiedad viewPort.
initOptions:flash.text:StageTextInitOptions (default = null) |
assignFocus | () | método |
public function assignFocus():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Asigna la selección al objeto StageText. En objetos no editables, assignFocus() no hace nada.
dispose | () | método |
public function dispose():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se deshace de este objeto StageText.
Llamar a dispose() es opcional. Si no conserva una referencia a esta instancia de StageText, será apta para eliminación de datos innecesarios. Llamar a dispose() puede hacer que la recolección de elementos no utilizados se produzca antes o en un momento más adecuado.
drawViewPortToBitmapData | () | método |
public function drawViewPortToBitmapData(bitmap:BitmapData):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3.0 |
Dibuja el puerto de la vista de StageText en un mapa de bits.
Capture el mapa de bits y ajuste el escenario en null para mostrar el contenido por encima del objeto StageText.
El mapa de bits tiene normalmente la misma anchura y altura que el visor. Desde AIR 15.0, cuando el reproductor se encuentra en pantallas con alta resolución de PPP, la anchura y altura del mapa de bits pueden ser contentsScaleFactor veces la anchura y altura del visor. Por ejemplo, en una pantalla Mac Retina,contentsScaleFactor es 2 porque la resolución en píxeles del escenario se duplica, por lo que el mapa de bits puede ser dos veces mayor que el visor.
Si llama a este método antes de llamar al evento Event.COMPLETE, el método podría dibujar la vista incorrectamente.
Parámetros
bitmap:BitmapData — El objeto BitmapData en el que se dibuja la parte visible del puerto de la vista de StageText.
|
Emite
ArgumentError — La anchura y la altura del mapa de bits es diferente de la del puerto de la vista.
| |
Error — El mapa de bits tiene el valor null.
|
selectRange | () | método |
public function selectRange(anchorIndex:int, activeIndex:int):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Selecciona el texto especificado por los valores de índice de los caracteres primero y último. Especifique el primer y el último carácter de la selección en los parámetros anchorIndex y activeIndex. Si los dos valores de parámetro son los mismos, este método establece el punto de inserción.
En iOS, en el caso de objetos StageText no multilínea, esta función no es compatible y siempre devuelve -1. Si llama a este método seleccionando la cadena de texto completa, la selección es visible. Pero si lo hace seleccionando parte de la cadena de texto, la selección no es visible.
Para algunos dispositivos o sistemas operativos, la selección sólo puede ser visible cuando el objeto StageText está seleccionado
Parámetros
anchorIndex:int — El valor de índice basado en cero del primer carácter de la selección (el primer carácter del índice del valor es 0).
| |
activeIndex:int — El valor de índice basado en cero del último carácter de la selección.
|
Elementos de API relacionados
change | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.CHANGE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye una vez modificado el contenido del texto. Este evento se puede distribuir en cada cambio, o esperar hasta que se haya completado un conjunto de cambios.
La constanteEvent.CHANGE define el valor de la propiedad type de un objeto de evento change.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto al que se ha modificado su valor. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
complete | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.COMPLETE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye después de configurar un escenario con valor no null y un objeto viewPort no vacío. Indica que la aplicación ha terminado con el objeto StageText y ahora es posible llamar al método drawViewPortToBitmapData. En función de la plataforma, este evento puede enviarse forma sincrónica o asíncrona con la configuración de stage, de viewPort o de ambos.
Event.COMPLETE define el valor de la propiedad type de un objeto de evento complete.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto de red que ha terminado de cargarse. |
focusIn | Evento |
flash.events.FocusEventpropiedad FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye cuando el usuario está editando texto y el control tiene la selección del teclado.
Define el valor de la propiedadtype de un objeto de evento focusIn.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | 0; se aplica sólo a eventos keyFocusChange. |
relatedObject | La instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. |
shiftKey | false; se aplica sólo a eventos keyFocusChange. |
target | La instancia InteractiveObject que acaba de seleccionarse. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente.
|
direction | Dirección desde la que se asigna la selección. Esta propiedad informa sobre el valor del parámetro direction del método assignFocus() del escenario. Si la selección cambia por otro medio, el valor siempre es FocusDirection.NONE. Se aplica únicamente a eventos focusIn. Para todos los demás eventos de selección, el valor es FocusDirection.NONE. |
focusOut | Evento |
flash.events.FocusEventpropiedad FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye cuando el usuario deja de editar texto y el control deja de tener la selección del teclado.
Define el valor de la propiedadtype de un objeto de evento focusOut.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | 0; se aplica sólo a eventos keyFocusChange. |
relatedObject | La instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. |
shiftKey | false; se aplica sólo a eventos keyFocusChange. |
target | La instancia InteractiveObject que acaba de perder la selección. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente.
|
keyDown | Evento |
flash.events.KeyboardEventpropiedad KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye cuando el usuario pulsa una tecla.
Las asignaciones entre teclas y caracteres especiales varía en función del dispositivo y el sistema operativo. Este tipo de evento se genera después de que se produzca dicha asignación, pero antes del procesamiento de un editor de método de entrada (IME). Los IME son útiles para introducir caracteres que el teclado QWERTY estándar está mal equipado para producir (por ejemplo, ideogramas chinos).
Este evento tiene lugar antes que el evento keyUp.
Este evento no se distribuye para todas las teclas. Las teclas que provocan la distribución de este evento varían según la plataforma.
En AIR, cancelar este evento impide que se puedan introducir caracteres en un campo de texto.
La constanteKeyboardEvent.KEY_DOWN define el valor de la propiedad type de un objeto de evento keyDown.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | true en AIR, false en Flash Player; en AIR, cancelar este evento impide que se puedan introducir caracteres en un campo de texto. |
charCode | El valor de código de carácter de la tecla presionada o soltada. |
commandKey | true en Mac si la tecla Comando está activa. En caso contrario, false |
controlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac si la tecla Control está activa. En caso contrario, false |
ctrlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | El valor de código de tecla de la tecla presionada o soltada. |
keyLocation | La ubicación de la tecla en el teclado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia InteractiveObject que está seleccionada. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
keyUp | Evento |
flash.events.KeyboardEventpropiedad KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye cuando el usuario suelta una tecla.
Las asignaciones entre teclas y caracteres especiales varía en función del dispositivo y el sistema operativo. Este tipo de evento se genera después de que se produzca dicha asignación, pero antes del procesamiento de un editor de método de entrada (IME). Los IME son útiles para introducir caracteres que el teclado QWERTY estándar está mal equipado para producir (por ejemplo, ideogramas chinos).
Este evento se produce después un evento keyDown.
Este evento no se distribuye para todas las teclas. Las teclas que provocan la distribución de este evento varían según la plataforma.
La constanteKeyboardEvent.KEY_UP define el valor de la propiedad type de un objeto de evento keyUp.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
charCode | Contiene el valor de código de carácter de la tecla presionada o soltada. |
commandKey | true en Mac si la tecla Comando está activa. En caso contrario, false |
controlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac si la tecla Control está activa. En caso contrario, false |
ctrlKey | true en Windows, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | El valor de código de tecla de la tecla presionada o soltada. |
keyLocation | La ubicación de la tecla en el teclado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia InteractiveObject que está seleccionada. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
softKeyboardActivate | Evento |
flash.events.SoftKeyboardEventpropiedad SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye después de activar el teclado virtual, cuando el objeto StageText adquiere la selección.
La constanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE define el valor de la propiedad type del objeto SoftKeyboardEvent cuando aparece un teclado en pantalla. Para este evento, cancellable = false.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
relatedObjectVal | Referencia a un objeto de la lista de visualización relacionado con el evento. |
triggerTypeVal | Indica si el evento de teclado lo ha activado una aplicación o el usuario. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
softKeyboardActivating | Evento |
flash.events.SoftKeyboardEventpropiedad SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye antes de activar el teclado virtual, cuando el objeto StageText adquiere la selección.
La constanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING define el valor de la propiedad type del objeto SoftKeyboardEvent inmediatamente después de aparecer el teclado en pantalla. Para este evento, cancellable = true.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true a no ser que el evento lo distribuya un objeto StageText. En el caso de objetos StageText, el evento no se puede cancelar. |
relatedObjectVal | Referencia a un objeto de la lista de visualización relacionado con el evento. |
triggerTypeVal | Indica si el evento de teclado lo ha activado una aplicación o el usuario. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
softKeyboardDeactivate | Evento |
flash.events.SoftKeyboardEventpropiedad SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye después de desactivar el teclado virtual, cuando el objeto StageText pierde la selección.
La constanteSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE define el valor de la propiedad type del objeto SoftKeyboardEvent cuando el teclado en pantalla baja o se oculta. Para este evento, cancellable = false.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
relatedObjectVal | Referencia a un objeto de la lista de visualización relacionado con el evento. |
triggerTypeVal | Indica si el evento de teclado lo ha activado una aplicación o el usuario. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
Tue Jun 12 2018, 02:12 PM Z