ITextHost::TxActivate-Methode (textserv.h)
Benachrichtigt den Texthost, dass das Steuerelement aktiv ist.
Syntax
HRESULT TxActivate(
LONG *plOldState
);
Parameter
plOldState
Typ: LONG*
Der vorherige Aktivierungsstatus.
Rückgabewert
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. |
Hinweise
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.
Anforderungen
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 |
Siehe auch
Konzept
Referenz