IOleDocumentView::SetRect-Methode (docobj.h)
Legt die rechteckigen Koordinaten des Viewports fest, in dem die Ansicht aktiviert werden soll, oder setzt die Koordinaten des Viewports zurück, in dem derzeit eine Ansicht aktiviert ist.
Syntax
HRESULT SetRect(
[in] LPRECT prcView
);
Parameter
[in] prcView
Ein Zeiger auf eine RECT-Struktur , die die Koordinaten des Viewports enthält.
Rückgabewert
Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:
| Rückgabecode | Beschreibung |
|---|---|
|
Fehler beim Vorgang. |
Hinweise
Bei einer SDI-Anwendung (Single Document Interface) ist der Viewport der Clientbereich des Rahmenfensters 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.
Hinweise für Anrufer
Das Aufrufen von IOleDocumentView::SetRect oder IOleDocumentView::SetRectComplex ist Teil der normalen Aktivierungssequenz für Dokumentobjekte, in der Regel nach einem Aufruf von IOleDocumentView::UIActivate und vor einem Aufruf von IOleDocumentView::Show.Wenn die Größe des Fensters, das zum Anzeigen eines Dokumentobjekts verwendet wird, geändert wird, sollte der Container IOleDocumentView::SetRect (oder IOleDocumentView::SetRectComplex) aufrufen, um das Dokumentansichtsobjekt anzuweisen, seine Größe in die neuen Fensterdimensionen zu ändern.
Hinweise für Implementierer
Die Koordinaten des Viewports befinden sich innerhalb der Koordinaten des Ansichtsfensters, das über IOleWindow::GetWindow abgerufen wird. Die Ansicht muss sich selbst an die neuen Koordinaten anpassen, die in prcView übergeben werden.Diese Methode wird mit dem [input_sync]-Attribut definiert. Dies bedeutet, dass das View-Objekt während der Ausführung dieser Methode keinen anderen RPC-Aufruf ohne input_sync zurückgeben oder ausführen kann.
Eine Dokumentansicht muss diese Methode vollständig implementieren. E_NOTIMPL ist kein zulässiger Rückgabewert.
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 | docobj.h |