flash.system.IME (ActionScript 3.0)

Paquete	flash.system
Clase	public final class IME
Herencia	IME EventDispatcher Object

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9

La clase IME permite manipular directamente el editor de método de entrada (IME) del sistema operativo en la aplicación Flash Player 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 Flash Player y realizar otras funciones limitadas, según el sistema operativo.

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
Determinar si el IME está instalado: `Capabilities.hasIME`	Sí	Sí
Activar o desactivar IME: `IME.enabled`	Sí	Sí
Averiguar si el IME está activado o desactivado: `IME.enabled`	Sí	Sí
Obtener o establecer el modo de conversión IME: `IME.conversionMode`	Sí	Sí **
Enviar al IME la cadena que se va a convertir: `IME.setCompositionString()`	Sí *	No
Obtener del IME la cadena original antes de la conversión: `System.ime.addEventListener()`	Sí *	No
Enviar solicitud para convertir al IME: `IME.doConversion()`	Sí *	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.

Véase también

Utilización de la clase IME

	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 [static] Modo de conversión del IME actual.	IME
		enabled : Boolean [static] Indica si el IME del sistema está activado (true) o desactivado (false).	IME
		prototype : Object [static] Una referencia al objeto prototipo de una clase u objeto de función.	Object

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
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		doConversion():void [static] 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 [static] 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
		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

Resumen	Definido por
activate	Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo.	EventDispatcher
deactivate	Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo.	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 [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

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 function set conversionMode(value:String):void

Emite

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

Véase también

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
Utilización de la clase IME

enabled

propiedad

enabled:Boolean [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

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 function set enabled(value:Boolean):void

Emite

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

Véase también

Utilización de la clase IME

Información sobre métodos

doConversion

()

método

public static function doConversion():void

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

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

Versión del reproductor:

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
IMEEvent.type property = flash.events.IMEEvent.IME_COMPOSITION

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

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`	El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto IME.

Véase también

Utilización de la clase IME

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/system/IME.html

Referencia del lenguaje y componentes ActionScript 3.0		Todos los paquetes \| Todas las clases \| Elementos del lenguaje \| Índice \| Apéndices \| Convenciones \| Marcos Quitar marcos
IME	Propiedades \| Métodos \| Eventos