Функция ImmGetProperty (imm.h)
Извлекает свойство и возможности редактора, связанного с указанным языковым стандартом ввода.
Синтаксис
DWORD ImmGetProperty(
HKL unnamedParam1,
DWORD unnamedParam2
);
Параметры
unnamedParam1
unnamedParam2
Возвращаемое значение
Возвращает значение свойства или возможности в зависимости от значения параметра dwIndex . Если параметру dwIndex присвоено значение IGP_PROPERTY, функция возвращает одно или несколько из следующих значений:
| Значение | Значение |
|---|---|
| IME_PROP_AT_CARET | Если этот параметр задан, окно преобразования находится в позиции курсора. Если флажок не задан, окно находится рядом с положением курсора. |
| IME_PROP_SPECIAL_UI | Если этот параметр задан, IME имеет нестандартный пользовательский интерфейс. Приложение не должно выполнять рисование в окне IME. |
| IME_PROP_CANDLIST_START_FROM_1 | Если этот параметр задан, строки в списке кандидатов нумеруются начиная с 1. Если значение не задано, строки начинаются с 0. |
| IME_PROP_UNICODE | Если этот параметр задан, IME отображается как IME в Юникоде. Операционная система и IME взаимодействуют через интерфейс IME в Юникоде. Если этот флажок не задан, IME использует интерфейс ANSI для взаимодействия с операционной системой. |
| IME_PROP_COMPLETE_ON_UNSELECT | Если этот параметр задан, IME завершает строку композиции при отключении IME. Если этот флажок не задан, IME отменяет строку композиции при отключении IME, например при изменении раскладки клавиатуры. |
| IME_PROP_ACCEPT_WIDE_VKEY | Если этот параметр задан, IME обрабатывает внедренный Юникод, полученный из функции SendInput , с помощью VK_PACKET. Если этот флажок не задан, IME может не обработать внедренный Юникод и отправить введенный Юникод в приложение напрямую. |
Если параметру dwIndex присвоено значение IGP_UI, функция возвращает одно или несколько из следующих значений:
| Значение | Значение |
|---|---|
| UI_CAP_2700 | Поддержка значений экранирования текста 0 или 2700. Дополнительные сведения см. в разделе Элемент lfEscapement структуры LOGFONT . |
| UI_CAP_ROT90 | Поддерживаются значения экранирования текста 0, 900, 1800 или 2700. Дополнительные сведения см. в разделе lfEscapement. |
| UI_CAP_ROTANY | Поддержка любого значения экранирования текста. Дополнительные сведения см. в разделе lfEscapement. |
Если параметру dwIndex присвоено значение IGP_SETCOMPSTR, функция возвращает одно или несколько из следующих значений:
| Значение | Значение |
|---|---|
| SCS_CAP_COMPSTR | Создайте строку композиции, вызвав функцию ImmSetCompositionString со значением SCS_SETSTR. |
| SCS_CAP_MAKEREAD | Создайте строку чтения из соответствующей строки композиции при использовании функции ImmSetCompositionString с SCS_SETSTR и без настройки lpRead. |
| SCS_CAP_SETRECONVERTSTRING: | Этот IME может поддерживать рековерсия. Используйте ImmSetCompositionString для выполнения рековерсия. |
Если dwIndex имеет значение IGP_SELECT, функция возвращает одно или несколько из следующих значений:
| Значение | Значение |
|---|---|
| SELECT_CAP_CONVMODE | Режим наследования при выборе нового редактора IME. |
| SELECT_CAP_SENTENCE | Режим наследования предложений при выборе нового редактора IME. |
Если параметру dwIndex присвоено значение IGP_GETIMEVERSION, функция возвращает одно или несколько из следующих значений:
| Значение | Значение |
|---|---|
| IMEVER_0310 | IME был создан для Windows 3.1. |
| IMEVER_0400 | IME был создан для Windows Me/98/95. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только для классических приложений], установленная поддержка восточноазиатских языков. |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imm.h (включая Immdev.h, Windows.h) |
| Библиотека | Imm32.lib |
| DLL | Imm32.dll |