flash.system.IME (ActionScript 3.0)

Pacchetto	flash.system
Classe	public final class IME
Ereditarietà	IME EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

La classe IME consente di manipolare direttamente l'IME (Input Method Editor) del sistema operativo all'interno dell'applicazione Flash Player in esecuzione su un computer client. È possibile determinare se un IME è installato, se è attualmente abilitato o disabilitato, e quale IME è abilitato. È possibile abilitare o disabilitare l'IME nell'applicazione Flash Player ed eseguire altre funzioni limitate, a seconda del sistema operativo in uso.

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, consultare la documentazione del sistema operativo per il quale si stanno sviluppando delle applicazioni. Per consultare ulteriori risorse, vedere i siti Web seguenti:

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 si utilizza 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
Determinare se l'IME è installato: `Capabilities.hasIME`	Sì	Sì
Abilitare o disabilitare l'IME: `IME.enabled`	Sì	Sì
Verificare se l'IME è abilitato o disabilitato: `IME.enabled`	Sì	Sì
Ottenere o impostare la modalità di conversione IME: `IME.conversionMode`	Sì	Sì **
Inviare all'IME la stringa da convertire: `IME.setCompositionString()`	Sì *	No
Ottenere dall'IME la stringa originale prima della conversione: `System.ime.addEventListener()`	Sì *	No
Inviare la richiesta di conversione all'IME: `IME.doConversion()`	Sì *	No

* Non tutti gli IME Windows supportano tutte queste operazioni. L'unico IME che le supporta tutte è quello giapponese.

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

Vedere anche

Uso della classe IME

	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
		prototype: Object [statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.	Object

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	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
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		doConversion():void [statico] Indica all'IME di selezionare il primo candidato per la stringa di composizione corrente.	IME
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setCompositionString(composition:String):void [statico] Imposta la stringa di composizione IME.	IME
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Riepilogo	Definito da
activate	Inviato quando Flash Player riceve lo stato di attivazione del sistema operativo e diventa attivo.	EventDispatcher
deactivate	Inviato quando Flash Player perde lo stato di attivazione del sistema operativo e sta per diventare inattivo.	EventDispatcher
imeComposition	Inviato quando un utente ha completato una composizione IME e la stringa di lettura è disponibile.	IME

Descrizione delle proprietà

conversionMode

proprietà

conversionMode:String [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

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_FULL
ALPHANUMERIC_HALF
CHINESE
JAPANESE_HIRAGANA
JAPANESE_KATAKANA_FULL
JAPANESE_KATAKANA_HALF
KOREAN
UNKNOWN (sola lettura; questo valore non può essere impostato)

Implementazione
public static function get conversionMode():String
public function set conversionMode(value:String):void

Genera

Error — Un tentativo di impostazione ha dato esito negativo.

Vedere anche

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
Uso della classe IME

enabled

proprietà

enabled:Boolean [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

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 function set enabled(value:Boolean):void

Genera

Error — Un tentativo di impostazione ha dato esito negativo.

Vedere anche

Uso della classe IME

Descrizione dei metodi

doConversion

()

metodo

public static function doConversion():void

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Indica all'IME di selezionare il primo candidato per la stringa di composizione corrente.

Genera

Error — La chiamata dà esito negativo.

setCompositionString

()

metodo

public static function setCompositionString(composition:String):void

Versione linguaggio:

ActionScript 3.0

Versione lettore:

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.

Descrizione degli eventi

imeComposition

Evento

Tipo di oggetto evento: flash.events.IMEEvent
IMEEvent.type property = flash.events.IMEEvent.IME_COMPOSITION

Versione linguaggio:

ActionScript 3.0

Versione lettore:

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.

Vedere anche

Uso della classe IME

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/system/IME.html

Guida di riferimento del linguaggio e dei componenti ActionScript 3.0		Tutti i pacchetti \| Tutte le classi \| Elementi del linguaggio \| Indice \| Appendici \| Convenzioni \| Con frame Senza frame
IME	Proprietà \| Metodi \| Eventi