IOleInPlaceActiveObject::OnDocWindowActivate-Methode (oleidl.h)

Benachrichtigt das aktive direkte Objekt, wenn das Dokumentfenster des Containers aktiviert oder deaktiviert wird.

Syntax

HRESULT OnDocWindowActivate(
  [in] BOOL fActivate
);

Parameter

[in] fActivate

Der Status des untergeordneten MDI-Dokumentfensters. Wenn dieser Parameter TRUE ist, befindet sich das Fenster im Akt der Aktivierung. wenn es FALSE ist, wird er deaktiviert.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück.

Hinweise

Hinweise für Anrufer

Rufen Sie IOleInPlaceActiveObject::OnDocWindowActivate auf , wenn das untergeordnete MDI-Dokumentfenster aktiviert oder deaktiviert ist und das Objekt derzeit das aktive Objekt für das Dokument ist.

Hinweise für Implementierer

Sie sollten Code in diese Methode einschließen, der Tools auf Frameebene während der Objektaktivierung installiert. Zu diesen Tools gehören das freigegebene zusammengesetzte Menü und/oder optionale Symbolleisten und Rahmenschmuck. Sie sollten sich dann konzentrieren. Beim Deaktivieren sollte das Objekt die Tools auf Frameebene entfernen. Wenn Sie IOleInPlaceUIWindow::SetBorderSpace nicht aufrufen, wobei pborderwidths auf NULL festgelegt ist, können Sie vermeiden, dass Sie den Rahmenraum neu aushandeln müssen.

Führen Sie beim Ausführen von IOleInPlaceActiveObject::OnDocWindowActivate keine Aufrufe an die Funktionen PeekMessage , GetMessage oder ein Dialogfeld aus. Dies kann zu einem Deadlock des Systems führen. Es gibt weitere Einschränkungen, welche OLE-Schnittstellenmethoden und -funktionen innerhalb von IOleInPlaceActiveObject::OnDocWindowActivate aufgerufen werden können.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleidl.h

Weitere Informationen

GetMessage

IOleInPlaceActiveObject

PeekMessage