Vcl.OleCtnrs.TOleContainer.CopyOnSave
Delphi
property CopyOnSave: Boolean read FCopyOnSave write FCopyOnSave default True;
C++
__property bool CopyOnSave = {read=FCopyOnSave, write=FCopyOnSave, default=1};
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| property | published | Vcl.OleCtnrs.pas Vcl.OleCtnrs.hpp |
Vcl.OleCtnrs | TOleContainer |
Description
Determines whether the SaveToFile and SaveToStream methods first create a copy of the OLE object.
When CopyOnSave is true, the SaveToFile and SaveToStream methods create a temporary OLE object, compressing redundant data to save space. This compressed copy is then saved to the file or stream. When CopyOnSave is false, the OLE object is saved directly to the file or stream without using a temporary copy to compress redundant information.
Set CopyOnSave to false when the container holds very large embedded objects and there might not be enough memory to make the temporary copy. The default value is true.