ITfThreadMgrEx::ActivateEx-Methode (msctf.h)

Artikel
03/04/2024

Die ITfThreadMgrEx::ActivateEx-Methode wird von einer Anwendung verwendet, um TSF für den aufrufenden Thread zu initialisieren und zu aktivieren. Im Gegensatz zu ITfThreadMgr::Activate kann ITfThreadMgrEx::ActivateEx ein Flag verwenden, um anzugeben, wie TSF aktiviert wird.

Syntax

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

Parameter

[out] ptid

[out] Zeiger auf einen TfClientId-Wert , der einen Clientbezeichner empfängt.

[in] dwFlags

Wert	Bedeutung
TF_TMAE_NOACTIVATETIP	Textdienste werden nicht aktiviert, während ITfThreadMgrEx::ActivateEx aufgerufen wird. Sie werden aktiviert, wenn der aufrufende Thread asynchron den Fokus hat.
TF_TMAE_SECUREMODE	TSF wird im sicheren Modus aktiviert. Nur Textdienste, die den sicheren Modus unterstützen, werden aktiviert.
TF_TMAE_UIELEMENTENABLEDONLY	TSF aktiviert nur Textdienste, die in GUID_TFCAT_TIPCAP_UIELEMENTENABLED kategorisiert sind.
TF_TMAE_COMLESS	TSF verwendet com nicht. TSF aktiviert nur Textdienste, die in GUID_TFCAT_TIPCAP_COMLESS kategorisiert sind.
TF_TMAE_NOACTIVATEKEYBOARDLAYOUT	TSF synchronisiert das aktuelle Tastaturlayout nicht, während ITfThreadMgrEx::ActivateEx() aufgerufen wird. Das Tastaturlayout wird angepasst, wenn der aufrufende Thread den Fokus erhält. Dieses Flag muss mit TF_TMAE_NOACTIVATETIP verwendet werden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfThreadMgr::Activate

ITfThreadMgrEx

Freigeben über