Metodo IOleDocumentView::SetRect (docobj.h)
Imposta le coordinate rettangolari del riquadro di visualizzazione in cui la visualizzazione deve essere attivata o reimposta le coordinate del riquadro di visualizzazione in cui è attualmente attivata una visualizzazione.
Sintassi
HRESULT SetRect(
[in] LPRECT prcView
);
Parametri
[in] prcView
Puntatore a una struttura RECT contenente le coordinate del viewport.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Operazione non riuscita. |
Commenti
Per un'applicazione SDI (Single Document Interface), il riquadro di visualizzazione è l'area client della finestra frame meno lo spazio allocato per barre degli strumenti, barra di stato e così via. Per una finestra MDI (Multiple Document Interface), il riquadro di visualizzazione è l'area client della finestra del documento MDI meno qualsiasi altro elemento dell'interfaccia utente a livello di frame.
Note ai chiamanti
La chiamata a IOleDocumentView::SetRect o IOleDocumentView::SetRectComplex fa parte della normale sequenza di attivazione per gli oggetti documento, 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::SetRect (o IOleDocumentView::SetRectComplex) per indicare all'oggetto visualizzazione documento di ridimensionarsi alle nuove dimensioni della finestra.
Note per gli implementatori
Le coordinate del viewport si trovano nelle coordinate della finestra di visualizzazione, ottenuta tramite IOleWindow::GetWindow. La visualizzazione deve ridimensionarsi per adattare le nuove coordinate passate in prcView.Questo metodo viene definito con l'attributo [input_sync] che significa che l'oggetto view non può restituire o effettuare un'altra chiamata RPC non input_sync durante l'esecuzione di questo metodo.
Una visualizzazione documento deve implementare completamente questo metodo; E_NOTIMPL non è un valore restituito accettabile.
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 |