Freigeben über


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

Siehe auch

Konzept

ITextHost

Referenz

TxDeaktivieren

Fensterlose Rich-Edit-Steuerelemente