ITfTextInputProcessor::Activate-Methode (msctf.h)

Aktiviert einen Textdienst, wenn eine Benutzersitzung gestartet wird.

Syntax

HRESULT Activate(
  [in] ITfThreadMgr *ptim,
  [in] TfClientId   tid
);

Parameter

[in] ptim

Zeiger auf die ITfThreadMgr-Schnittstelle für den Thread-Manager, der besitzer des Textdiensts ist.

[in] tid

Gibt den Clientbezeichner für den Textdienst an.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

TSF ruft diese Methode auf, nachdem eine instance eines Textdiensts mit einem Aufruf von CoCreateInstance erstellt wurde. Dies ermöglicht Vorgänge, die zum Starten des Textdiensts erforderlich sind.

Diese Methode fügt in der Regel einen Verweis auf den Thread-Manager für die Sitzung hinzu und rät Senken für Ereignisse, die den Textdienst betreffen, z. B. Fokusänderung, Tastaturanschläge und Fensterereignisse. Außerdem wird die Sprachleiste für den Textdienst angepasst.

Die entsprechende ITfTextInputProcessor::D eactivate-Methode , die den Textdienst herunterfährt, muss alle Verweise auf den ptim-Parameter freigeben.

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	Sptip.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfTextInputProcessor

ITfTextInputProcessor::D eactivate

ITfThreadMgr