Função ImmGetProperty (imm.h)
Recupera a propriedade e os recursos do IME associados à localidade de entrada especificada.
Sintaxe
DWORD ImmGetProperty(
HKL unnamedParam1,
DWORD unnamedParam2
);
Parâmetros
unnamedParam1
unnamedParam2
Valor retornado
Retorna a propriedade ou o valor da funcionalidade, dependendo do valor do parâmetro dwIndex . Se dwIndex estiver definido como IGP_PROPERTY, a função retornará um ou mais dos seguintes valores:
| Valor | Significado |
|---|---|
| IME_PROP_AT_CARET | Se definido, a janela de conversão estará na posição de cursor. Se estiver claro, a janela estará próxima à posição de 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çam em 0. |
| IME_PROP_UNICODE | Se definido, o IME será exibido como um IME Unicode. O sistema operacional e o IME se comunicam por meio da interface IME Unicode. Se estiver claro, o IME usará a interface ANSI para se comunicar com o sistema operacional. |
| IME_PROP_COMPLETE_ON_UNSELECT | Se definido, o IME concluirá a cadeia de caracteres de composição quando o IME for desativado. Se estiver claro, o IME cancelará a cadeia de caracteres de composição quando o IME for desativado, por exemplo, de uma alteração de layout de teclado. |
| 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 pode não processar o Unicode injetado e pode enviar o Unicode injetado diretamente para o aplicativo. |
Se dwIndex estiver definido como IGP_UI, a função retornará um ou mais dos seguintes valores:
| Valor | Significado |
|---|---|
| UI_CAP_2700 | Suporte a valores de escape de texto de 0 ou 2700. Para obter mais informações, consulte o membro lfEscapement da estrutura LOGFONT . |
| UI_CAP_ROT90 | 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 dwIndex estiver definido como IGP_SETCOMPSTR, a função retornará um ou mais dos seguintes valores:
| Valor | Significado |
|---|---|
| SCS_CAP_COMPSTR | Crie a cadeia de caracteres de composição chamando a função ImmSetCompositionString com o valor SCS_SETSTR. |
| SCS_CAP_MAKEREAD | Crie 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 dwIndex estiver definido como IGP_SELECT, a função retornará um ou mais dos seguintes valores:
| Valor | Significado |
|---|---|
| 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 dwIndex estiver definido como IGP_GETIMEVERSION, a função retornará um ou mais dos seguintes valores:
| Valor | Significado |
|---|---|
| IMEVER_0310 | O IME foi criado para o Windows 3.1. |
| IMEVER_0400 | O IME foi criado para o Windows Me/98/95. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho], suporte ao idioma do Leste Asiático instalado. |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imm.h (inclua Immdev.h, Windows.h) |
| Biblioteca | Imm32.lib |
| DLL | Imm32.dll |