ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.system 

IME  - AS3

Paketflash.system
Klassepublic final class IME
VererbungIME Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, 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-Laufzeitanwendung direkt bearbeiten. Dabei können Sie bestimmen, 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 Anwendung aktivieren oder deaktivieren und je nach Betriebssystem weitere eingeschränkte Funktionen ausführen.

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:

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:

FunktionWindowsMac OS XLinux
Feststellen, ob ein IME installiert ist Capabilities.hasIME JaJaJa
IME aktivieren/deaktivieren IME.enabled JaJaJa
Feststellen, ob der IME aktiviert bzw. deaktiviert ist IME.enabled JaJaJa
Abrufen oder Festlegen des IME-Konvertierungsmodus IME.conversionMode JaJa **Nein
Zu konvertierenden String an IME senden IME.setCompositionString() Ja *NeinNein
Den Originalstring vor der Konvertierung vom IME abrufen System.ime.addEventListener() Ja *NeinNein
Anforderung für die Konvertierung an IME senden IME.doConversion() Ja *NeinNein

* 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.


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : 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
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
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
  
compositionAbandoned():void
[statisch] Veranlasst die Laufzeitumgebung, alle Satzvorgänge („Composition“), die zurzeit ausgeführt werden, abzubrechen.
IME
  
compositionSelectionChanged(start:int, end:int):void
[statisch] Rufen Sie diese Methode auf, wenn die Auswahl innerhalb des Satzes entweder interaktiv oder programmgesteuert aktualisiert wurde.
IME
 Inherited
dispatchEvent(event:Event):Boolean
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
doConversion():void
[statisch] Weist den IME an, den ersten Kandidaten für den aktuellen Eingabestring auszuwählen.
IME
 Inherited
hasEventListener(type:String):Boolean
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
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
 Inherited
propertyIsEnumerable(name:String):Boolean
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
  
setCompositionString(composition:String):void
[statisch] Legt den IME-Eingabestring fest.
IME
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
toLocaleString():String
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
toString():String
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
valueOf():Object
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
willTrigger(type:String):Boolean
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.
 Ereignis Übersicht Definiert von
 Inherited
activate
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited
deactivate
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus 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
Eigenschaftendetails

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

Auslöser
Error — Eine Festlegung wurde nicht erfolgreich ausgeführt.

Verwandte API-Elemente

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

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):void

Auslö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():Boolean
Methodendetails

compositionAbandoned

()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 
public static function doConversion():void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, 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
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.
Ereignisdetails

imeComposition

 Ereignis
Ereignisobjekttyp: flash.events.IMEEvent
Eigenschaft 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 der type-Eigenschaft eines imeComposition-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas IME-Objekt.



© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 10:04 AM Z
 

 

Rechtliche Hinweise | Onlinedatenschutzerklärung
[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.