Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxCustomSpreadSheet.OptionsLockedStateImage Property

Specifies display settings for a “Locked View“ image.

#Declaration

Delphi
property OptionsLockedStateImage: TdxSpreadSheetLockedStateImageOptions read; write;

#Property Value

Type
TdxSpreadSheetLockedStateImageOptions

#Remarks

You can enclose the code that presumably performs time-consuming operations within BeginUpdate/EndUpdate procedure blocks and pass lsimPending or lsimImmediate as the BeginUpdate procedure parameter to enable display of a “Locked View” image during these operations.

The Spreadsheet and Report Designer controls automatically display a “Locked View” image if the following operations take a significant amount of time:

  • Loading a workbook from the specified stream or file;

  • Saving a workbook to the specified stream or file.

For the full list of the “Locked View” image settings, refer to the TdxSpreadSheetLockedStateImageOptions class description.

Note

To custom paint the “Locked View” image, handle the OnPrepareLockedStateImage event. If you need to track the progress of the time-consuming data import/export operations or report building, handle the OnProgress event.

See Also