Метод IOleDocumentView::SaveViewState (docobj.h)
Сохраняет состояние представления в указанном потоке.
Синтаксис
HRESULT SaveViewState(
[in] LPSTREAM pstm
);
Параметры
[in] pstm
Указатель на поток, в котором представление сохраняет данные о состоянии.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.
| Код возврата | Описание |
|---|---|
|
Значение в pstm равно NULL. |
|
Это представление не имеет осмысленного состояния для сохранения. Эта ошибка должна быть редкой, так как большинство представлений содержат хотя бы некоторые сведения о состоянии, которые стоит сохранить. |
Комментарии
Состояние представления включает такие свойства, как тип представления, коэффициент масштаба и расположение точки вставки. Контейнер обычно вызывает эту функцию перед деактивации представления. Затем поток можно использовать для повторной инициализации представления того же документа в этом сохраненном состоянии с помощью IOleDocumentView::ApplyViewState.
В соответствии с правилами , регулирующими IPersistStream, представление должно записывать свой ИДЕНТИФИКАТОР CLSID в качестве первого элемента в потоке. Все проблемы совместимости кроссплатформенного формата файлов, которые относятся к представлению хранилища документа, также относятся к этому контексту.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | docobj.h |