IOleDocumentView::SetRect-Methode (docobj.h)

  • Artikel

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
E_FAIL
 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

Weitere Informationen

IOleDocumentView