IME - Referencia de la API de Adobe ActionScript® 3 (AS3 )

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

La clase IME permite manipular directamente el editor de método de entrada (IME) del sistema operativo en la aplicación del motor de ejecución de Flash que se ejecuta en un equipo cliente. Puede determinar si un IME está instalado o activado y qué IME se encuentra activado actualmente. Puede activar o desactivar el IME en la aplicación y realizar otras funciones limitadas, según el sistema operativo.

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:

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.

Propiedades públicas

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étodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	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
		compositionAbandoned():void [estática] Hace que el motor de ejecución abandone cualquier composición que esté en curso.	IME
		compositionSelectionChanged(start:int, end:int):void [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
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		doConversion():void [estática] Indica al IME que seleccione el primer candidato de la cadena de composición actual.	IME
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		setCompositionString(composition:String):void [estática] Establece la cadena de composición del IME.	IME
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean 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

Eventos

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Resumen	Definido por
activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher
imeComposition	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

Información sobre propiedades

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_FULL
ALPHANUMERIC_HALF
CHINESE
JAPANESE_HIRAGANA
JAPANESE_KATAKANA_FULL
JAPANESE_KATAKANA_HALF
KOREAN
UNKNOWN (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):void

Emite

Error — El intento de establecimiento no se realizó correctamente.

Elementos de API relacionados

flash.system.IMEConversionMode.ALPHANUMERIC_FULL
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):void

Emite

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():Boolean

Información sobre métodos

compositionAbandoned

()

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

public static function doConversion():void

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9

Indica al IME que seleccione el primer candidato de la cadena de composición actual.

Emite

Error — La llamada no se realizó correctamente.

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.

Información sobre eventos

imeComposition

Evento

Tipo de objeto de evento: flash.events.IMEEvent
propiedad 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 propiedad type 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.

Avisos legales | Política de privacidad en línea

IME - AS3

Paquetesx

Elementos del lenguaje

Apéndices

Paquete flash.system

conversionMode

enabled

isSupported

compositionAbandoned

compositionSelectionChanged

doConversion

setCompositionString

imeComposition