TcxPropertiesStoreComponent Class

Represents a reference to a component with properties stored by a TcxPropertiesStore object.

Declaration

TcxPropertiesStoreComponent = class(
    TcxInterfacedCollectionItem,
    IcxScalableComponent,
    IcxStoredObject,
    IcxStoredParent
)

Remarks

The TcxPropertiesStore component is used to save/restore published properties of components present on a form.

Components with properties being saved/restored by a TcxPropertiesStore instance are accessible via its Components collection. Each item in this collection is a TcxPropeprtiesStoreComponent object.

The Component property identifies the component whose properties are being saved/restored. To select the component’s properties to store/restore, see the Properties object.

If the selected property represents a TPersistent descendant (like the Font property of a component), you can specify its sub-properties to store. A sub-property is delimited from the main property by a dot. For instance, you can insert the “Font.Style“ string into the Properties list instead of “Font“. This will save only the Style property of the TFont object associated with the Font property. If you specify the control’s Font property to store, all its published sub-properties (Charset, Color, Height, Name, Pitch, Size and Style) will be automatically saved.

The TcxPropertiesStoreComponent class’s methods allow you to save/restore individual components from the Components collection to any type of supported storage (registry, INI file, stream).

Implements

IcxScalableComponent

IcxStoredObject

IcxStoredParent

Inheritance

TObject

TPersistent

TCollectionItem

TcxInterfacedCollectionItem

TcxPropertiesStoreComponent