New to Telerik UI for WinForms? Start a free 30-day trial

TreeViewSpreadExport is a powerful exporting API, allowing to export RadTreeView to XLSX, PDF, CSV, and TXT format, utilizing the Document Processing Libraries.

Definition

Namespace:Telerik.WinControls.Export

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class TreeViewSpreadExport

Inheritance: objectTreeViewSpreadExport

Constructors

Initializes a new instance of the TreeViewSpreadExport class.

C#
public TreeViewSpreadExport(RadTreeView radTreeView, SpreadExportFormat exportFormat)
Parameters:radTreeViewRadTreeView

The RadTreeView to export.

exportFormatSpreadExportFormat

The export format.

Initializes a new instance of the TreeViewSpreadExport class.

C#
public TreeViewSpreadExport(RadTreeView radTreeView)
Parameters:radTreeViewRadTreeView

The RadTreeView to export.

Properties

Gets or sets a value indicating how children of collapsed nodes are exported.

C#
public HiddenOption CollapsedNodeOption { get; set; }

Gets or sets a value indicating whether to export the check box values, when they are shown in tree nodes.

C#
public bool ExportCheckBoxes { get; set; }

Gets or sets a value indicating whether to export child nodes grouped.

C#
public bool ExportChildNodesGrouped { get; set; }

Gets or sets the format of the exported file - XLSX, PDF, CSV, TXT or XLS.

C#
public SpreadExportFormat ExportFormat { get; set; }
Property Value:

The file extension.

Gets or sets a value indicating whether to export images.

C#
public bool ExportImages { get; set; }

Gets or sets a value indicating whether the visual settings should be exported.

C#
public bool ExportVisualSettings { get; set; }
Property Value:

true if visual settings are exported; otherwise, false.

Specifies how the file will be exported: as a new file, a new sheet in existing file or will override a sheet with given name.

C#
public FileExportMode FileExportMode { get; set; }
Property Value:

NewSheetInExistingFile - will add a new sheet to the specified file, if it exists CreateOrOverrideFile - will create/override the specified file CreateOrOverrideSheet - will create/override the specified sheet

Gets or sets the indent of child nodes.

C#
public int NodeIndent { get; set; }

Gets or sets the maximum number of rows per sheet.

C#
[CLSCompliant(false)]
public ExcelMaxRows SheetMaxRows { get; set; }
Property Value:

The sheet max rows.

Gets or sets the name of the sheet.

C#
public string SheetName { get; set; }
Property Value:

The name of the sheet.

Methods

Cancels an asynchronous export operation.

C#
public void CancelExportAsync()

Converts an image to the byte array consumed by the spread export renderer.

C#
protected virtual byte[] ConvertImageToByteArray(Image image)
Parameters:imageImage

The image to convert.

Returns:

byte[]

The serialized image data.

Creates the worksheet cell range, writes content-cell values, and applies cell styling when requested.

C#
protected virtual void CreateCell(TreeViewSpreadExportCell cell, int currentRowIndex, int currentColumnIndex)
Parameters:cellTreeViewSpreadExportCell

The cell data to render.

currentRowIndexint

The worksheet row for the cell.

currentColumnIndexint

The first worksheet column occupied by the cell.

A cell spanning multiple columns is merged. Styling is written when ExportVisualSettings is enabled or CellFormatting has subscribers.

Places the cell's image over the specified worksheet cell when an image is present.

C#
protected virtual void CreateImageOverCell(TreeViewSpreadExportImageCell cell, int currentRowIndex, int currentColumnIndex)
Parameters:cellTreeViewSpreadExportImageCell

The export cell containing the image and its alignment.

currentRowIndexint

The worksheet row that anchors the image.

currentColumnIndexint

The worksheet column that anchors the image.

The built-in implementation uses ImageAlignment to calculate the vertical offset; the horizontal offset is always zero.

Copies text, fill, and border styling from a visual tree element into an export cell.

C#
protected virtual void GetStylesFromVisualCell(TreeViewSpreadExportCell cell, LightVisualElement visualCell)
Parameters:cellTreeViewSpreadExportCell

The export cell that receives the visual styling.

visualCellLightVisualElement

The visual element supplying the style; if null, the export cell is left unchanged.

The background color is resolved from the rendered fill, including an eligible ancestor fill when the element's own fill is not opaque.

Raises the event.

C#
protected virtual void OnAsyncExportCompleted(AsyncCompletedEventArgs e)
Parameters:eAsyncCompletedEventArgs

The AsyncCompletedEventArgs instance containing the event data.

Raises the event.

C#
protected virtual void OnAsyncExportProgressChanged(ProgressChangedEventArgs e)
Parameters:eProgressChangedEventArgs

The ProgressChangedEventArgs instance containing the event data.

Raises the event.

C#
protected virtual void OnCellFormatting(TreeViewSpreadExportCellFormattingEventArgs e)
Parameters:eTreeViewSpreadExportCellFormattingEventArgs

The TreeViewSpreadExportCellFormattingEventArgs instance containing the event data.

Raises the event.

C#
protected virtual void OnExportCompleted(EventArgs e)
Parameters:eEventArgs

The EventArgs instance containing the event data.

Starts an export operation, in the specified sheet. If such sheet does not exist, it gets created.

C#
public void RunExport(Stream exportStream, ISpreadExportRenderer exportRenderer, string sheetName)
Parameters:exportStreamStream

The stream where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

sheetNamestring

Name of the sheet.

Starts an export operation.

C#
public void RunExport(Stream exportStream, ISpreadExportRenderer exportRenderer)
Parameters:exportStreamStream

The stream where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

Starts an export operation, in the specified sheet. If such sheet does not exist, it gets created.

C#
public void RunExport(string fileName, ISpreadExportRenderer exportRenderer, string sheetName)
Parameters:fileNamestring

The file name where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

sheetNamestring

Name of the sheet.

Starts an export operation.

C#
public void RunExport(string fileName, ISpreadExportRenderer exportRenderer)
Parameters:fileNamestring

The file name where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

Starts an async export operation, in the specified sheet. If such sheet does not exist, it gets created. Note that if ExportVisualSettings is true, collecting the visual styles from the RadTreeView will still execute on the UI thread.

C#
public void RunExportAsync(Stream exportStream, ISpreadExportRenderer exportRenderer, string sheetName)
Parameters:exportStreamStream

The stream where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

sheetNamestring

Name of the sheet.

Starts an export operation that runs in a background thread. Note that if ExportVisualSettings is true, collecting the visual styles from the RadTreeView will still execute on the UI thread.

C#
public void RunExportAsync(Stream exportStream, ISpreadExportRenderer exportRenderer)
Parameters:exportStreamStream

The stream where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

Starts an async export operation, in the specified sheet. If such sheet does not exist, it gets created. Note that if ExportVisualSettings is true, collecting the visual styles from the RadTreeView will still execute on the UI thread.

C#
public void RunExportAsync(string fileName, ISpreadExportRenderer exportRenderer, string sheetName)
Parameters:fileNamestring

The file name where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

sheetNamestring

Name of the sheet.

Starts an export operation that runs in a background thread. Note that if ExportVisualSettings is true, collecting the visual styles from the RadTreeView will still execute on the UI thread.

C#
public void RunExportAsync(string fileName, ISpreadExportRenderer exportRenderer)
Parameters:fileNamestring

The file name where data will be exported.

exportRendererISpreadExportRenderer

Instance of ISpreadExportRenderer class.

Events

Occurs when an async export operation is completed.

C#
public event AsyncCompletedEventHandler AsyncExportCompleted

Occurs when the progress of an async export operation changes.

C#
public event ProgressChangedEventHandler AsyncExportProgressChanged

Occurs for every cell that is being exported.

C#
public event TreeViewSpreadExportCellFormattingEventHandler CellFormatting

Occurs when the export process completes.

C#
public event EventHandler ExportCompleted