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 |