ITextHost::TxActivate-Methode (textserv.h)

Artikel
08/26/2023

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
E_FAIL	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