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 |