IOleDocumentView::GetRect-Methode (docobj.h)

Ruft die rechteckigen Koordinaten des Viewports ab, in dem sich die Ansicht befindet oder aktiviert wird.

Syntax

HRESULT GetRect(
  [out] LPRECT prcView
);

Parameter

[out] prcView

Ein Zeiger auf eine RECT-Struktur , die die Koordinaten des aktuellen Viewportsatzes mit IOleDocumentView::SetRect enthält.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_UNEXPECTED	Diese Ansicht hat noch keinen Aufruf von IOleDocumentView::SetRect oder IOleDocumentView::SetRectComplex gesehen und verfügt daher über kein zurückzugebende Rechteck.

Hinweise

Bei einer SDI-Anwendung (Single Document Interface) ist der Viewport der Clientbereich des Framefensters abzüglich des Speicherplatzes, der für Symbolleisten, status Leiste usw. zugewiesen ist. Bei einem MDI-Fenster (Multiple Document Interface) ist der Viewport der Clientbereich des MDI-Dokumentfensters abzüglich aller anderen Benutzeroberflächenelemente auf Frameebene.

Die von dieser Methode abgerufenen Viewportkoordinaten sind diejenigen, die im letzten Aufruf von IOleDocumentView::SetRect oder IOleDocumentView::SetRectComplex festgelegt wurden.

Eine Dokumentansicht muss diese Methode vollständig implementieren. E_NOTIMPL ist kein zulässiger Rückgabewert.

Anforderungen

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

Weitere Informationen

IOleDocumentView

IOleDocumentView::SetRect

IOleDocumentView::SetRectComplex