| Pakiet | flash.system |
| Klasa | public final class IME |
| Dziedziczenie | IME  EventDispatcher Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Obsługa profilów AIR: Ta funkcja jest obsługiwana w systemach operacyjnych dla komputerów stacjonarnych, ale nie jest obsługiwana na niektórych urządzeniach przenośnych. Nie jest to również obsługiwana na urządzeniach telewizyjnych ze środowiskiem AIR. W czasie wykonywania można sprawdzić, czy ta funkcja jest obsługiwana, odczytując właściwość IME.isSupported. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.
Edytory IME umożliwiają użytkownikom pisanie znaków innych niż ASCII w językach wielobajtowych, takich jak chiński, japoński i koreański. Więcej informacji na temat pracy z edytorami IME zawiera dokumentacja systemu operacyjnego, dla którego tworzone są aplikacje. Dodatkowe zasoby są dostępne na następujących witrynach sieci Web:
- http://www.microsoft.com/globaldev/default.mspx
- http://developer.apple.com/documentation/
- http://java.sun.com
Jeśli edytor IME nie jest aktywny na komputerze użytkownika, wywołania metod lub właściwości IME innych niż Capabilities.hasIME zakończą się niepowodzeniem. Po ręcznym aktywowaniu edytora IME wywołania ActionScript dotyczące metod i właściwości IME będą działały zgodnie z oczekiwaniami. Na przykład: jeśli używany jest edytor IME dla języka japońskiego, należy go aktywować przed wywołaniem jakiejkolwiek metody lub właściwości IME.
W poniższej tabeli przedstawiono platformy, w jakich dostępna jest ta klasa:
| Dostępność | Windows | Mac OSX | Linux |
|---|---|---|---|
Określa, czy zainstalowany jest edytor IME: Capabilities.hasIME
| Tak | Tak | Tak |
Umożliwia włączenie lub wyłączenie edytora IME: IME.enabled
| Tak | Tak | Tak |
Umożliwia określenie, czy IME jest włączony lub wyłączony: IME.enabled
| Tak | Tak | Tak |
Umożliwia pobranie lub ustawienie trybu konwersji IME: IME.conversionMode
| Tak | Tak ** | Nie |
Umożliwia wysłanie do IME ciągu znaków przeznaczonego do konwersji: IME.setCompositionString()
| Tak * | Nie | Nie |
Umożliwia pobranie z IME oryginalnego ciągu znaków przed konwersją: System.ime.addEventListener()
| Tak * | Nie | Nie |
Umożliwia wysłanie żądania konwersji do IME: IME.doConversion()
| Tak * | Nie | Nie |
* Nie wszystkie edytory IME w systemach Windows obsługują wszystkie te operacje. Jedynym edytorem IME, który obsługuje je wszystkie jest IME dla języka japońskiego.
** W systemie Macintosh tylko edytor IME dla języka japońskiego obsługuje te metody, a IME innych firm nie obsługują ich.
Wersja ActionScript 3.0 tej klasy nie obsługuje Macintosh Classic.
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| conversionMode : String [statyczny]
Tryb konwersji bieżącego edytora IME. | IME | ||
| enabled : Boolean [statyczny]
Wskazuje, czy systemowy edytor IME jest włączony (prawda), czy nie (fałsz). | IME | ||
| isSupported : Boolean [statyczny] [tylko do odczytu]
Właściwość isSupported ma wartość true, jeśli na bieżącej platformie jest dostępna klasa IME; w przeciwnym razie ma wartość false. | IME | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | |
[statyczny]
Powoduje, że środowisko wykonawcze przerywa wszystkie trwające operacje kompozycji. | IME | ||
[statyczny]
Metodę tę należy wywołać po ręcznym lub programowym zaktualizowaniu zaznaczenia wewnątrz kompozycji. | IME | ||
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
[statyczny]
Monituje edytor IME o wybór pierwszego kandydata do bieżącego ciągu znaków złożenia. | IME | ||
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
[statyczny]
Ustawia ciąg kompozycji IME. | IME | ||
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher | |
| Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
|---|---|---|---|---|
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | ||
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | ||
| Dysponowana, gdy użytkownik zakończył tworzenie kompozycji IME i odpowiedni ciąg znaków jest dostępny. | IME | |||
conversionMode | właściwość |
conversionMode:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Tryb konwersji bieżącego edytora IME. Możliwe wartości to stałe ciągu znaków trybu IME, które oznaczają tryb konwersji:
ALPHANUMERIC_FULLALPHANUMERIC_HALFCHINESEJAPANESE_HIRAGANAJAPANESE_KATAKANA_FULLJAPANESE_KATAKANA_HALFKOREANUNKNOWN(wartość tylko do odczytu; tej wartości nie można ustawić)
Implementacja
public static function get conversionMode():String public static function set conversionMode(value:String):voidZgłasza
Error — Próba ustawienia nie powiodła się.
|
Powiązane elementy interfejsu API
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 | właściwość |
enabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Wskazuje, czy systemowy IME jest włączony (true) lub wyłączony (false). Włączony edytor IME wprowadza znaki wielobajtowe; wyłączony edytor IME wprowadza znaki alfanumeryczne.
Implementacja
public static function get enabled():Boolean public static function set enabled(value:Boolean):voidZgłasza
Error — Próba ustawienia nie powiodła się.
|
isSupported | właściwość |
isSupported:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Właściwość isSupported ma wartość true, jeśli na bieżącej platformie jest dostępna klasa IME; w przeciwnym razie ma wartość false.
Implementacja
public static function get isSupported():BooleancompositionAbandoned | () | metoda |
public static function compositionAbandoned():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Powoduje, że środowisko wykonawcze przerywa wszystkie trwające operacje kompozycji. Metodę tę należy wywołać, gdy użytkownik kliknie poza obszarem kompozycji lub gdy aktywny obiekt interaktywny jest niszczony lub przywracany do stanu początkowego. Środowisko wykonawcze potwierdza kompozycję, wywołując metodę confirmComposition() na kliencie. Środowisko wykonawcze przywraca także edytor IME do stanu początkowego, aby poinformować system operacyjny o przerwaniu kompozycji.
compositionSelectionChanged | () | metoda |
public static function compositionSelectionChanged(start:int, end:int):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Metodę tę należy wywołać po ręcznym lub programowym zaktualizowaniu zaznaczenia wewnątrz kompozycji.
Parametry
start:int — Określa przesunięcie początku zaznaczenia w bajtach.
| |
end:int — Określa przesunięcie końca zaznaczenia w bajtach.
|
doConversion | () | metoda |
setCompositionString | () | metoda |
public static function setCompositionString(composition:String):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Ustawia ciąg kompozycji IME. Po ustawieniu ciągu znaków użytkownik może wybrać ewentualne edytory IME — przed zatwierdzeniem wyników w aktywnym polu tekstowym.
Jeśli żadne pole tekstowe nie jest aktywne, ta metoda zakończy się niepowodzeniem i zwróci błąd.
Parametry
composition:String — Ciąg znaków wysyłany do edytora IME.
|
Zgłasza
Error — Wywołanie nie powiodło się.
|
imeComposition | Zdarzenie |
flash.events.IMEEventwłaściwość IMEEvent.type =
flash.events.IMEEvent.IME_COMPOSITION| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Dysponowana, gdy użytkownik zakończył tworzenie kompozycji IME i odpowiedni ciąg znaków jest dostępny. Edytory IME są używane z reguły do wprowadzania tekstu w językach, w których stosowane są ideogramy, a nie litery, np. w języku japońskim, chińskim lub koreańskim.
Definiuje wartość właściwościtype obiektu zdarzenia imeComposition.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt IME. |
Tue Jun 12 2018, 12:06 PM Z