Metodo IOleDocumentView::SetRectComplex (docobj.h)

Articolo
03/05/2024

Imposta le coordinate rettangolari del riquadro di visualizzazione, barre di scorrimento e casella di dimensioni.

Sintassi

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

Parametri

[in] prcView

Puntatore a una struttura RECT contenente le coordinate del viewport.

[in] prcHScroll

Puntatore a una struttura RECT contenente le coordinate della barra di scorrimento orizzontale.

[in] prcVScroll

Puntatore a una struttura RECT contenente le coordinate della barra di scorrimento verticale.

[in] prcSizeBox

Puntatore a una struttura RECT contenente le coordinate della casella di dimensioni.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_FAIL	Operazione non riuscita.
E_NOTIMPL	L'oggetto documento proprietario di questa visualizzazione non supporta rettangoli complessi.

Commenti

I frame di visualizzazione che supportano una metafora della cartella di lavoro, in cui un singolo documento comprende più fogli o pagine, in genere chiamano questo metodo per impostare le coordinate da usare in comune da tutti i fogli o le pagine.

Note ai chiamanti

La chiamata a IOleDocumentView::SetRectComplex fa parte della normale sequenza di attivazione per gli oggetti documento che supportano rettangoli complessi, in genere seguendo una chiamata a IOleDocumentView::UIActivate e precedendo una chiamata a IOleDocumentView::Show.

Ogni volta che la finestra usata per visualizzare un oggetto documento viene ridimensionata, il contenitore deve chiamare IOleDocumentView::SetRectComplex o IOleDocumentView::SetRect per indicare all'oggetto visualizzazione di ridimensionarsi alle nuove dimensioni della finestra.

Note per gli implementatori

Oggetti documento che supportano rettangoli complessi contrassegnano se stessi con DOCMISC_SUPPORTCOMPLEXRECTANGLES, come descritto in DOCMISC e IOleDocument::GetDocMiscStatus. Gli oggetti documento che non supportano questo metodo possono restituire E_NOTIMPL.

Dopo aver ricevuto una chiamata a questo metodo, una visualizzazione deve ridimensionarsi per adattare le coordinate specificate in prcView e adattarne le barre di scorrimento e le dimensioni alle aree descritte in prcHScroll, prcVScroll e prcSizeBox.

Questo metodo viene definito con l'attributo [input_sync] che significa che l'oggetto di implementazione non può restituire o effettuare un'altra chiamata RPC non input_sync durante l'esecuzione di questo metodo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	docobj.h

Vedi anche

IOleDocument::GetDocMiscStatus

IOleDocumentView

Condividi tramite