_FlatProperties Property, SftTree Object


	SftTree._FlatProperties Property	Softel vdm, Inc.

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);
	Delphi	Boolean := object._FlatProperties : WordBool;
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);
	Delphi	object._FlatProperties := Boolean : WordBool;

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.