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

Confira também

ImmSetCompositionString

Gerenciador de Métodos de Entrada

Funções do Gerenciador de Métodos de Entrada