ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
flash.system 

IME  - AS3

Pakietflash.system
Klasapublic final class IME
DziedziczenieIME Inheritance EventDispatcher Inheritance Object

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9

Klasa IME oferuje bezpośrednią kontrolę nad edytorem IME (input method editor) systemu operacyjnego przy użyciu aplikacji środowiska wykonawczego Flash uruchomionej na komputerze klienckim. Można określić, czy edytor IME jest zainstalowany i włączony w danej chwili, a także który edytor IME jest włączony. W aplikacji można włączać i wyłączać edytor IME, a także wykonywać inne funkcje w ograniczonym zakresie — w zależności od systemu operacyjnego.

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:

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śćWindowsMac OSXLinux
Określa, czy zainstalowany jest edytor IME: Capabilities.hasIME TakTakTak
Umożliwia włączenie lub wyłączenie edytora IME: IME.enabled TakTakTak
Umożliwia określenie, czy IME jest włączony lub wyłączony: IME.enabled TakTakTak
Umożliwia pobranie lub ustawienie trybu konwersji IME: IME.conversionMode TakTak **Nie
Umożliwia wysłanie do IME ciągu znaków przeznaczonego do konwersji: IME.setCompositionString() Tak *NieNie
Umożliwia pobranie z IME oryginalnego ciągu znaków przed konwersją: System.ime.addEventListener() Tak *NieNie
Umożliwia wysłanie żądania konwersji do IME: IME.doConversion() Tak *NieNie

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


Właściwości publiczne
 WłaściwośćZdefiniowane przez
 Inheritedconstructor : 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
Metody publiczne
 MetodaZdefiniowane przez
 Inherited
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
  
compositionAbandoned():void
[statyczny] Powoduje, że środowisko wykonawcze przerywa wszystkie trwające operacje kompozycji.
IME
  
compositionSelectionChanged(start:int, end:int):void
[statyczny] Metodę tę należy wywołać po ręcznym lub programowym zaktualizowaniu zaznaczenia wewnątrz kompozycji.
IME
 Inherited
dispatchEvent(event:Event):Boolean
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.
EventDispatcher
  
doConversion():void
[statyczny] Monituje edytor IME o wybór pierwszego kandydata do bieżącego ciągu znaków złożenia.
IME
 Inherited
hasEventListener(type:String):Boolean
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Usuwa detektor z obiektu EventDispatcher.
EventDispatcher
  
setCompositionString(composition:String):void
[statyczny] Ustawia ciąg kompozycji IME.
IME
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
toLocaleString():String
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
toString():String
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
valueOf():Object
Zwraca pierwotną wartość dla określonego obiektu.
Object
 Inherited
willTrigger(type:String):Boolean
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.
EventDispatcher
Zdarzenia
Kliknij, aby uzyskać więcej informacji o zdarzeniach
 Zdarzenie Podsumowanie Zdefiniowane przez
 Inherited
activate
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.EventDispatcher
 Inherited
deactivate
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.EventDispatcher
  
imeComposition
Dysponowana, gdy użytkownik zakończył tworzenie kompozycji IME i odpowiedni ciąg znaków jest dostępny.IME
Szczegół właściwości

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_FULL
  • ALPHANUMERIC_HALF
  • CHINESE
  • JAPANESE_HIRAGANA
  • JAPANESE_KATAKANA_FULL
  • JAPANESE_KATAKANA_HALF
  • KOREAN
  • UNKNOWN (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):void

Zgłasza
Error — Próba ustawienia nie powiodła się.

Powiązane elementy interfejsu API

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

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

Zgł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():Boolean
Szczegół metody

compositionAbandoned

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9

Nakazuje edytorowi IME wybranie pierwszego kandydata do bieżącego ciągu kompozycji.


Zgłasza
Error — Wywołanie nie powiodło się.

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ę.
Szczegół zdarzenia

imeComposition

 Zdarzenie
Typ obiektu zdarzenia: flash.events.IMEEvent
wł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ści type obiektu zdarzenia imeComposition.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt IME.



© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 12:06 PM Z
 

 

Informacje prawne | Zasady prywatności online
[ X ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.