| Paket | flash.system |
| Klasse | public final class IME |
| Vererbung | IME  EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Unterstützung von AIR-Profilen: Diese Funktion wird unter Desktopbetriebssystemen unterstützt, aber nicht auf allen mobilen Geräten. Bei Geräten mit AIR für TV wird sie ebenfalls nicht unterstützt. Mit der IME.isSupported-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Benutzer können mithilfe von Eingabemethoden-Editoren ASCII-fremde Textzeichen in Multibyte-Sprachen wie Chinesisch, Japanisch oder Koreanisch eingeben. Weitere Informationen zur Verwendung von Eingabemethoden-Editoren finden Sie in der Dokumentation des Betriebssystems, für das Sie Anwendungen entwickeln. Weitere Ressourcen finden Sie auf den folgenden Websites:
- http://www.microsoft.com/globaldev/default.mspx
- http://developer.apple.com/documentation/
- http://java.sun.com
Wenn ein IME auf dem Computer des Benutzers deaktiviert ist, treten mit Ausnahme von Capabilities.hasIME beim Aufrufen von IME-Methoden oder IME-Eigenschaften Fehler auf. Nach dem Aktivieren eines IME werden ActionScript-Aufrufe von IME-Methoden und IME-Eigenschaften wie erwartet durchgeführt. Wenn Sie beispielsweise einen IME für Japanisch verwenden, muss dieser aktiviert werden, bevor IME-Methoden oder IME-Eigenschaften aufgerufen werden können.
In der folgenden Tabelle sind die Plattformen aufgeführt, auf denen diese Klasse unterstützt wird:
| Funktion | Windows | Mac OS X | Linux |
|---|---|---|---|
Feststellen, ob ein IME installiert ist Capabilities.hasIME
| Ja | Ja | Ja |
IME aktivieren/deaktivieren IME.enabled
| Ja | Ja | Ja |
Feststellen, ob der IME aktiviert bzw. deaktiviert ist IME.enabled
| Ja | Ja | Ja |
Abrufen oder Festlegen des IME-Konvertierungsmodus IME.conversionMode
| Ja | Ja ** | Nein |
Zu konvertierenden String an IME senden IME.setCompositionString()
| Ja * | Nein | Nein |
Den Originalstring vor der Konvertierung vom IME abrufen System.ime.addEventListener()
| Ja * | Nein | Nein |
Anforderung für die Konvertierung an IME senden IME.doConversion()
| Ja * | Nein | Nein |
* Diese Vorgänge werden nicht in allen Windows-IMEs unterstützt. Der einzige IME, der alle Vorgänge unterstützt, ist der IME für Japanisch.
** Auf Macintosh-Systemen werden diese Methoden nur im IME für Japanisch unterstützt, bei IMEs von Drittanbietern werden sie dagegen nicht unterstützt.
Die ActionScript 3.0-Version dieser Klasse unterstützt nicht Macintosh Classic.
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| conversionMode : String [statisch]
Der Konvertierungsmodus des aktuellen IME. | IME | ||
| enabled : Boolean [statisch]
Gibt an, ob der System-IME aktiviert (true) oder deaktiviert (false) ist. | IME | ||
| isSupported : Boolean [statisch] [schreibgeschützt]
Die isSupported-Eigenschaft hat den Wert „true“, wenn die IME-Klasse auf der aktuellen Plattform verfügbar ist, andernfalls hat sie den Wert „false“. | IME | ||
| Methode | Definiert von | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
[statisch]
Veranlasst die Laufzeitumgebung, alle Satzvorgänge („Composition“), die zurzeit ausgeführt werden, abzubrechen. | IME | ||
[statisch]
Rufen Sie diese Methode auf, wenn die Auswahl innerhalb des Satzes entweder interaktiv oder programmgesteuert aktualisiert wurde. | IME | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
[statisch]
Weist den IME an, den ersten Kandidaten für den aktuellen Eingabestring auszuwählen. | IME | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
[statisch]
Legt den IME-Eingabestring fest. | IME | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn ein Benutzer die Eingabe in einem Eingabemethoden-Editor (IME) abgeschlossen hat und der Lesestring verfügbar ist. | IME | |||
conversionMode | Eigenschaft |
conversionMode:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Konvertierungsmodus des aktuellen IME. Mögliche Werte sind folgende IME-Modusstringkonstanten, die den Konvertierungsmodus angeben:
ALPHANUMERIC_FULLALPHANUMERIC_HALFCHINESEJAPANESE_HIRAGANAJAPANESE_KATAKANA_FULLJAPANESE_KATAKANA_HALFKOREANUNKNOWN(schreibgeschützter Wert, der nicht festgelegt werden kann)
Implementierung
public static function get conversionMode():String public static function set conversionMode(value:String):voidAuslöser
Error — Eine Festlegung wurde nicht erfolgreich ausgeführt.
|
Verwandte API-Elemente
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 | Eigenschaft |
enabled:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt an, ob der System-IME aktiviert (true) oder deaktiviert (false) ist. Ein aktivierter IME führt Multibyte-Eingaben durch, ein deaktivierter IME führt alphanumerische Eingaben durch.
Implementierung
public static function get enabled():Boolean public static function set enabled(value:Boolean):voidAuslöser
Error — Eine Festlegung wurde nicht erfolgreich ausgeführt.
|
isSupported | Eigenschaft |
isSupported:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Die isSupported-Eigenschaft hat den Wert true, wenn die IME-Klasse auf der aktuellen Plattform verfügbar ist, andernfalls hat sie den Wert false.
Implementierung
public static function get isSupported():BooleancompositionAbandoned | () | Methode |
public static function compositionAbandoned():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Veranlasst die Laufzeitumgebung, alle Satzvorgänge („Composition“), die zurzeit ausgeführt werden, abzubrechen. Rufen Sie diese Methode auf, wenn der Benutzer auf eine Stelle außerhalb des Satzbereichs klickt oder wenn das interaktive Objekt, das en Fokus hat, gelöscht oder zurückgesetzt wird. Die Laufzeitumgebung bestätigt den Satz, indem sie im Client confirmComposition() aufruft. Die Laufzeitumgebung setzt auch den IME zurück, um das Betriebssystem darüber zu informieren, dass der Satz abgebrochen wurde.
compositionSelectionChanged | () | Methode |
public static function compositionSelectionChanged(start:int, end:int):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Rufen Sie diese Methode auf, wenn die Auswahl innerhalb des Satzes entweder interaktiv oder programmgesteuert aktualisiert wurde.
Parameter
start:int — Legt in Bytes den Offset zum Anfang der Auswahl fest.
| |
end:int — Legt in Bytes den Offset zum Ende der Auswahl fest.
|
doConversion | () | Methode |
setCompositionString | () | Methode |
public static function setCompositionString(composition:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Legt den IME-Eingabestring fest. Wenn dieser String festgelegt ist, kann der Benutzer die IME-Kandidaten auswählen, bevor das Ergebnis an das Textfeld mit dem aktuellen Eingabefokus übergeben wird.
Wenn kein Textfeld mit Fokus vorhanden ist, schlägt die Methode fehl, und ein Fehler wird ausgegeben.
Parameter
composition:String — Der an den IME zu sendende String.
|
Auslöser
Error — Der Aufruf ist nicht erfolgreich.
|
imeComposition | Ereignis |
flash.events.IMEEventEigenschaft IMEEvent.type =
flash.events.IMEEvent.IME_COMPOSITION| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Wird ausgelöst, wenn ein Benutzer die Eingabe in einem Eingabemethoden-Editor (IME) abgeschlossen hat und der Lesestring verfügbar ist. IMEs werden in der Regel zur Eingabe von Text für Sprachen mit Ideogrammen anstelle von Buchstaben verwendet, beispielsweise Japanisch, Chinesisch und Koreanisch.
Definiert den Wert dertype-Eigenschaft eines imeComposition-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das IME-Objekt. |
Tue Jun 12 2018, 10:04 AM Z