Pacote | flash.system |
Classe | public final class IME |
Herança | IME EventDispatcher Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Suporte a perfil do AIR: esse recurso possui suporte para sistemas operacionais de computador, mas não tem suporte para dispositivos móveis. Também não é compatível com dispositivos AIR for TV. Você pode testar o suporte em tempo de execução usando a propriedade IME.isSupported
. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Os IMEs permitem a usuários digitar caracteres de texto não ASCII em idiomas com vários bytes, como chinês, japonês e coreano. Para obter mais informações sobre como trabalhar com os IMEs, consulte a documentação do sistema operacional no qual você está desenvolvendo aplicativos. Para obter recursos adicionais, consulte os seguintes sites:
- http://www.microsoft.com/globaldev/default.mspx_br
- http://developer.apple.com/documentation/_br
- http://java.sun.com_br
Se o IME não estiver ativo no computador do usuário, chamadas para métodos ou propriedades do IME, que não sejam Capabilities.hasIME
, falharão. Depois de ativar manualmente o IME, chamadas subsequentes do ActionScript para métodos e propriedades do IME funcionarão conforme o esperado. Por exemplo, se você estiver usado um IME Japonês, ele deverá ser ativado antes de qualquer método ou propriedade do IME ser chamada.
A tabela a seguir mostra a cobertura de plataforma dessa classe:
Capability | Windows | Mac OSX | Linux |
---|---|---|---|
Determine se o IME está instalado: Capabilities.hasIME
| Sim | Sim | Sim |
Defina o IME como ativado ou desativado: IME.enabled
| Sim | Sim | Sim |
Descubra se o IME está ativado ou desativado: IME.enabled
| Sim | Sim | Sim |
Obtenha ou defina o modo de conversão do IME: IME.conversionMode
| Sim | Sim ** | Não |
Envie ao IME a string a ser convertida: IME.setCompositionString()
| Sim * | Não | Não |
Obtenha do IME a string original antes da conversão: System.ime.addEventListener()
| Sim * | Não | Não |
Envie solicitação de conversão para IME: IME.doConversion()
| Sim * | Não | Não |
* Nem todos os IMEs do Windows oferecem suporte a todas essas operações. O único IME que suporta todas as operações é o IME japonês.
** No Macintosh, apenas o IME japonês oferece suporte a esses métodos ao contrário de IMEs de terceiros.
A versão ActionScript 3.0 dessa classe não oferece suporte ao Macintosh Classic.
Propriedade | Definido por | ||
---|---|---|---|
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
conversionMode : String [estático]
O modo de conversão do IME atual. | IME | ||
enabled : Boolean [estático]
Indica se o IME do sistema está ativado (true) ou desativado (false). | IME | ||
isSupported : Boolean [estático] [somente leitura]
A propriedade isSupported será definida como true se a classe IME for suportada na plataforma atual; de outra maneira, ela será definida como false. | IME |
Método | Definido por | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | ||
[estático]
Faz com que o tempo de execução abandone qualquer composição que está em progresso. | IME | ||
[estático]
Chame este método quando a seleção dentro da composição tiver sido atualizada interativa ou programaticamente. | IME | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
[estático]
Instrui o IME a selecionar o primeiro candidato para a string de composição atual. | IME | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
[estático]
Define a string de composição do IME. | IME | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Retorna o valor primitivo do objeto especificado. | Object | ||
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher |
Evento | Resumo | Definido por | ||
---|---|---|---|---|
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
Despachado quando um usuário concluiu uma composição do IME (editor de métodos de entrada) e a string de leitura está disponível. | IME |
conversionMode | propriedade |
conversionMode:String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
O modo de conversão do IME atual. Os valores possíveis são constantes de string de modo IME que indicam o modo de conversão:
ALPHANUMERIC_FULL
ALPHANUMERIC_HALF
CHINESE
JAPANESE_HIRAGANA
JAPANESE_KATAKANA_FULL
JAPANESE_KATAKANA_HALF
KOREAN
UNKNOWN
(valor somente leitura, este valor não pode ser definido)
Implementação
public static function get conversionMode():String
public static function set conversionMode(value:String):void
Lança
Error — A tentativa de definição não foi bem-sucedida.
|
Elementos da API relacionados
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 | propriedade |
enabled:Boolean
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Indica se o IME do sistema está ativado (true
) ou desativado (false
). O IME ativado realiza entradas de multibyte, o IME desativado realiza entradas alfanuméricas.
Implementação
public static function get enabled():Boolean
public static function set enabled(value:Boolean):void
Lança
Error — A tentativa de definição não foi bem-sucedida.
|
isSupported | propriedade |
isSupported:Boolean
[somente leitura] Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10.1, AIR 2 |
A propriedadeisSupported
será definida como true
se a classe IME for suportada na plataforma atual; de outra maneira, ela será definida comofalse
.
Implementação
public static function get isSupported():Boolean
compositionAbandoned | () | método |
public static function compositionAbandoned():void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10.1, AIR 2 |
Faz com que o tempo de execução abandone qualquer composição que está em progresso. Invoque este método quando o usuário clicar fora da área de composição ou quando o objeto interativo que tem o foco está sendo destruído ou reinicializado. O tempo de execução confirma a composição chamando confirmComposition()
no cliente. O tempo de execução também reinicia o IME para informar o sistema operacional que a composição foi abandonada.
compositionSelectionChanged | () | método |
public static function compositionSelectionChanged(start:int, end:int):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 10.1, AIR 2 |
Chame este método quando a seleção dentro da composição tiver sido atualizada interativa ou programaticamente.
Parâmetros
start:int — Especifica o deslocamento em bytes do início da seleção.
| |
end:int — Especifica o deslocamento em bytes do fim da seleção.
|
doConversion | () | método |
setCompositionString | () | método |
public static function setCompositionString(composition:String):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Define a string de composição do IME. Quando a string é definida, o usuário pode selecionar candidatos IME antes de confirmar o resultado no campo de texto que tem o foco no momento.
Se nenhum campo de texto tiver foco, esse método falhará e lançará um erro.
Parâmetros
composition:String — A string a enviar para o IME.
|
Lança
Error — A chamada não foi bem-sucedida.
|
imeComposition | Evento |
flash.events.IMEEvent
propriedade IMEEvent.type =
flash.events.IMEEvent.IME_COMPOSITION
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9 |
Despachado quando um usuário concluiu uma composição do IME (editor de métodos de entrada) e a string de leitura está disponível. IMEs são usados geralmente para digitar textos de idiomas com símbolos em vez de letras, como japonês, chinês e coreano.
Define o valor da propriedadetype
de um objeto de evento imeComposition
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto IME. |
Wed Jun 13 2018, 11:10 AM Z