flash.system.IME (ActionScript 3.0)

Paket	flash.system
Klasse	public final class IME
Vererbung	IME EventDispatcher Object

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Mit der IME-Klasse können Sie den Eingabemethoden-Editor (Input Method Editor, IME) des Betriebssystems mithilfe einer auf einem Client-Computer ausgeführten Flash Player-Anwendung direkt bearbeiten. Dabei können Sie feststellen, ob ein IME installiert ist, ob dieser aktiviert oder deaktiviert ist und um welchen IME es sich handelt. Sie können den IME in der Flash Player-Anwendung aktivieren oder deaktivieren und je nach Betriebssystem weitere eingeschränkte Funktionen ausführen.

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:

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 OSX
Feststellen, ob ein IME installiert ist `Capabilities.hasIME`	Ja	Ja
IME aktivieren/deaktivieren `IME.enabled`	Ja	Ja
Feststellen, ob der IME aktiviert bzw. deaktiviert ist `IME.enabled`	Ja	Ja
Abrufen oder Festlegen des IME-Konvertierungsmodus `IME.conversionMode`	Ja	Ja **
Zu konvertierenden String an IME senden `IME.setCompositionString()`	Ja *	Nein
Den Originalstring vor der Konvertierung vom IME abrufen `System.ime.addEventListener()`	Ja *	Nein
Anforderung für die Konvertierung an IME senden `IME.doConversion()`	Ja *	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.

Siehe auch

Verwenden der IME-Klasse

	Eigenschaft	Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		conversionMode : String [static] Der Konvertierungsmodus des aktuellen IME.	IME
		enabled : Boolean [static] Gibt an, ob der System-IME aktiviert (true) oder deaktiviert (false) ist.	IME
		prototype : Object [static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.	Object

Öffentliche Methoden

Vererbte öffentliche Methoden verbergen

Vererbte öffentliche Methoden anzeigen

	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
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		doConversion():void [static] Weist den IME an, den ersten Kandidaten für den aktuellen Eingabestring auszuwählen.	IME
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setCompositionString(composition:String):void [static] Legt den IME-Eingabestring fest.	IME
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner vorangegangenen Elementen ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Übersicht	Definiert von
activate	Wird ausgelöst, wenn Flash Player den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	Wird ausgelöst, wenn Flash Player den Betriebssystemfokus verliert und inaktiv wird.	EventDispatcher
imeComposition	Wird ausgelöst, wenn ein Benutzer die Eingabe in einem Eingabemethoden-Editor (IME) abgeschlossen hat und der Lesestring verfügbar ist.	IME

Eigenschaftsdetail

conversionMode

Eigenschaft

conversionMode:String [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Der Konvertierungsmodus des aktuellen IME. Mögliche Werte sind folgende IME-Modusstringkonstanten, die den Konvertierungsmodus angeben:

ALPHANUMERIC_FULL
ALPHANUMERIC_HALF
CHINESE
JAPANESE_HIRAGANA
JAPANESE_KATAKANA_FULL
JAPANESE_KATAKANA_HALF
KOREAN
UNKNOWN (schreibgeschützter Wert, der nicht festgelegt werden kann)

Implementierung
public static function get conversionMode():String
public function set conversionMode(value:String):void

Auslöser

Error — Eine Festlegung wurde nicht erfolgreich ausgeführt.

Siehe auch

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
Verwenden der IME-Klasse

enabled

Eigenschaft

enabled:Boolean [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

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

Auslöser

Error — Eine Festlegung wurde nicht erfolgreich ausgeführt.

Siehe auch

Verwenden der IME-Klasse

Methodendetail

doConversion

()

Methode

public static function doConversion():void

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Weist den IME an, den ersten Kandidaten für den aktuellen Eingabestring auszuwählen.

Auslöser

Error — Der Aufruf war nicht erfolgreich.

setCompositionString

()

Methode

public static function setCompositionString(composition:String):void

Sprachversion :

ActionScript 3.0

Player-Version :

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.

Ereignisdetail

imeComposition

Ereignis

Ereignisobjekttyp: flash.events.IMEEvent
IMEEvent.type property = flash.events.IMEEvent.IME_COMPOSITION

Sprachversion :

ActionScript 3.0

Player-Version :

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 der type-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.

Siehe auch

Verwenden der IME-Klasse

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/system/IME.html

Komponenten-Referenzhandbuch für ActionScript 3.0		Alle Pakete \| Alle Klassen \| Sprachelemente \| Stichwortverzeichnis \| Anhänge \| Konventionen \| Frames Keine Frames
IME	Eigenschaften \| Methoden \| Ereignisse