SftMask._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 SftMask object.

Boolean

Defines whether properties are stored as a flat list in a property bag.

Boolean	Description
True	The SftMask/OCX properties are stored as a flat list if a property bag is used (IPropertyBag interface).
False	The SftMask/OCX 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 SftMask objects are affected by the _FlatProperties property.