IOleDocumentView::SaveViewState-Methode (docobj.h)
Speichert den Ansichtszustand im angegebenen Stream.
Syntax
HRESULT SaveViewState(
[in] LPSTREAM pstm
);
Parameter
[in] pstm
Ein Zeiger auf den Datenstrom, in dem die Ansicht ihre Zustandsdaten speichern soll.
Rückgabewert
Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Wert in pstm ist NULL. |
|
Diese Ansicht hat keinen aussagekräftigen Zustand zum Speichern. Dieser Fehler sollte selten sein, da die meisten Ansichten mindestens einige Zustandsinformationen enthalten, die gespeichert werden sollten. |
Hinweise
Der Zustand der Ansicht umfasst Eigenschaften wie Ansichtstyp, Zoomfaktor und Position der Einfügemarke. Der Container ruft diese Funktion in der Regel auf, bevor die Ansicht deaktiviert wird. Der Stream kann dann später verwendet werden, um eine Ansicht desselben Dokuments über IOleDocumentView::ApplyViewState in diesen gespeicherten Zustand neu zu initialisieren.
Gemäß den Regeln für IPersistStream muss eine Ansicht ihre CLSID als erstes Element im Stream schreiben. Alle probleme mit der kompatibilität des plattformübergreifenden Dateiformats, die sich auf die Speicherdarstellung des Dokuments beziehen, gelten auch für diesen Kontext.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | docobj.h |