| Package | flash.system |
| Classe | public final class IME |
| Héritage | IME  EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur les systèmes d’exploitation de bureau, mais ne l’est pas sur tous les périphériques mobiles. Elle est également prise en charge sur les périphériques AIR pour TV. Vous pouvez tester la prise en charge lors de l’exécution à l’aide de la propriété IME.isSupported. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.
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, voir la documentation du système d’exploitation pour lequel vous développez des applications. Les sites Web suivants comportent des ressources supplémentaires :
- http://www.microsoft.com/globaldev/default.mspx
- http://developer.apple.com/documentation/
- http://java.sun.com
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 OSX | Linux |
|---|---|---|---|
Détermine si l’IME est installé : Capabilities.hasIME
| Oui | Oui | Oui |
Active ou désactive l’IME : IME.enabled
| Oui | Oui | Oui |
Détermine si l’IME est activé ou désactivé : IME.enabled
| Oui | Oui | Oui |
Lit ou définit le mode de conversion IME : IME.conversionMode
| Oui | Oui ** | Non |
Transmet à l’IME la chaîne à convertir : IME.setCompositionString()
| Oui * | Non | Non |
Lit dans l’IME la chaîne d’origine avant sa conversion : System.ime.addEventListener()
| Oui * | Non | Non |
Transmet la requête de conversion à IME : IME.doConversion()
| Oui * | Non | 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.
Plus d’exemples
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| 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 [statique]
Mode de conversion de l’IME actuel. | IME | ||
| enabled : Boolean [statique]
Spécifie si l’IME système est activé (true) ou désactivé (false). | IME | ||
| isSupported : Boolean [statique] [lecture seule]
La propriété isSupported est définie sur true si la classe IME est prise en charge sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur false. | IME | ||
| 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 | |
[statique]
Force le moteur d’exécution à abandonner toute composition en cours. | IME | ||
[statique]
Appelez cette méthode lorsque la sélection au sein de la composition a été mise à jour, soit interactivement soit par programmation. | IME | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
[statique]
Demande à l’IME de sélectionner le premier candidat pour la chaîne de composition actuelle. | IME | ||
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
[statique]
Définit la chaîne de composition IME. | IME | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
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 | |
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsqu’un utilisateur a terminé une composition IME et la chaîne de lecture est disponible. | IME | |||
conversionMode | propriété |
conversionMode:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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_FULLALPHANUMERIC_HALFCHINESEJAPANESE_HIRAGANAJAPANESE_KATAKANA_FULLJAPANESE_KATAKANA_HALFKOREANUNKNOWN(valeur en lecture seule, ne peut pas être définie)
Implémentation
public static function get conversionMode():String public static function set conversionMode(value:String):voidValeur émise
Error — Une tentative de définition a échoué.
|
Plus d’exemples
Eléments de l’API associés
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 | propriété |
enabled:Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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 static function set enabled(value:Boolean):voidValeur émise
Error — Une tentative de définition a échoué.
|
Plus d’exemples
isSupported | propriété |
isSupported:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
La propriété isSupported est définie sur true si la classe IME est prise en charge sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur false.
Implémentation
public static function get isSupported():BooleancompositionAbandoned | () | méthode |
public static function compositionAbandoned():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Force le moteur d’exécution à abandonner toute composition en cours. Appelez cette méthode lorsque l’utilisateur clique en dehors de la zone de composition, ou lorsque l’objet interactif qui a le focus est en cours de destruction ou de réinitialisation. Le moteur d’exécution valide la composition en appelant la méthode confirmComposition() dans le client. Par ailleurs, le moteur d’exécution réinitialise l’IME pour informer le système d’exploitation que la composition a été abandonnée.
compositionSelectionChanged | () | méthode |
public static function compositionSelectionChanged(start:int, end:int):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Appelez cette méthode lorsque la sélection au sein de la composition a été mise à jour, soit interactivement soit par programmation.
Paramètres
start:int — Spécifie le décalage du début de la sélection, en octets.
| |
end:int — Spécifie le décalage de la fin de la sélection, en octets.
|
doConversion | () | méthode |
setCompositionString | () | méthode |
public static function setCompositionString(composition:String):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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.
|
Valeur émise
Error — L’appel n’a pas réussi.
|
imeComposition | Evénement |
flash.events.IMEEventpropriété IMEEvent.type =
flash.events.IMEEvent.IME_COMPOSITION| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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. |
Plus d’exemples
Tue Jun 12 2018, 09:30 AM Z