EM_GETIMEPROPERTY mensagem

  • Artigo

Recupera a propriedade e os recursos do IME (Editor de Método de Entrada) associado à localidade de entrada atual.

Parâmetros

wParam

Especifica o tipo de informações de propriedade a serem recuperadas. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
IGP_PROPERTY
 Informações da propriedade.
IGP_CONVERSION
 Recursos de conversão.
IGP_SENTENCE
 Recursos de modo de frase.
IGP_UI
 Funcionalidades da interface do usuário.
IGP_SETCOMPSTR
 Recursos de cadeia de caracteres de composição.
IGP_SELECT
 Recursos de herança de seleção.
IGP_GETIMEVERSION
 Recupera o número de versão do sistema para o qual o IME especificado foi criado.

lParam

Não usado; deve ser zero.

Valor retornado

Retorna o valor da propriedade ou da funcionalidade, dependendo do valor do parâmetro lParam . Para obter mais informações, consulte Comentários.

Comentários

Se wParam for IGP_PROPERTY, ele retornará um ou mais dos valores a seguir.

Requisito Valor
IME_PROP_AT_CARET Se definido, a janela de conversão estará na posição do cursor. Se estiver claro, a janela estará perto da posição do cursor.
IME_PROP_SPECIAL_UI Se definido, o IME terá uma interface do usuário não padrão. O aplicativo não deve desenhar na janela IME.
IME_PROP_CANDLIST_START_FROM_1 Se definido, as cadeias de caracteres na lista de candidatos serão numeradas a partir de 1. Se estiver claro, as cadeias de caracteres começarão em zero.
IME_PROP_UNICODE Se definido, o IME será exibido como um UnicodeIME. O sistema e o IME se comunicarão por meio da interface UnicodeIME. Se estiver claro, o IME usará a interface ANSI para se comunicar com o sistema.
IME_PROP_COMPLETE_ON_UNSELECT Se definido, a janela de conversão estará na posição do cursor. Se estiver claro, a janela estará perto da posição do cursor.
IME_PROP_ACCEPT_WIDE_VKEY Se definido, o IME processará o Unicode injetado proveniente da função SendInput usando VK_PACKET. Se estiver claro, o IME poderá não processar o Unicode injetado e o Unicode injetado poderá ser enviado diretamente ao aplicativo.

Se wParam for IGP_UI, ele retornará um ou mais dos valores a seguir.

Requisito Valor
UI_CAP_2700 Dá suporte a valores de escape de texto de 0 ou 2700. Para obter mais informações, consulte lfEscapement.
UI_CAP_ROT90 Dá suporte a valores de escape de texto de 0, 900, 1800 ou 2700. Para obter mais informações, consulte lfEscapement.
UI_CAP_ROTANY Dá suporte a qualquer valor de escape de texto. Para obter mais informações, consulte lfEscapement.

Se wParam for IGP_SETCOMPSTR, ele retornará um ou mais dos valores a seguir.

Requisito Valor
SCS_CAP_COMPSTR Pode criar a cadeia de caracteres de composição chamando a função ImmSetCompositionString com o valor SCS_SETSTR.
SCS_CAP_MAKEREAD Pode criar a cadeia de caracteres de leitura da cadeia de caracteres de composição correspondente ao usar a função ImmSetCompositionString com SCS_SETSTR e sem definir lpRead.
SCS_CAP_SETRECONVERTSTRING Esse IME pode dar suporte à reconversão. Use ImmSetCompositionString para fazer a reconversão.

Se wParam for IGP_SELECT, ele retornará um ou mais dos valores a seguir.

Requisito Valor
SELECT_CAP_CONVMODE Herda o modo de conversão quando um novo IME é selecionado.
SELECT_CAP_SENTENCE Herda o modo de frase quando um novo IME é selecionado.

Se wParam for IGP_GETIMEVERSION, ele retornará um ou mais dos valores a seguir.

Requisito Valor
IMEVER_0310 O IME foi criado para o Windows 3.1.
IMEVER_0400 O IME foi criado para o Windows 95 ou posterior

Essa mensagem é semelhante a ImmGetProperty, exceto que ela usa a localidade de entrada atual. O aplicativo deve chamar EM_ISIME antes de chamar essa função.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Richedit.h

Confira também

Referência

EM_ISIME

Outros recursos

ImmGetProperty