flash.system.IME (ActionScript 3.0)

Package	flash.system
Classe	public final class IME
Héritage	IME EventDispatcher Object

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9

La classe IME permet de manipuler directement l'IME (Input Method Editor) du système d'exploitation sous lequel l'application Flash Player s'exécute sur l'ordinateur client. Vous pouvez déterminer si un IME est installé, qu'il soit activé ou non, et quel IME est activé. Vous pouvez désactiver ou activer l'IME dans l'application Flash Player et exécuter d'autres fonctions limitées, selon votre système d'exploitation.

Les IME permettent aux utilisateurs de taper des caractères de texte non ASCII multioctet pour les langues orientales, tels que le Chinois, le Japonais et le Coréen. Pour plus d'informations sur la manipulation des IME, consultez la documentation du système d'exploitation pour lequel vous développez des applications. Les sites Web suivants comportent des ressources supplémentaires :

Si aucun IME n'est actif sur l'ordinateur de l'utilisateur, tout appel aux méthodes ou propriétés IME, autres que Capabilities.hasIME, échoue. Lorsque vous activez manuellement un IME, les appels ActionScript suivants aux méthodes et aux propriétés IME fonctionnent comme prévu. Par exemple, si vous utilisez un IME japonais, ce dernier doit être activé avant tout appel à la méthode ou la propriété IME.

Le tableau ci-après indique les plates-formes prises en charge par cette classe :

Fonction	Windows	Mac Système X
Détermine si l'IME est installé : `Capabilities.hasIME`	Oui	Oui
Active ou désactive l'IME : `IME.enabled`	Oui	Oui
Détermine si l'IME est activé ou désactivé : `IME.enabled`	Oui	Oui
Lit ou définit le mode de conversion IME : `IME.conversionMode`	Oui	Oui **
Transmet à l'IME la chaîne à convertir : `IME.setCompositionString()`	Oui *	Non
Lit dans l'IME la chaîne d'origine avant sa conversion : `System.ime.addEventListener()`	Oui *	Non
Transmet la requête de conversion à IME : `IME.doConversion()`	Oui *	Non

* Ces opérations ne sont pas toutes prises en charge par tous les IME de Windows. Seul l'IME japonais les prend toutes en charge.

** Sur le Macintosh, seul l'IME japonais prend en charge ces méthodes. Les IME d'éditeurs tiers ne les prennent pas en charge.

La version ActionScript 3.0 de cette classe ne prend pas Macintosh Classic en charge.

Voir aussi

Utilisation de la classe IME

	Propriété	Défini par
		constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.	Object
		conversionMode : String [static] Mode de conversion de l’IME actuel.	IME
		enabled : Boolean [static] Spécifie si l'IME système est activé (true) ou désactivé (false).	IME
		prototype : Object [static] Référence à l’objet prototype d’un objet de classe ou fonction.	Object

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		doConversion():void [static] Demande à l'IME de sélectionner le premier candidat pour la chaîne de composition actuelle.	IME
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d'un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		setCompositionString(composition:String):void [static] Définit la chaîne de composition IME.	IME
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l'objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l'objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher

Synthèse	Défini par
activate	Distribué lorsque Flash Player a le focus du système d’exploitation et devient actif.	EventDispatcher
deactivate	Distribué lorsque Flash Player perd le focus du système d’exploitation et devient inactif.	EventDispatcher
imeComposition	Distribué lorsqu'un utilisateur a terminé une composition IME et la chaîne de lecture est disponible.	IME

Détails des propriétés

conversionMode

propriété

conversionMode:String [lecture-écriture]

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9

Mode de conversion de l’IME actuel. Les valeurs possibles sont les constantes de chaîne de mode IME qui spécifient le mode de conversion :

ALPHANUMERIC_FULL
ALPHANUMERIC_HALF
CHINESE
JAPANESE_HIRAGANA
JAPANESE_KATAKANA_FULL
JAPANESE_KATAKANA_HALF
KOREAN
UNKNOWN (valeur en lecture seule, ne peut pas être définie)

Implémentation
public static function get conversionMode():String
public function set conversionMode(value:String):void

Lance

Error — Une tentative de définition a échoué.

Voir aussi

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
Utilisation de la classe IME

enabled

propriété

enabled:Boolean [lecture-écriture]

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9

Spécifie si l'IME système est activé (true) ou désactivé (false). Un IME activé effectue une entrée multi-octets ; un IME désactivé effectue une entrée alphanumérique.

Implémentation
public static function get enabled():Boolean
public function set enabled(value:Boolean):void

Lance

Error — Une tentative de définition a échoué.

Voir aussi

Utilisation de la classe IME

Détails des méthodes

doConversion

()

méthode

public static function doConversion():void

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9

Demande à l'IME de sélectionner le premier candidat pour la chaîne de composition actuelle.

Lance

Error — L'appel n'a pas réussi.

setCompositionString

()

méthode

public static function setCompositionString(composition:String):void

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9

Définit la chaîne de composition IME. Lorsque cette chaîne est définie, l'utilisateur peut sélectionner des candidats IME avant d'enregistrer le résultat dans le champ de texte ayant actuellement le focus.

Si aucun texte n'a le focus, cette méthode échoue et renvoie une erreur.

Paramètres

composition:String — La chaîne à envoyer à l'IME.

Lance

Error — L'appel n'a pas réussi.

Détails des événements

imeComposition

Evénement

Type d'objet événement: flash.events.IMEEvent
IMEEvent.type property = flash.events.IMEEvent.IME_COMPOSITION

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9

Distribué lorsqu'un utilisateur a terminé une composition IME et la chaîne de lecture est disponible. Les IME sont généralement utilisées pour saisir du texte exprimé sous forme d'idéogrammes et non pas de lettres, comme pare exemple le Japonais, le Chinois et le Coréen.

Définit la valeur de la propriété type d'un objet événement imeComposition.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	L’objet IME.

Voir aussi

Utilisation de la classe IME

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/system/IME.html

Guide de référence du langage et des composants ActionScript 3.0		Tous les packages \| Toutes les classes \| Eléments du langage \| Index \| Annexes \| Conventions \| Cadres Aucune image
IME	Propriétés \| Méthodes \| Evénements