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

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

Синтаксис

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.

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

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

Требования

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

ITfInputProcessorProfiles

ITfInputProcessorProfiles::GetActiveLanguageProfile