Skip to main content
A newer version of this page is available. .

cxExportTLToCSV(string,TcxCustomTreeList,Boolean,Boolean,Char,string,TObject,TEncoding) Method

Exports content of a tree list control to a file in CSV (comma-separated values) format.

Declaration

procedure cxExportTLToCSV(const AFileName: string; ATreeList: TcxCustomTreeList; AExpand: Boolean = True; ASaveAll: Boolean = True; const ASeparator: Char = ','; const AFileExt: string = 'csv'; AHandler: TObject = nil; AEncoding: TEncoding = nil);

Parameters

Name Type Description
AFileName string

The full path to the resulting CSV file. You can omit the file name extension because it is automatically updated from the AFileExt parameter value.

ATreeList TcxCustomTreeList

The source tree list control.

AExpand Boolean

Optional. If True, the procedure exports all nodes, including the nodes hidden within collapsed nodes. If False, the procedure exports only visible nodes.

ASaveAll Boolean

Optional. If True, the procedure exports all or visible nodes, depending on the AExpand parameter value. If False, the procedure exports only selected nodes.

ASeparator Char

Optional. Specifies the character used to delimit exported values in the resulting CSV stream. The default separator character is a comma.

AFileExt string

Optional. Specifies the file name extension for the resulting CSV file. This parameter value always replaces the file name extension passed as a part of the AFileName parameter value.

AHandler TObject

Optional. Specifies a handler object that should implement the IcxExportBeforeSave and/or IcxExportProgress interfaces to allow you to perform specific actions before an export operation and track its progress. Refer to the following topic for detailed information on how to create and use handler objects: How to: Track Data Export Progress.

AEncoding TEncoding

Optional. Specifies the character encoding format of the resulting CSV stream. If nil (in Delphi) or nullptr (in C++Builder) is passed as the AEncoding parameter, the procedure uses the TEncoding.Default encoding.

Remarks

Example

Source Tree List Example

  cxExportTLToCSV('Departments.csv', cxDBTreeList);

Exported Tree List Data in CSV Format

See Also