RootSection is an overridden String function in TCustomIniPropStorage. It ensures that the value in IniSection property is used as the root section (when assigned). If IniSection has not been assigned, the inherited method is called to build the section name using the Name or Class name for the Root component in the class instance.

IniFile is a read-only TCustomIniFile property which provides access to properties and methods in the underlying INI file used to store values for session properties. The property is used in the implementation of methods which read or write values using the section, identifier, and value for the session properties.

IniFile is (re)allocated (as needed) at run-time in the StorageNeeded method. It is not (re)created at design-time. IniFile is freed (when needed) in the FreeStorage method.

Use IniFileName to specify the qualified path including file name for the INI file.

StorageNeeded is an overridden Boolean function in TCustomIniPropStorage. It ensures that the IniFile property is created or recreated when the method is called. The value in the ReadOnly argument is assigned to an internal member in the class instance; IniFile is recreated if the value in the member has been changed since the class was created.

StorageNeeded is called from methods in ancestor classes when the Active property is enabled, including: Save, Restore, SaveProperties, RestoreProperties, ReadString, WriteString, ReadInteger, WriteInteger, and EraseSection.

See FreeStorage for the actions performed when the storage for the class instance is no longer needed.

Use Active to control whether access using the INI file storage is enabled.

Use IniFileName to specify the qualified path including file name for the INI file storage.

FreeStorage is an overridden method in TCustomIniPropStorage. It reimplements the virtual method from the TCustomPropertyStorage ancestor. FreeStorage ensures that resources allocated to the IniFile property (in StorageNeeded) are freed when the storage object is no longer needed.

FreeStorage is called from methods that include: Save, Restore, SaveProperties, RestoreProperties, ReadString, WriteString, ReadInteger, WriteInteger, and EraseSection.

Use IniFile to access properties and methods in the INI storage mechanism.

Use IniFileName to specify the qualified path including file name for the INI file storage.

Use Active to control whether access using the IniFile storage object is enabled.

DoReadString is an overridden String function in TCustomIniPropStorage. It implements the abstract virtual method defined in the TCustomPropertyStorage ancestor.

Section contains the name for the section where the requested value is stored in IniFile.

Ident contains the name for the identifier read from the specified Section.

Default contains the default value returned in the method if the section or identifier is not found in IniFile.

DoReadString calls the ReadString method in IniFile to get the return value for the method.

DoWriteString is an overridden method in TCustomIniPropStorage. It implements the abstract virtual method defined in the TCustomPropertyStorage ancestor.

Section contains the name for the section where the specified value is stored in IniFile.

Ident contains the name for the identifier written to the specified Section.

Value contains the string value stored in IniFile in the method.

DoWriteString calls the WriteString method in IniFile using the arguments passed to the method.

DoEraseSections is an overridden String function in TCustomIniPropStorage. It implements the abstract virtual method defined in the TCustomPropertyStorage ancestor.

ARootSection contains the name of the section in IniFile removed in the method.

DoEraseSections gets a list of section names found in the INI file, and calls IniFile.EraseSection to remove the section along with its identifiers and values. Other child sections which have ARootSection as a prefix are removed as well.

DoEraseSections is used in the SaveProperties method, and is assigned as the OnEraseSetion event handler for the RTTI TPropsStorage instance used in the method.

IniFileName is a String property with the qualified path and file name for the IniFile where session properties are stored in the class instance. Its value is used in the StorageNeeded method to determine the file name used when the TIniFile class instance is created and assigned to the IniFile property.

When omitted, a default value is assigned to the property which uses the path and base name for the application executable. For the Windows platform, the generated value in IniFileName has a '.INI' file extension. For UNIX-like platforms, the file is created as a config file in the home directory for the current user with a '.' prefix and no file extension.

IniSection is a String property which contains the name of the section in IniFile where the form session properties are stored. The property value is used in the overridden RootSection function to set section name used when an IniSection property value has not been assigned. When omitted, the value from the inherited method is used; this is normally the full path to the Root component name or class name and any preceding owner components.

TIniPropStorage is a TCustomIniPropStorage descendant which implements the class used to store form session properties to a file using the INI format. It sets the visibility for properties and methods introduced in ancestor classes.

Use the SessionPropperties property in the TForm or a TFrame instance which owns the class to define the components and property names stored using the storage mechanism.

Use IniFileName to specify the path and file name where session properties are stored in IniFile.

Use IniSection to specify the name for a section where session properties are stored. When omitted, session properties are stored at the root section level in IniFile.

Use Active to enable or disable read/write access to the INI file storage for the class instance.

Use the event handlers in the class to perform actions needed before or during save and restore operations using the session properties.