Método IOleDocumentView::SaveViewState (docobj.h)
Salva o estado de exibição no fluxo especificado.
Sintaxe
HRESULT SaveViewState(
[in] LPSTREAM pstm
);
Parâmetros
[in] pstm
Um ponteiro para o fluxo no qual a exibição deve salvar seus dados de estado.
Retornar valor
Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.
| Código de retorno | Descrição |
|---|---|
|
O valor em pstm é NULL. |
|
Essa exibição não tem nenhum estado significativo para salvar. Esse erro deve ser raro porque a maioria das exibições tem pelo menos algumas informações de estado que valem a pena salvar. |
Comentários
O estado da exibição inclui propriedades como o tipo de exibição, o fator de zoom e o local do ponto de inserção. O contêiner normalmente chama essa função antes de desativar o modo de exibição. O fluxo pode ser usado posteriormente para reinicializar uma exibição do mesmo documento para esse estado salvo por meio de IOleDocumentView::ApplyViewState.
De acordo com as regras que regem IPersistStream, uma exibição deve gravar seu CLSID como o primeiro elemento no fluxo. Quaisquer problemas de compatibilidade de formato de arquivo multiplataforma que se aplicam à representação de armazenamento do documento também se aplicam a esse contexto.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | docobj.h |