Metodo IOleDocumentView::SaveViewState (docobj.h)
Salva lo stato di visualizzazione nel flusso specificato.
Sintassi
HRESULT SaveViewState(
[in] LPSTREAM pstm
);
Parametri
[in] pstm
Puntatore al flusso in cui la vista consiste nel salvare i dati sullo stato.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il valore in pstm è NULL. |
|
Questa visualizzazione non ha uno stato significativo da salvare. Questo errore deve essere raro perché la maggior parte delle visualizzazioni ha almeno alcune informazioni sullo stato che vale la pena salvare. |
Commenti
Lo stato della visualizzazione include proprietà come il tipo di visualizzazione, il fattore di zoom e la posizione del punto di inserimento. Il contenitore chiama in genere questa funzione prima di disattivare la visualizzazione. Il flusso può quindi essere usato in un secondo momento per reinizializzare una visualizzazione dello stesso documento in questo stato salvato tramite IOleDocumentView::ApplyViewState.
In base alle regole che regolano IPersistStream, una vista deve scrivere CLSID come primo elemento del flusso. Tutti i problemi di compatibilità del formato file multipiattaforma che si applicano alla rappresentazione di archiviazione del documento si applicano anche a questo contesto.
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 |