| Pacchetto | flash.system |
| Classe | public final class IME |
| Ereditarietà | IME  EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Supporto profili AIR: questa funzionalità è supportata nei sistemi operativi desktop ma non in tutti i dispositivi mobili. Inoltre, non è supportato nei dispositivi AIR per TV. È possibile verificare se la funzionalità è supportata in fase runtime utilizzando la proprietà IME.isSupported. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.
Gli editor del metodo di input consentono all'utente di digitare caratteri di testo non ASCII nelle lingue multibyte quali il cinese, il giapponese e il coreano. Per ulteriori informazioni sull'uso degli IME, vedete la documentazione del sistema operativo per il quale state sviluppando delle applicazioni. Per consultare ulteriori risorse, vedete i siti Web seguenti:
- http://www.microsoft.com/globaldev/default.mspx
- http://developer.apple.com/documentation/
- http://java.sun.com
Se sul computer dell'utente non è stato attivato alcun IME, le chiamate ai metodi o alle proprietà IME diversi da Capabilities.hasIME avranno esito negativo. Dopo che un IME è stato attivato manualmente, le successive chiamate ActionScript ai metodi e alle proprietà IME funzioneranno nei modi previsti. Ad esempio, se utilizzate un IME giapponese, questo deve essere attivato prima di chiamare qualsiasi metodo o proprietà.
La tabella seguente mostra l'applicabilità di questa classe alle piattaforme:
| Funzionalità | Windows | Mac OSX | Linux |
|---|---|---|---|
Determinare se l'IME è installato: Capabilities.hasIME
| Sì | Sì | Sì |
Abilitare o disabilitare l'IME: IME.enabled
| Sì | Sì | Sì |
Verificare se l'IME è abilitato o disabilitato: IME.enabled
| Sì | Sì | Sì |
Ottenere o impostare la modalità di conversione IME: IME.conversionMode
| Sì | Sì ** | No |
Inviare all'IME la stringa da convertire: IME.setCompositionString()
| Sì * | No | No |
Ottenere dall'IME la stringa originale prima della conversione: System.ime.addEventListener()
| Sì * | No | No |
Inviare la richiesta di conversione all'IME: IME.doConversion()
| Sì * | No | No |
* Non tutti gli IME Windows supportano tutte queste operazioni. L'unico IME che le supporta tutte è quello giapponese.
** Nei sistemi Macintosh, solo l'IME giapponese supporta questi metodi, mentre gli IME di terze parti non li supportano.
La versione ActionScript 3.0 di questa classe non supporta Macintosh Classic.
Altri esempi
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| conversionMode : String [statico]
La modalità di conversione dell'IME corrente. | IME | ||
| enabled : Boolean [statico]
Indica se l'IME del sistema è abilitato (true) o disabilitato (false). | IME | ||
| isSupported : Boolean [statico] [sola lettura]
La proprietà isSupported è impostata su true se la classe IME è disponibile nella piattaforma corrente, altrimenti è impostata su false. | IME | ||
| Metodo | Definito da | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
[statico]
Indica al runtime di abbandonare la composizione in corso. | IME | ||
[statico]
Chiamate questo metodo quando la selezione all'interno della composizione è stata aggiornata, sia in modo interattivo che a livello di programmazione. | IME | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
[statico]
Indica all'IME di selezionare il primo candidato per la stringa di composizione corrente. | IME | ||
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
[statico]
Imposta la stringa di composizione IME. | IME | ||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Inviato quando un utente ha completato una composizione IME e la stringa di lettura è disponibile. | IME | |||
conversionMode | proprietà |
conversionMode:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
La modalità di conversione dell'IME corrente. I valori possibili sono le costanti di stringa della modalità dell'IME che indicano la modalità di conversione:
ALPHANUMERIC_FULLALPHANUMERIC_HALFCHINESEJAPANESE_HIRAGANAJAPANESE_KATAKANA_FULLJAPANESE_KATAKANA_HALFKOREANUNKNOWN(sola lettura; questo valore non può essere impostato)
Implementazione
public static function get conversionMode():String public static function set conversionMode(value:String):voidGenera
Error — Un tentativo di impostazione ha dato esito negativo.
|
Altri esempi
Elementi API correlati
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 | proprietà |
enabled:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Indica se l'IME del sistema è abilitato (true) o disabilitato (false). Un IME abilitato esegue un input multibyte; uno disabilitato esegue un input alfanumerico.
Implementazione
public static function get enabled():Boolean public static function set enabled(value:Boolean):voidGenera
Error — Un tentativo di impostazione ha dato esito negativo.
|
Altri esempi
isSupported | proprietà |
isSupported:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2 |
La proprietà isSupported è impostata su true se la classe IME è disponibile nella piattaforma corrente, altrimenti è impostata su false.
Implementazione
public static function get isSupported():BooleancompositionAbandoned | () | metodo |
public static function compositionAbandoned():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2 |
Indica al runtime di abbandonare la composizione in corso. Chiamate questo metodo quando l'utente fa clic all'esterno dell'area di composizione o quando l'oggetto interattivo che ha lo stato attivo sta per essere eliminato o reimpostato. Il runtime conferma la composizione chiamando confirmComposition() nel client. Il runtime reimposta inoltre l'IME per informare il sistema operativo che la composizione è stata abbandonata.
compositionSelectionChanged | () | metodo |
public static function compositionSelectionChanged(start:int, end:int):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2 |
Chiamate questo metodo quando la selezione all'interno della composizione è stata aggiornata, sia in modo interattivo che a livello di programmazione.
Parametri
start:int — Specifica l'offset in byte dell'inizio della selezione.
| |
end:int — Specifica l'offset in byte dalla fine della selezione.
|
doConversion | () | metodo |
setCompositionString | () | metodo |
public static function setCompositionString(composition:String):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Imposta la stringa di composizione IME. Una volta impostata, l'utente può selezionare i candidati IME prima di eseguire il commit del risultato nel campo di testo attualmente attivo.
Se non è attivo alcun campo di testo, questo metodo dà esito negativo e genera un errore.
Parametri
composition:String — La stringa da inviare all'IME.
|
Genera
Error — La chiamata dà esito negativo.
|
imeComposition | Evento |
flash.events.IMEEventproprietà IMEEvent.type =
flash.events.IMEEvent.IME_COMPOSITION| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Inviato quando un utente ha completato una composizione IME e la stringa di lettura è disponibile. Gli IME vengono solitamente utilizzati per immettere del testo in una lingua composta da ideogrammi invece che da lettere, come, ad esempio, il giapponese, il cinese e il coreano.
Definisce il valore della proprietàtype di un oggetto evento imeComposition.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto IME. |
Altri esempi
Tue Jun 12 2018, 02:44 PM Z