ITextHost::TxActivate-Methode (textserv.h)
Benachrichtigt den Texthost, dass das Steuerelement aktiv ist.
HRESULT TxActivate(
LONG *plOldState
);
plOldState
Typ: LONG*
Der vorherige Aktivierungsstatus.
Typ: HRESULT
Gibt S_OK zurück, wenn die Methode erfolgreich ist.
Geben Sie den folgenden COM-Fehlercode zurück, wenn die Methode fehlschlägt. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Aktivierung ist derzeit nicht möglich. |
Es ist legal, dass der Host eine Aktivierungsanfrage ablehnt. beispielsweise kann das Steuerelement minimiert und somit unsichtbar sein.
Der Aufrufer sollte in der Lage sein, fehlerbehaftete Aktivierung ordnungsgemäß zu behandeln.
Unabhängig davon, wie oft diese Methode aufgerufen wird, ist nur ein ITextHost::TxDeactivate-Aufruf erforderlich, um das Steuerelement zu deaktivieren.
Diese Funktion gibt ein undurchsichtiges Handle in plOldState zurück. Der Aufrufer (das Textdienstobjekt) sollte dieses Handle speichern und in einem nachfolgenden Aufruf von ITextHost::TxDeactivate verwenden.
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | textserv.h |
| DLL | Msftedit.dll |
Konzept
Referenz