| Pakket | flash.text.ime |
| Interface | public interface IIMEClient |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Als u inlinebewerking met IME wilt ondersteunen, stelt u de eigenschap imeClient van een gebeurtenis ImeEvent.IME_START_COMPOSITION in op een object dat deze interface implementeert.
De volgende termen worden vaak gebruikte in de aan IME gerelateerde API:
- Een gesprek is de uitwisseling tussen de IME en de toepassing. Tijdens een gesprek wordt een compositie een of meerdere keren bijgewerkt en vervolgens bevestigd door de gebruiker.
- Een compositie identificeert de tekst die door de gebruiker is ingevoerd via IME, inclusief gekoppelde invoerstatusinformatie zoals het geselecteerde bereik en eventuele clausules.
- Een clausule is een bereik van de compositie die mogelijk semantische informatie deelt. Deze geeft bijvoorbeeld op of de invoer zich in een geselecteerde of omgezette status bevindt. Een compositie bevat geen of meer clausules.
Verwante API-elementen
| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
| compositionEndIndex : int [alleen-lezen]
De op nul gebaseerde indexwaarde van het teken van het einde van de huidige bewerkingssessietekst (bijvoorbeeld alle tekst in de inlinesessie die niet naar het document is bevestigd). | IIMEClient | ||
| compositionStartIndex : int [alleen-lezen]
De op nul gebaseerde indexwaarde van het teken van het begin van de huidige bewerkingssessietekst (bijvoorbeeld alle tekst in de inlinesessie die niet naar het document is bevestigd). | IIMEClient | ||
| selectionActiveIndex : int [alleen-lezen]
De op nul gebaseerde indexwaarde van het laatste teken in de huidige selectie. | IIMEClient | ||
| selectionAnchorIndex : int [alleen-lezen]
De op nul gebaseerde indexwaarde van het eerste teken in de huidige selectie. | IIMEClient | ||
| verticalTextLayout : Boolean [alleen-lezen]
Geeft aan of de tekst in het component verticaal is of niet. | IIMEClient | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
Gebruik deze callback om de inlinebewerkingssessie te beëindigen en de tekst te bevestigen. | IIMEClient | ||
De IME gebruikt deze methode om een query uit te voeren op het selectiekader van de tekst die op dat moment met de IME-client wordt bewerkt. | IIMEClient | ||
Haalt het opgegeven tekstbereik uit de component op. | IIMEClient | ||
Stelt het bereik van de geselecteerde tekst in de component in. | IIMEClient | ||
updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void
Callback voor het bijwerken van de inhoud van de inlinebewerkingssessie. | IIMEClient | ||
| Gebeurtenis | Overzicht | Gedefinieerd door | ||
|---|---|---|---|---|
| Wordt verzonden wanneer de gebruiker een IME (Input Method Editor) begint te gebruiken. | IIMEClient | |||
| Wordt verzonden wanneer de gebruiker tekst invoert. | IIMEClient | |||
compositionEndIndex | eigenschap |
compositionEndIndex:int [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
De op nul gebaseerde indexwaarde van het teken van het einde van de huidige bewerkingssessietekst (bijvoorbeeld alle tekst in de inlinesessie die niet naar het document is bevestigd).
Implementatie
public function get compositionEndIndex():intcompositionStartIndex | eigenschap |
compositionStartIndex:int [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
De op nul gebaseerde indexwaarde van het teken van het begin van de huidige bewerkingssessietekst (bijvoorbeeld alle tekst in de inlinesessie die niet naar het document is bevestigd).
Implementatie
public function get compositionStartIndex():intselectionActiveIndex | eigenschap |
selectionAnchorIndex | eigenschap |
verticalTextLayout | eigenschap |
verticalTextLayout:Boolean [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Geeft aan of de tekst in het component verticaal is of niet. Deze eigenschap bepaalt de positie van het kandidaatvenster (bijvoorbeeld naast verticale tekst of onder horizontale tekst).
Implementatie
public function get verticalTextLayout():BooleanconfirmComposition | () | methode |
public function confirmComposition(text:String = null, preserveSelection:Boolean = false):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Gebruik deze callback om de inlinebewerkingssessie te beëindigen en de tekst te bevestigen.
Parameters
text:String (default = null) | |
preserveSelection:Boolean (default = false) |
getTextBounds | () | methode |
public function getTextBounds(startIndex:int, endIndex:int):Rectangle| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
De IME gebruikt deze methode om een query uit te voeren op het selectiekader van de tekst die op dat moment met de IME-client wordt bewerkt. Gebruik deze methode om het kandidaatvenster te plaatsen en plaats de muisaanwijzer in de IME-client als de muis het tekstveld of een andere component die IME ondersteunt, aanwijst.
Parameters
startIndex:int — Een geheel getal dat de startlocatie opgeeft van het tekstbereik van het selectiekader dat u meet.
| |
endIndex:int — Optioneel; een geheel getal dat de eindlocatie opgeeft van het tekstbereik van het selectiekader dat u meet.
|
Rectangle — Het selectiekader van het opgegeven tekstbereik of null als een of beide indexen ongeldig zijn. Deze methode retourneert dezelfde waarde als startIndex groter of kleiner is dan endIndex. Dezelfde waarde moet worden geretourneerd, of startIndex nu groter of kleiner is dan endIndex of niet.
|
getTextInRange | () | methode |
public function getTextInRange(startIndex:int, endIndex:int):String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Haalt het opgegeven tekstbereik uit de component op. Deze methode wordt opgeroepen tijdens IME-reconversie.
Parameters
startIndex:int — een geheel getal dat de startlocatie opgeeft van het tekstbereik dat moet worden opgehaald.
| |
endIndex:int — een geheel getal dat de eindlocatie opgeeft van het tekstbereik dat moet worden opgehaald.
|
String — De aangevraagde tekst, of null als er geen tekst beschikbaar is in het opgevraagde bereik of als één index of beide indexen ongeldig zijn. Dezelfde waarde moet worden weergegeven, onafhankelijk of startIndex groter of kleiner is dan endIndex.
|
selectRange | () | methode |
public function selectRange(anchorIndex:int, activeIndex:int):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Stelt het bereik van de geselecteerde tekst in de component in. Als een van beide argumenten buiten het bereik valt, moet de selectie niet worden gewijzigd.
Parameters
anchorIndex:int — De op nul gebaseerde indexwaarde van het teken op het ankerpunt van de selectie.
| |
activeIndex:int — De op nul gebaseerde indexwaarde van het teken op het actieve punt van de selectie.
|
updateComposition | () | methode |
public function updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Callback voor het bijwerken van de inhoud van de inlinebewerkingssessie. Deze methode wordt opgeroepen wanneer de tekst die wordt bewerkt met de IME is gewijzigd en de inhoud van de tekst door de client wordt gebruikt om de volledige inlinebewerkingssessie te vernieuwen.
Parameters
text:String — Bevat de tekst van de inlinebewerkingssessie van de IME.
| |
attributes:Vector.<CompositionAttributeRange> — Bevat een array met compositieclausules met informatie over grafische elementen.
| |
compositionStartIndex:int — Start van de inlinesessie in verhouding tot de start van het tekstobject.
| |
compositionEndIndex:int — Einde van de inlinesessie in verhouding tot de start van het tekstobject.
|
imeStartComposition | Gebeurtenis |
flash.events.IMEEventeigenschap IMEEvent.type =
flash.events.IMEEvent.IME_START_COMPOSITION| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Wordt verzonden wanneer de gebruiker een IME (Input Method Editor) begint te gebruiken.
Om IME-tekstinvoer toe te passen, moet de ontvanger het imeClientimeClient ongedaan is gemaakt, gebruikt de runtime in plaats daarvan een niet-uitgelijnde IME-compositie en verstuurt de eindcompositie als een TEXT_INPUT-gebeurtenis.
Deze gebeurtenis heeft de volgende eigenschappen:
| Eigenschap | Waarde |
|---|---|
bubbles | false |
cancelable | false; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object IME. |
textInput | Gebeurtenis |
flash.events.TextEventeigenschap TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 10.1, AIR 2 |
Wordt verzonden wanneer de gebruiker tekst invoert. Voor IME-clients (Input Method Editor) moet de ontvanger de tekenreeks invoegen die zich in de eigenschap text van het gebeurtenisobject op het huidige invoegpunt bevindt.
type van een gebeurtenisobject textInput.
Opmerking: deze gebeurtenis wordt niet verzonden voor de toetsen Delete of Backspace.
Deze gebeurtenis heeft de volgende eigenschappen:
| Eigenschap | Waarde |
|---|---|
bubbles | true |
cancelable | true; roep de methode preventDefault() aan om het standaardgedrag te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het tekstveld waarin de tekens worden ingevoerd. Het doel is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
text | Het teken of de tekenreeks dat/die door de gebruiker is ingevoerd. |
Wed Jun 13 2018, 11:42 AM Z