ITextServices::OnTxInPlaceDeactivate-Methode (textserv.h)

Artikel
03/04/2024

Benachrichtigt das Textdienstobjekt, dass dieses Steuerelement nicht mehr aktiv ist.

Syntax

HRESULT OnTxInPlaceDeactivate();

Rückgabewert

Typ: HRESULT

Der Rückgabewert ist immer S_OK.

Hinweise

Die direkte Aktivierung bezieht sich auf ein eingebettetes Objekt, das direkt ausgeführt wird (bei regulären Steuerelementen und Einbettungen würde es z. B. über ein Fenster zum Zeichnen verfügen). Im Gegensatz dazu bedeutet "Aktiv", dass ein Objekt derzeit den Bearbeitungsfokus hat. Insbesondere können Elemente wie Menüs und Symbolleisten im Container auch Elemente aus dem aktiven Steuerelement/Einbetten der Benutzeroberfläche enthalten. Es kann nur ein ui-aktives Steuerelement zu einem bestimmten Zeitpunkt geben, während viele gleichzeitig aktiv sein können.

Beachten Sie, dass sich die Aktivierung der Benutzeroberfläche vom Fokus unterscheidet. Um dem Textdienstobjekt mitzuteilen, dass das Steuerelement den Fokus erhält oder verliert, sendet der Host WM_SETFOCUS und WM_KILLFOCUS Nachrichten. Beachten Sie außerdem, dass ein fensterloser Host NULL als wParam (Fenster, das den Fokus verloren hat) für diese Nachrichten übergibt.

Beim Übergang vom Aktiv-Zustand der Benutzeroberfläche zu einem nicht aktiven Zustand sollte der Host zuerst ITextServices::OnTxUIDeactivate und dann ITextServices::OnTxInPlaceDeactivate aufrufen.

Anforderungen

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