| Paket | flash.text.ime |
| Gränssnitt | public interface IIMEClient |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Om du vill ha stöd för infogad IME-text anger du egenskapen imeClient för en ImeEvent.IME_START_COMPOSITION-händelse till ett objekt som implementerar det här gränssnittet.
Följande termer används ofta i gränssnittet för IME-text:
- En konversation är utbytet mellan IME och programmet. Under en konversation uppdateras en disposition en eller flera gånger och bekräftas sedan av användaren.
- En disposition identifierar den text som skrivs av användaren via IME, bl.a. information om associerat indataläge som markerat intervall och omfattningen av eventuella satser.
- En sats är ett intervall i dispositionen som kan dela semantisk information, t.ex. om indata har statusen selected (markerad) eller converted (konverterad). En disposition innehåller noll eller fler satser.
Relaterade API-element
| Egenskap | Definieras med | ||
|---|---|---|---|
| compositionEndIndex : int [skrivskyddad]
Det nollbaserade teckenindexvärdet för slutet av den aktuella redigeringssessionen (d.v.s. all text i den infogade sessionen som inte har bekräftats i dokumentet). | IIMEClient | ||
| compositionStartIndex : int [skrivskyddad]
Det nollbaserade teckenindexvärdet för början av den aktuella redigeringssessionen (d.v.s. all text i den infogade sessionen som inte har bekräftats i dokumentet). | IIMEClient | ||
| selectionActiveIndex : int [skrivskyddad]
Det nollbaserade teckenindexvärdet för det sista tecknet i den aktuella markeringen. | IIMEClient | ||
| selectionAnchorIndex : int [skrivskyddad]
Det nollbaserade teckenindexvärdet för det första tecknet i den aktuella markeringen. | IIMEClient | ||
| verticalTextLayout : Boolean [skrivskyddad]
Anger om texten i komponenten är lodrät eller inte. | IIMEClient | ||
| Metod | Definieras med | ||
|---|---|---|---|
Använd det här återanropet för att avsluta den infogade redigeringssessionen och bekräfta texten. | IIMEClient | ||
Den här metoden används av IME för att fråga efter ramen för den text som just nu redigeras med IME-klienten. | IIMEClient | ||
Hämtar det angivna textintervallet från komponenten. | IIMEClient | ||
Anger intervallet för den markerade texten i komponenten. | IIMEClient | ||
updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void
Återanrop för att uppdatera innehållet i den infogade redigeringssessionen. | IIMEClient | ||
| Händelse | Sammanfattning | Definieras med | ||
|---|---|---|---|---|
| Skickas när användaren börjar använda en IME (Input Method Editor). | IIMEClient | |||
| Skickas när användaren skriver text. | IIMEClient | |||
compositionEndIndex | egenskap |
compositionEndIndex:int [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Det nollbaserade teckenindexvärdet för slutet av den aktuella redigeringssessionen (d.v.s. all text i den infogade sessionen som inte har bekräftats i dokumentet).
Implementering
public function get compositionEndIndex():intcompositionStartIndex | egenskap |
compositionStartIndex:int [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Det nollbaserade teckenindexvärdet för början av den aktuella redigeringssessionen (d.v.s. all text i den infogade sessionen som inte har bekräftats i dokumentet).
Implementering
public function get compositionStartIndex():intselectionActiveIndex | egenskap |
selectionAnchorIndex | egenskap |
verticalTextLayout | egenskap |
verticalTextLayout:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Anger om texten i komponenten är lodrät eller inte. Den här egenskapen anger fönstrets placering (till exempel bredvid lodrät text eller nedanför vågrät text).
Implementering
public function get verticalTextLayout():BooleanconfirmComposition | () | metod |
public function confirmComposition(text:String = null, preserveSelection:Boolean = false):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Använd det här återanropet för att avsluta den infogade redigeringssessionen och bekräfta texten.
Parametrar
text:String (default = null) | |
preserveSelection:Boolean (default = false) |
getTextBounds | () | metod |
public function getTextBounds(startIndex:int, endIndex:int):Rectangle| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Den här metoden används av IME för att fråga efter ramen för den text som just nu redigeras med IME-klienten. Använd den här metoden för att placera fönstret och ställa in musmarkören i IME-klienten när musen befinner sig ovanför textfältet eller någon annan komponent som har stöd för IME.
Parametrar
startIndex:int — Ett heltal som anger startpositionen för textintervallet från den begränsningsram du mäter.
| |
endIndex:int — Valfritt: Ett heltal som anger slutpositionen för textintervallet från den begränsningsram du mäter.
|
Rectangle — Begränsningsramen för det angivna textintervallet eller null om något eller båda av indexen är ogiltiga. Den här metoden returnerar samma värde oavsett om startIndex är större eller mindre än endIndex. Samma värde bör returneras oberoende av om startIndex är större eller mindre än endIndex.
|
getTextInRange | () | metod |
public function getTextInRange(startIndex:int, endIndex:int):String| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Hämtar det angivna textintervallet från komponenten. Den här metoden anropas under IME-omkonvertering.
Parametrar
startIndex:int — ett heltal som anger startpositionen för det textintervall som ska hämtas.
| |
endIndex:int — ett heltal som anger slutpositionen för det textintervall som ska hämtas.
|
String — Den begärda texten eller null, om ingen text är tillgänglig i det begärda intervallet eller om något eller båda av indexen är ogiltiga. Samma värde bör returneras oberoende av om startIndex är större eller mindre än endIndex.
|
selectRange | () | metod |
public function selectRange(anchorIndex:int, activeIndex:int):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Anger intervallet för den markerade texten i komponenten. Om något av argumenten är utanför tillåtet intervall bör markeringen inte ändras.
Parametrar
anchorIndex:int — Det nollbaserade indexvärdet för tecknet i markeringens ankarpunktsände.
| |
activeIndex:int — Det nollbaserade indexvärdet för tecknet i markeringens aktiva ände.
|
updateComposition | () | metod |
public function updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Återanrop för att uppdatera innehållet i den infogade redigeringssessionen. Den här metoden anropas så fort den text som redigeras med IME ändras och dess innehåll används av klienten för att rita om hela den infogade redigeringssessionen.
Parametrar
text:String — Innehåller texten i den infogade redigeringssessionen från IME.
| |
attributes:Vector.<CompositionAttributeRange> — Innehåller en array med dispositionssatser med utsmyckningsinformation.
| |
compositionStartIndex:int — Starten på den infogade sessionen i förhållande till textobjektets start.
| |
compositionEndIndex:int — Slutet på den infogade sessionen i förhållande till textobjektets start.
|
imeStartComposition | Händelse |
flash.events.IMEEventegenskap IMEEvent.type =
flash.events.IMEEvent.IME_START_COMPOSITION| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Skickas när användaren börjar använda en IME (Input Method Editor).
För att hantera IME-textindata måste fältetimeClient för händelsen hos mottagaren anges till ett objekt som implementerar IIMEClient-gränssnittet. Om imeClient inte anges används IME-disposition som inte är infogad i stället, och den slutliga dispositionen skickas som en TEXT_INPUT-händelse.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | IME-objektet. |
textInput | Händelse |
flash.events.TextEventegenskap TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Skickas när användaren skriver text. För IME-klienter bör mottagaren infoga den sträng som finns i händelseobjektets text-egenskap vid den aktuella insättningspunkten.
textInput-händelseobjekts type-egenskap.
Obs! Den här händelsen skickas inte för Delete- och backstegstangenterna.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | true |
cancelable | true; anropa preventDefault()-metoden för att avbryta standardbeteendet. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Det textfält som tecken anges i. Målet är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
text | Det tecken eller den följd av tecken som användaren har angivit. |
Tue Jun 12 2018, 01:40 PM Z