|
IPersistStorage
The IPersistStorage interface enables a container application to pass a storage object to one of
its contained objects and to load and save the storage object. This interface
supports the structured storage scheme in which each component object has its
own storage that is nested within the container's storage.
When to Implement
Any object that can be embedded in a container object must implement the IPersistStorage interface. This interface is one of the primary interfaces for a compound
document object. It is part of the aggregate object that includes the IOleObject and IDataObject interfaces.
The OLE default handler for embedded objects provides an implementation of the IPersistStorage interface that is used when the object is in the loaded state. Similarly, the
OLE default link handler provides an IPersistStorage implementation that manages storage for a linked object. These default
handlers both interact with the OLE default cache implementation, which has its own IPersistStorage implementation.
If you are providing a custom embedding or link handler for your objects, the
handler must include an implementation of IPersistStorage. You can delegate calls to the default handler so you can take advantage of
the default cache implementation.
When to Use
When an OLE container creates a new object, loads an existing object from
storage, or inserts a new object in a clipboard or a drag-and-drop operation, the
container uses the IPersistStorage interface to initialize the object and put it in the loaded or running state.
When a component is loaded or running, an OLE container uses the other IPersistStorage methods to instruct the component to perform various save operations or to
instruct the component to release its storage.
Typically, applications use helper functions such as OleLoad or OleCreate, rather than calling the IPersistStorage::Load or IPersistStorage::InitNew methods directly. Similarly, applications typically call the OleSave helper function rather than calling IPersistStorage::Save directly.
Methods in Vtable Order
IPersistStorage Methods
| Description
| IsDirty
| Indicates whether the object has changed since it was last saved to its
current storage.
| InitNew
| Initializes a new storage object.
| Load
| Initializes an object from its existing storage.
| Save
| Saves an object, and any nested objects that it contains, into the specified
storage object. The object enters NoScribble mode.
| SaveCompleted
| Notifies the object that it can revert from NoScribble or HandsOff mode, in
which in must not write to its storage object, to Normal mode in which it can.
| HandsOffStorage
| Instructs the object to release all storage objects that have been passed to
it by its container and to enter HandsOffAfterSave or HandsOffFromNormal mode.
|
See Also
IDataObject, IOleObject, OleCreate, OleLoad, OleSave
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
