_FlatProperties Property, SftTree Object
Defines whether properties are stored as a flat list in a property bag.
Syntax
Get
| VB.NET | Boolean = object._FlatProperties As Boolean |
| VB | Boolean = object._FlatProperties As Boolean |
| C#.NET | bool Boolean = object._FlatProperties; |
| VC++ | VARIANT_BOOL Boolean = object->_FlatProperties;
VARIANT_BOOL Boolean = object->Get_FlatProperties(); |
| C | HRESULT object->get__FlatProperties(VARIANT_BOOL* Boolean); |
Put
| VB.NET | object._FlatProperties = Boolean As Boolean |
| VB | object._FlatProperties = Boolean As Boolean |
| C#.NET | bool object._FlatProperties = Boolean; |
| VC++ | VARIANT_BOOL object->_FlatProperties = Boolean;
void object->Put_FlatProperties(VARIANT_BOOL Boolean); |
| C | HRESULT object->put__FlatProperties(VARIANT_BOOL Boolean); |
object
A SftTree object.
Boolean
Defines whether properties are stored as a flat list in a property bag.
| Boolean | Description |
|---|
| True | Properties are stored as a flat list if a property bag is used (IPropertyBag interface). |
| False | Properties are stored as objects if a property bag is used (IPropertyBag interface). This is the default and the recommended setting. |
Comments
The _FlatProperties property defines whether properties are stored as a flat list in a property bag.
The _FlatProperties property can be used with development tools that do not properly save objects in a property bag (IPropertyBag interface). Visual Basic, Visual C++, Delphi, C++ Builder and many others fully support objects in property bags or use the IStream interface. For these, the _FlatProperties property should be set to False (the default).
When using development tools that cannot save objects in a property bag, you will notice that certain settings are lost when saving and loading forms, usually with HTML editors. In this case the _FlatProperties property should be set to True. This is a limitation of the development tool, not our product. Even with _FlatProperties set to False, Picture object and Font object definitions (such as the Font property) are still lost. These must be set at run-time and are lost if defined at design-time. Only the SftTree objects are affected by the _FlatProperties property.
See Also SftTree Object | Object Hierarchy
On
Off