EM_GETIMEPROPERTY mensagem

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