Compartilhar via


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