flash.text.imeIIMEClient Schnittstelle für IME-Clients (IME = Input Method Editor). Schnittstelle für IME-Clients (IME = Input Method Editor). Komponenten, die auf dem flash.text.engine-Paket basieren, müssen diese Schnittstelle implementieren, um die Bearbeitung von Text in der Zeile („inline“) mit einem IME zu unterstützen. Diese Schnittstelle wird nicht mit TextField-Objekten verwendet. TextLayoutFramework (TLF) verwendet diese Schnittstelle, um Inline-IME zu unterstützen; Clients, die TLF einsetzen, brauchen diese Schnittstelle also nicht zu implementieren.

Um Inline-IME zu unterstützen, stellen Sie die imeClient-Eigenschaft eines ImeEvent.IME_START_COMPOSITION-Ereignisses auf ein Objekt ein, dass diese Schnittstelle implementiert.

Die folgenden Begriffe werden häufig in der IME-bezogenen API verwendet:

  • Eine Konversation ist der Austausch zwischen dem IME und der Anwendung. Während einer Konversation wird ein Satz ein oder mehrere Male aktualisiert und dann vom Benutzer bestätigt.
  • Ein Satz identifiziert den Text, der vom Benutzer über den IME eingegeben wird; dazu gehören auch zugehörige Eingabestatusinformationen wie der ausgewählte Bereich und der Umfang etwaiger vorhandener Klauseln.
  • Eine Klausel ist ein Bereich des Satzes mit möglicherweise gemeinsamen semantischen Informationen, zum Beispiel die Anzeige, ob es sich bei der Eingabe um einen ausgewählten oder konvertierten Zustand handelt. Ein Satz enthält null oder mehrere Klauseln.
flash.text.ime.CompositionAttributeRangeflash.events.IMEEvent.imeClienttextInput Wird ausgelöst, wenn der Benutzer Text eingibt.flash.events.TextEvent.TEXT_INPUTflash.events.TextEvent Wird ausgelöst, wenn der Benutzer Text eingibt. Für IME-Clients (IME = Input Method Editor) sollte der Empfänger den String, der in der text-Eigenschaft des Ereignisobjekts enthalten ist, an der aktuellen Einfügemarke einfügen. imeStartComposition Wird abgesetzt, wenn der Benutzer mit der Verwendung eines IME (Input Method Editor) beginnt.flash.events.IMEEvent.IME_START_COMPOSITIONflash.events.IMEEvent Wird abgesetzt, wenn der Benutzer mit der Verwendung eines IME (Input Method Editor) beginnt. confirmComposition Verwenden Sie diesen Rückruf, um die Inline-Bearbeitungssitzung zu beenden und den Text zu bestätigen.textStringnull der endgültige Zustand des Texts in der Inline-Sitzung (der bestätigte Text). preserveSelectionBooleanfalse bei der Einstellung „true“ sollten Sie die aktuelle Textauswahl nicht auf das Ende des bestätigten Texts zurücksetzen. Verwenden Sie diesen Rückruf, um die Inline-Bearbeitungssitzung zu beenden und den Text zu bestätigen. getTextBounds Der IME verwendet diese Methode, um den Begrenzungsrahmen des Texts, der zurzeit mit dem IME-Client bearbeitet wird, abzufragen.Der Begrenzungsrahmen des angegebenen Textbereichs oder null, wenn mindestens einer der Indizes ungültig ist. Diese Methode gibt denselben Wert zurück, wenn startIndex größer oder kleiner als endIndex ist. Unabhängig davon, ob startIndex größer oder kleiner als endIndex ist, sollte der gleiche Wert wiedergegeben werden. flash.geom:RectanglestartIndexintEine Ganzzahl, die die Startposition des Textbereichs vom Begrenzungsrahmen, den Sie messen, angibt. endIndexintOptional, eine Ganzzahl, die die Endposition des Textbereichs vom Begrenzungsrahmen, den Sie messen, angibt. Der IME verwendet diese Methode, um den Begrenzungsrahmen des Texts, der zurzeit mit dem IME-Client bearbeitet wird, abzufragen. Verwenden Sie diese Methode, um das Kandidatenfenster zu platzieren und den Mauscursor in den IME-Client zu setzen, wenn sich die Maus über dem Textfeld oder der Komponente, die IME unterstützt, befindet. getTextInRange Ruft den angegebenen Textbereich von der Komponente ab.Der angeforderte Text oder null, wenn im angeforderten Bereich kein Text verfügbar ist, oder wenn mindestens einer der Indizes ungültig ist. Es sollte derselbe Wert zurückgegeben werden, unabhängig davon, ob startIndex größer oder kleiner als endIndex ist. StringstartIndexinteine Ganzzahl, die die Startposition des abzurufenden Textbereichs angibt. endIndexinteine Ganzzahl, die die Endposition des abzurufenden Textbereichs angibt. Ruft den angegebenen Textbereich von der Komponente ab. Diese Methode wird während der IME-Neukonvertierung aufgerufen. selectRange Legt den Bereich des ausgewählten Texts in der Komponente fest.anchorIndexintDer auf null basierende Index des Zeichens beim Ankerende der Auswahl activeIndexintDer auf null basierende Index des Zeichens beim aktiven Ende der Auswahl. Legt den Bereich des ausgewählten Texts in der Komponente fest. Wenn eines der Argumente außerhalb des gültigen Bereichs liegt, sollte die Auswahl nicht geändert werden. updateComposition Rückruf zum Aktualisieren des Inhalts der Inline-Bearbeitungssitzung.textString Enthält den Text der Inline-Bearbeitungssitzung vom IME. attributes Enthält ein Array von Satzklauseln mit Verzierungsinformationen. compositionStartIndexint Start der Inline-Sitzung relativ zum Start des Textobjekts. compositionEndIndexint Ende der Inline-Sitzung relativ zum Start des Textobjekts. Rückruf zum Aktualisieren des Inhalts der Inline-Bearbeitungssitzung. Diese Methode wird aufgerufen, wenn der Text, der mit dem IME bearbeitet wird, geändert wurde und sein Inhalt vom Client verwendet wird, um die gesamte Inline-Bearbeitungssitzung neu zu zeichnen. compositionEndIndex Der auf null basierende Zeichenindexwert des Endes des aktuellen Bearbeitungssitzungstexts (zum Beispiel der gesamte Text in der Inline-Sitzung, der noch nicht für das Dokument bestätigt wurde).int Der auf null basierende Zeichenindexwert des Endes des aktuellen Bearbeitungssitzungstexts (zum Beispiel der gesamte Text in der Inline-Sitzung, der noch nicht für das Dokument bestätigt wurde). compositionStartIndex Der auf null basierende Zeichenindexwert des Anfangs des aktuellen Bearbeitungssitzungstexts (zum Beispiel der gesamte Text in der Inline-Sitzung, der noch nicht für das Dokument bestätigt wurde).int Der auf null basierende Zeichenindexwert des Anfangs des aktuellen Bearbeitungssitzungstexts (zum Beispiel der gesamte Text in der Inline-Sitzung, der noch nicht für das Dokument bestätigt wurde). selectionActiveIndex Der auf null basierende Indexwert des letzten Zeichens in der aktuellen Auswahl.int Der auf null basierende Indexwert des letzten Zeichens in der aktuellen Auswahl. selectionAnchorIndex Der auf null basierende Zeichenindexwert des ersten Zeichens in der aktuellen Auswahl.int Der auf null basierende Zeichenindexwert des ersten Zeichens in der aktuellen Auswahl. verticalTextLayout Gibt an, ob der Text in der Komponente vertikal ist oder nicht.Boolean Gibt an, ob der Text in der Komponente vertikal ist oder nicht. Diese Eigenschaft steuert die Positionierung des Kandidatenfenster (zum Beispiel neben vertikalem Text oder unter horizontalem Text). CompositionAttributeRange Die CompositionAttributeRange-Klasse stellt einen Bereich von Satzattributen dar, die mit IME-Ereignissen verwendet werden (IME = Input Method Editor).Object Die CompositionAttributeRange-Klasse stellt einen Bereich von Satzattributen dar, die mit IME-Ereignissen verwendet werden (IME = Input Method Editor). Beim Bearbeiten von Text im IME wird der Text zum Beispiel vom IME in Satzbereiche unterteilt. Diese Satzbereiche werden als ausgewählten gekennzeichnet (zum Beispiel als zurzeit verlängert, verkürzt oder bearbeitet) und/oder konvertiert (was bedeutet, dass der Bereich bereits einen Nachschlagevorgang im IME-Wörterbuch durchlaufen hat).

Gemäß Konvention sollte der Client diese Satzbereiche durch Unterstreichen oder Hervorheben entsprechend den Kennzeichnern markieren („verzieren“).

Beispiel:

!converted = thick gray underline (raw text) !selected && converted = thin black underline selected && converted = thick black underline flash.text.ime.IIMEClientCompositionAttributeRange Erstellt ein CompositionAttributeRange-Objekt.relativeStartint Der auf null basierende Index des ersten Zeichens, das im Zeichenbereich enthalten ist. relativeEndint Der auf null basierende Index des letzten Zeichens, das im Zeichenbereich enthalten ist. selectedBoolean Definiert die aktuelle Satzklausel als aktiv oder nicht aktiv. convertedBoolean Definiert die aktuelle Klausel als vom IME bearbeitet und auf Benutzerbestätigung wartend. Konstruktor für CompositionAttributeRange-Objekte. Erstellt ein CompositionAttributeRange-Objekt. converted Eine Eigenschaft, die die aktuelle Klausel definiert, die vom IME verarbeitet wurde und darauf wartet, dass der Benutzer sie akzeptiert oder bestätigt. Boolean Eine Eigenschaft, die die aktuelle Klausel definiert, die vom IME verarbeitet wurde und darauf wartet, dass der Benutzer sie akzeptiert oder bestätigt. relativeEnd Die Position des Satzklauselendes, relativ zum Anfang der Inline-Bearbeitungssitzung. int Die Position des Satzklauselendes, relativ zum Anfang der Inline-Bearbeitungssitzung. 0 entspricht zum Beispiel dem Start des Texts, den der IME liest (das Bearbeitungsfeld kann jedoch auch vor dieser Position Text enthalten). relativeStart Die Startposition in Relation zum Anfang der aktuellen Inline-Bearbeitungssitzung. int Die Startposition in Relation zum Anfang der aktuellen Inline-Bearbeitungssitzung. 0 entspricht zum Beispiel dem Start des Texts, den der IME liest (das Bearbeitungsfeld kann jedoch auch vor dieser Position Text enthalten). selected Eine Eigenschaft, die definiert, dass die aktuelle Satzklausel aktiv ist und mit dem IME verlängert oder verkürzt oder bearbeitet wird, während die Nachbarklauseln nicht geändert werden. Boolean Eine Eigenschaft, die definiert, dass die aktuelle Satzklausel aktiv ist und mit dem IME verlängert oder verkürzt oder bearbeitet wird, während die Nachbarklauseln nicht geändert werden.