Метод ITfThreadMgrEx::ActivateEx (msctf.h)

Статья
08/24/2023

Метод ITfThreadMgrEx::ActivateEx используется приложением для инициализации и активации TSF для вызывающего потока. В отличие от ITfThreadMgr::Activate, ITfThreadMgrEx::ActivateEx может принимать флаг для указания способа активации TSF.

Синтаксис

HRESULT ActivateEx(
  [out] TfClientId *ptid,
  [in]  DWORD      dwFlags
);

Параметры

[out] ptid

[out] Указатель на значение TfClientId , которое получает идентификатор клиента.

[in] dwFlags

Значение	Значение
TF_TMAE_NOACTIVATETIP	Текстовые службы не будут активированы при вызове ITfThreadMgrEx::ActivateEx. Они будут активированы, когда вызывающий поток имеет фокус асинхронно.
TF_TMAE_SECUREMODE	TSF активируется в безопасном режиме. Будут активированы только текстовые службы, поддерживающие безопасный режим.
TF_TMAE_UIELEMENTENABLEDONLY	TSF активирует только текстовые службы, которые классифицируются в GUID_TFCAT_TIPCAP_UIELEMENTENABLED.
TF_TMAE_COMLESS	TSF не использует COM. TSF активирует только текстовые службы, которые классифицируются в GUID_TFCAT_TIPCAP_COMLESS.
TF_TMAE_NOACTIVATEKEYBOARDLAYOUT	TSF не синхронизирует текущую раскладку клавиатуры при вызове ITfThreadMgrEx::ActivateEx(). Раскладка клавиатуры будет изменена, когда вызывающий поток получает фокус. Этот флаг необходимо использовать с TF_TMAE_NOACTIVATETIP.

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

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

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

Требования

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

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

ITfThreadMgr::Activate

ITfThreadMgrEx

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