ITextServices::OnTxInPlaceActivate-Methode (textserv.h)

Artikel
08/26/2023

Benachrichtigt das Textdienstobjekt, dass dieses Steuerelement an Ort und Stelle aktiv ist.

Syntax

HRESULT OnTxInPlaceActivate(
  [in] LPCRECT prcClient
);

Parameter

[in] prcClient

Typ: const RECT*

Das Clientrechteck des Steuerelements.

Rückgabewert

Typ: HRESULT

Wenn das Objekt erfolgreich aktiviert wurde, wird der Rückgabewert S_OK.

Wenn das Objekt aufgrund eines Fehlers nicht aktiviert werden konnte, wird der Rückgabewert E_FAIL. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Hinweise

In-situ aktiv bedeutet, dass ein eingebettetes Objekt direkt ausgeführt wird (z. B. für reguläre Steuerelemente und Einbettungen hätte es ein Fenster zum Zeichnen). Im Gegensatz dazu bedeutet die Aktive Benutzeroberfläche, dass ein Objekt derzeit den Bearbeitungsfokus hat. Beispielsweise können Auch Menüs und Symbolleisten im Container Elemente aus dem steuerelement/einbetten der Benutzeroberfläche enthalten. Es gibt nur ein benutzeroberflächenaktives Steuerelement zu einem bestimmten Zeitpunkt, während es viele direkte aktive Steuerelemente geben kann.

Beachten Sie, dass sich die Aktivierung der Benutzeroberfläche von der Zentrierung unterscheidet. Um dem Textdienstobjekt zu signalisieren, 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 direkten Übergang von einem nicht aktiven Zustand in den Zustand "Aktiv" der Benutzeroberfläche sollte der Host zuerst ITextServices::OnTxInPlaceActivate und dann ITextServices::OnTxUIActivate aufrufen.

ITextServices::OnTxInPlaceActivate verwendet als Parameter das Clientrechteck der aktivierten Ansicht. Dieses Rechteck wird in Clientkoordinaten des enthaltenden Fensters angegeben. Es ist identisch mit dem abrufen, wenn TxGetClientRect auf dem Host aufgerufen wird.

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