Метод ITfInputProcessorProfiles::AddLanguageProfile (msctf.h)

Статья
08/24/2023

Создает языковой профиль, состоящий из определенной службы текста и определенного идентификатора языка.

Синтаксис

HRESULT AddLanguageProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
  [in] const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
  [in] const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex
);

Параметры

[in] rclsid

Содержит CLSID службы текста.

[in] langid

Содержит значение LANGID , указывающее идентификатор языка профиля, в который добавляется служба текста. Если параметр содержит значение -1, служба текста добавляется на все языки.

[in] guidProfile

Содержит значение GUID, идентифицирующее языковой профиль. Это значение, полученное ITfInputProcessorProfiles::GetActiveLanguageProfile , когда профиль активен.

[in] pchDesc

Указатель на буфер WCHAR , содержащий строку описания для текстовой службы в профиле. Это имя текстовой службы, отображаемое на языковой панели.

[in] cchDesc

Содержит длину (в символах) строки описания в pchDesc. Если параметр содержит значение -1, предполагается, что pchDesc является строкой, завершаемой значением NULL.

[in] pchIconFile

Указатель на буфер WCHAR , содержащий путь и имя файла со значком, отображаемым на языковой панели для текстовой службы в профиле. Этот файл может быть исполняемым (.exe), DLL-файлом (.dll) или файлом значка (.ico).

Этот параметр является необязательным и может иметь значение NULL. В этом случае для службы текста отображается значок по умолчанию.

[in] cchFile

Содержит длину (в символах) строки файла значка в файле pchIconFile. Если параметр содержит значение -1, предполагается, что pchIconFile является строкой, завершающейся значением NULL. Этот параметр игнорируется, если pchIconFile имеет значение NULL.

[in] uIconIndex

Содержит отсчитываемый от нуля индекс значка в pchIconFile , отображаемый на языковой панели для текстовой службы в профиле. Этот параметр игнорируется, если pchIconFile имеет значение NULL.

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

Этот метод может возвращать одно из этих значений.

Значение	Описание
S_OK	Метод выполнен успешно.
E_FAIL	Произошла неизвестная ошибка.
E_INVALIDARG	Недопустимый pszDesc .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	msctf.h
DLL	Msctf.dll
Распространяемые компоненты	TSF 1.0 в Windows 2000 Профессиональная

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

ITfInputProcessorProfiles

ITfInputProcessorProfiles::GetActiveLanguageProfile

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