Функция ImmGetConversionListA (imm.h)

  • Статья

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

Синтаксис

DWORD ImmGetConversionListA(
        HKL             unnamedParam1,
        HIMC            unnamedParam2,
  [in]  LPCSTR          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, функция возвращает размер требуемого выходного буфера в байтах.

Комментарии

Примечание

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

Требования

   
Минимальная версия клиента Windows XP [только классические приложения], установленная поддержка восточноазиатских языков.
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imm.h (включая Immdev.h, Windows.h)
Библиотека Imm32.lib
DLL Imm32.dll

См. также раздел

СПИСОК КАНДИДАТОВ

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

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