IOleDocumentView::SetRectComplex-Methode (docobj.h)

Artikel
02/28/2024

Legt die rechteckigen Koordinaten des Viewports, der Bildlaufleisten und des Größenfelds fest.

Syntax

HRESULT SetRectComplex(
  [in] LPRECT prcView,
  [in] LPRECT prcHScroll,
  [in] LPRECT prcVScroll,
  [in] LPRECT prcSizeBox
);

Parameter

[in] prcView

Ein Zeiger auf eine RECT-Struktur , die die Koordinaten des Viewports enthält.

[in] prcHScroll

Ein Zeiger auf eine RECT-Struktur , die die Koordinaten der horizontalen Bildlaufleiste enthält.

[in] prcVScroll

Ein Zeiger auf eine RECT-Struktur , die die Koordinaten der vertikalen Bildlaufleiste enthält.

[in] prcSizeBox

Ein Zeiger auf eine RECT-Struktur , die die Koordinaten des Größenfelds 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.
E_NOTIMPL	Das Dokumentobjekt, das diese Ansicht besitzt, unterstützt keine komplexen Rechtecke.

Hinweise

Anzeigen von Frames, die eine Arbeitsmappenmetapher unterstützen, bei der ein einzelnes Dokument mehrere Blätter oder Seiten umfasst, rufen in der Regel diese Methode auf, um die Koordinaten festzulegen, die von allen Blättern oder Seiten gemeinsam verwendet werden sollen.

Hinweise für Anrufer

Das Aufrufen von IOleDocumentView::SetRectComplex ist Teil der normalen Aktivierungssequenz für Dokumentobjekte, die komplexe Rechtecke unterstützen, 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::SetRectComplex oder IOleDocumentView::SetRect aufrufen, um das Ansichtsobjekt anzuweisen, seine Größe auf die neuen Fensterdimensionen zu ändern.

Hinweise für Implementierer

Dokumentobjekte, die komplexe Rechtecke unterstützen, markieren sich selbst mit DOCMISC_SUPPORTCOMPLEXRECTANGLES, wie unter DOCMISC und IOleDocument::GetDocMiscStatus beschrieben. Dokumentobjekte, die diese Methode nicht unterstützen, können E_NOTIMPL zurückgeben.

Nach dem Empfang eines Aufrufs dieser Methode sollte sich eine Ansicht selbst an die in prcView angegebenen Koordinaten anpassen und die Bildlaufleisten und das Größenfeld an die in prcHScroll, prcVScroll und prcSizeBox beschriebenen Bereiche anpassen.

Diese Methode wird mit dem [input_sync]-Attribut definiert. Dies bedeutet, dass das implementierende Objekt während der Ausführung dieser Methode keinen anderen RPC-Aufruf ohne input_sync zurückgeben oder ausführen kann.

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

IOleDocument::GetDocMiscStatus

IOleDocumentView

Share via