Функция ImmGetConversionListW (immdev.h)

Статья
11/20/2024

Извлекает список результатов преобразования символов или слов без создания сообщений, связанных с IME.

Синтаксис

DWORD ImmGetConversionListW(
        HKL             unnamedParam1,
        HIMC            unnamedParam2,
  [in]  LPCWSTR         lpSrc,
  [out] LPCANDIDATELIST lpDst,
  [in]  DWORD           dwBufLen,
  [in]  UINT            uFlag
);

Параметры

unnamedParam1

unnamedParam2

[in] lpSrc

Указатель на строку символов, завершающую значение NULL, указывающую источник списка.

[out] lpDst

Указатель на структуру CANDIDATELIST, в которой функция извлекает список.

[in] dwBufLen

Размер в байтах выходного буфера. Приложение задает этому параметру значение 0, если функция возвращает размер буфера, необходимый для полного списка результатов преобразования.

[in] uFlag

Флаг действия. Этот параметр может иметь одно из следующих значений.

Ценность	Значение
GCL_CONVERSION	Исходная строка — это строка чтения. Функция копирует строку результата в целевой буфер.
GCL_REVERSECONVERSION	Исходная строка — это строка результата. Функция копирует строку чтения в целевой буфер.
GCL_REVERSE_LENGTH	Исходная строка — это строка результата. Функция возвращает размер в байтах строки чтения, созданной при указании GCL_REVERSECONVERSION.

Возвращаемое значение

Возвращает количество байтов, скопированных в выходной буфер. Если приложение задает параметру dwBufLen значение 0, функция возвращает размер в байтах требуемого выходного буфера.

Замечания

Заметка

Заголовок immdev.h определяет ImmGetConversionList как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения], установленная поддержка языка Восточной Азии.
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	immdev.h (include Immdev.h, Windows.h)
библиотеки	Imm32.lib
DLL	Imm32.dll

См. также

КАНДИДАТОВ

диспетчера методов ввода

Функции диспетчера методов ввода

Поделиться через