| Paquete | flash.system |
| Clase | public final class IME |
| Herencia | IME  EventDispatcher Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Compatibilidad con perfil de AIR: esta característica se admite en todos los sistemas operativos de escritorio, pero no en dispositivos móviles. Tampoco se admite en dispositivos de AIR para TV. Puede probar la compatibilidad en tiempo de ejecución con la propiedad IME.isSupported. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
Los IME permiten a los usuarios introducir caracteres de texto no ASCII en idiomas multibyte como, por ejemplo, chino, japonés o coreano. Para más información sobre los IME, consulte la documentación del sistema operativo para el que desarrolla las aplicaciones. Para obtener recursos adicionales, consulte los siguientes sitios web:
- http://www.microsoft.com/globaldev/default.mspx
- http://developer.apple.com/documentation/
- http://java.sun.com
Si un IME no está activo en el ordenador del usuario, fallarán todas las llamadas a los métodos o propiedades IME que no sean Capabilities.hasIME. Tras activar manualmente un IME, las siguientes llamadas ActionScript a métodos y propiedades IME funcionarán como se esperaba. Por ejemplo, si utiliza un IME japonés, debe estar activado antes de llamar a cualquier método o propiedad IME.
La tabla siguiente muestra la cobertura de plataforma para esta clase:
| Función | Windows | Mac OSX | Linux |
|---|---|---|---|
Determinar si el IME está instalado: Capabilities.hasIME
| Sí | Sí | Sí |
Activar o desactivar IME: IME.enabled
| Sí | Sí | Sí |
Averiguar si el IME está activado o desactivado: IME.enabled
| Sí | Sí | Sí |
Obtener o establecer el modo de conversión IME: IME.conversionMode
| Sí | Sí ** | No |
Enviar al IME la cadena que se va a convertir: IME.setCompositionString()
| Sí * | No | No |
Obtener del IME la cadena original antes de la conversión: System.ime.addEventListener()
| Sí * | No | No |
Enviar petición para convertir al IME: IME.doConversion()
| Sí * | No | No |
* No todos los IME de Windows admiten todas estas operaciones. El único IME que las admite todas es el japonés.
** En Macintosh, sólo el IME japonés admite estos métodos. Los IME de terceros no son compatibles.
La versión ActionScript 3.0 de esta clase no admite Macintosh Classic.
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| conversionMode : String [estática]
Modo de conversión del IME actual. | IME | ||
| enabled : Boolean [estática]
Indica si el IME del sistema está activado (true) o desactivado (false). | IME | ||
| isSupported : Boolean [estática] [solo lectura]
La propiedad isSupported se establece en true si la clase IME está disponible en la plataforma actual; en caso contrario, se establece en false. | IME | ||
| 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. | EventDispatcher | |
[estática]
Hace que el motor de ejecución abandone cualquier composición que esté en curso. | IME | ||
[estática]
Llame a este método cuando la selección dentro de la composición se haya actualizado, o bien interactivamente o mediante programación. | IME | ||
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
[estática]
Indica al IME que seleccione el primer candidato de la cadena de composición actual. | IME | ||
|
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 | |
[estática]
Establece la cadena de composición del IME. | IME | ||
|
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 | ||
| [evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | ||
| Se distribuye cuando el usuario ha finalizado la composición del editor de método de entrada (IME) y la cadena de lectura está disponible. | IME | |||
conversionMode | propiedad |
conversionMode:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Modo de conversión del IME actual. Los valores posibles son constantes de cadena de modo del IME que indican el modo de conversión:
ALPHANUMERIC_FULLALPHANUMERIC_HALFCHINESEJAPANESE_HIRAGANAJAPANESE_KATAKANA_FULLJAPANESE_KATAKANA_HALFKOREANUNKNOWN(valor de sólo lectura; este valor no se puede definir)
Implementación
public static function get conversionMode():String public static function set conversionMode(value:String):voidEmite
Error — El intento de establecimiento no se realizó correctamente.
|
Elementos de API relacionados
flash.system.IMEConversionMode.ALPHANUMERIC_HALF
flash.system.IMEConversionMode.CHINESE
flash.system.IMEConversionMode.JAPANESE_HIRAGANA
flash.system.IMEConversionMode.JAPANESE_KATAKANA_FULL
flash.system.IMEConversionMode.JAPANESE_KATAKANA_HALF
flash.system.IMEConversionMode.KOREAN
flash.system.IMEConversionMode.UNKNOWN
enabled | propiedad |
enabled:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Indica si el IME del sistema está activado (true) o desactivado (false). Un IME activado realiza entrada multibyte; un IME desactivado realiza entrada alfanumérica.
Implementación
public static function get enabled():Boolean public static function set enabled(value:Boolean):voidEmite
Error — El intento de establecimiento no se realizó correctamente.
|
isSupported | propiedad |
isSupported:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
La propiedad isSupported se establece en true si la clase IME está disponible en la plataforma actual; en caso contrario, se establece en false.
Implementación
public static function get isSupported():BooleancompositionAbandoned | () | método |
public static function compositionAbandoned():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Hace que el motor de ejecución abandone cualquier composición que esté en curso. Llame a este método cuando el usuario haga clic fuera del área composición o cuando el objeto interactivo que está seleccionado se destruya o se restaure. El motor de ejecución confirma la composición llamando a confirmComposition() en el cliente. El motor de ejecución también restablece el IME para informar al sistema operativo de que la composición se ha abandonado.
compositionSelectionChanged | () | método |
public static function compositionSelectionChanged(start:int, end:int):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Llame a este método cuando la selección dentro de la composición se haya actualizado, o bien interactivamente o mediante programación.
Parámetros
start:int — Especifica el desplazamiento en bytes del comienzo de la selección.
| |
end:int — Especifica el desplazamiento en bytes del final de la selección.
|
doConversion | () | método |
setCompositionString | () | método |
public static function setCompositionString(composition:String):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Establece la cadena de composición del IME. Una vez establecida, el usuario puede seleccionar candidatos del IME antes de enviar el resultado al campo de texto seleccionado actualmente.
Si no hay seleccionado ningún campo de texto, se produce un error en el método y se emite un error.
Parámetros
composition:String — Cadena a la que se envía el IME.
|
Emite
Error — La llamada no se ha realizado correctamente.
|
imeComposition | Evento |
flash.events.IMEEventpropiedad IMEEvent.type =
flash.events.IMEEvent.IME_COMPOSITION| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Se distribuye cuando el usuario ha finalizado la composición del editor de método de entrada (IME) y la cadena de lectura está disponible. Los IME suelen utilizarse para introducir texto de idiomas con ideogramas en lugar de caracteres, como es el caso del japonés, chino y coreano.
Define el valor de la propiedadtype de un objeto de evento imeComposition.
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 | El objeto IME. |
Tue Jun 12 2018, 02:12 PM Z