TdxCustomSpreadSheet.LoadFromStream(TStream,TdxSpreadSheetCustomFormatClass) Method

Loads workbook data and concomitant settings from a stream.

Declaration

procedure LoadFromStream(AStream: TStream; AFormat: TdxSpreadSheetCustomFormatClass); overload; virtual;

Parameters

Name	Type
AStream	TStream
AFormat	TdxSpreadSheetCustomFormatClass

Remarks

Call this procedure to load workbook data and accompanying settings previously saved to a stream (an instance of the TStream descendant) passed as the AStream parameter. The information loaded from the specified stream can include (depending on its internal data format):

• Workbook settings, including the number of pages, sheet tab order, and individual sheet settings;

• Cell style settings, including the current brush, fonts and displayed value formatting;

• Column and row group outlining information;

• Defined names (including report template sections in the case of the Report Designer);

• Floating containers, including the comments;

• Printing settings;

• Formula expressions;

• Stored cell data.

The LoadFromFile procedure calls the LoadFromStream procedure to load a spreadsheet document from a file stream. Calling this procedure raises the OnProgress event multiple times on reaching certain inner marks dependant on the steam data format, allowing you to track the loading progress.

The AFormat parameter in the second overloaded version allows you to specify a custom stream object format class. For instance, if you need to load CSV from a stream, specify the class reference to an object corresponding to the CSV format explicitly:

Delphi

var
  AStream: TMemoryStream;
//...
  dxSpreadSheet1.LoadFromStream(AStream, TdxSpreadSheetCSVFormat);

C++

TMemoryStream* AStream;
//...
  dxSpreadSheet1->LoadFromStream(AStream, TdxSpreadSheetCSVFormat);

Note

The CSV file format settings, applied to all Save/Load operations, can be customized by calling the dxSpreadSheetCSVFormatSettings function declared in the dxSpreadSheetFormatCSV unit.