Compartilhar via


Propriedade IMEMode

Especifica o modo de tempo de execução padrão do IME (Editor de Método de Entrada) para um controle. Essa propriedade se aplica apenas a aplicativos gravados para o leste da Ásia e é ignorada em outros aplicativos.

Sintaxe

objeto. IMEMode [= fmIMEMode ]

A sintaxe da propriedade IMEMode tem estas partes:

Sair Descrição
objeto Obrigatório. Um objeto válido.
fmIMEMode Opcional. O modo do Editor de Método de Entrada (IME).

Configurações

As configurações para fmIMEMode são:

Constant Valor Descrição
fmIMEModeNoControl 0 Não controla IME (padrão).
fmIMEModeOn 1 IME ativado.
fmIMEModeOff 2 IME desativado. Modo inglês.
fmIMEModeDisable 3 IME desativado. O usuário não pode ativar o IME por teclado.
fmIMEModeHiragana 4 IME ativado com modo Hiragana de largura total.
fmIMEModeKatakana 5 IME ativado com modo Katakana de largura total.
fmIMEModeKatakanaHalf 6 IME ativado com modo Katakana de meia largura.
fmIMEModeAlphaFull 7 IME ativado com modo Alfanumérico de largura total.
fmIMEModeAlpha 8 IME ativado com modo Alfanumérico de meia largura.
fmIMEModeHangulFull 9 IME ativado com modo Hangul de largura total.
fmIMEModeHangul 10 IME ativado com modo Hangul de meia largura.

A configuração fmIMEModeNoControl indica que o modo do IME não é alterado quando o controle recebe o foco em tempo de execução. For any other value, the mode of the IME is set to the value specified by the IMEMode property when the control receives focus at run time.

Comentários

Há duas maneiras de definir o modo do IME. Uma delas é por meio da barra de ferramentas do IME. O outro é com a propriedade IMEMode de um controle, que define ou retorna o modo atual do IME. Essa propriedade permite o controle dinâmico do IME por meio do código.

O exemplo a seguir explica como o IMEMode interage com a barra de ferramentas do IME. Suponha que você tenha projetado um formulário com TextBox1 e CheckBox1. Você definiu TextBox1.IMEMode como 0 e definiu CheckBox1.IMEMode como 1. Enquanto estiver no modo de design, você usou a barra de ferramentas IME para colocar o IME no modo 2.

Quando você executa o formulário, o IME começa no modo 2. Se você clicar em TextBox1, o modo IME não será alterado porque O IMEMode para esse controle é 0. Se você clicar em CheckBox1, o IME será alterado para o modo 1, pois O IMEMode para esse controle é 1. Se você clicar novamente no TextBox1, o IME permanecerá no modo 1 (IMEMode é 0, portanto, o IME manterá sua última configuração).

No entanto, você pode substituir o IMEMode. Por exemplo, suponha que você clique em CheckBox1 e o IME insira o modo 1, conforme definido por IMEMode para a Caixa de Seleção. Se você usar a barra de ferramentas IME para colocar o IME no modo 3, o IME será definido como modo 3 sempre que você clicar no controle. Isso não altera o valor da propriedade; ela substitui a propriedade até a próxima vez que você executar o formulário.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.