<< Click to display table of contents >> TRVTableCellData.BackgroundPropertiesAllocate, BackgroundPropertiesFinalize

These methods allow working with the BackgroundProperties property.

procedure BackgroundPropertiesAllocate;
procedure BackgroundPropertiesFinalize;

A table can contain a very large number of cells, and most of them may not have a background image. To avoid unnecessary memory usage, memory for the BackgroundProperties property is allocated only when there is a non-empty BackgroundImage and/or when it is necessary to assign a property value different from the default.

Working with the BackgroundProperties property is done as follows.

First, call BackgroundPropertiesAllocate; if the BackgroundProperties object has not been created yet, this method will create it.

Then you can access the BackgroundProperties properties.

When finished, call BackgroundPropertiesFinalize; if there is no background image and all BackgroundProperties values are equal to their defaults, this method will free the memory allocated for BackgroundProperties.