Printing and Exporting

• Oct 10, 2022
• 3 minutes to read

The TreeMap control allows you to print a treemap and export it to multiple file formats.

Make sure that your project references the DevExpress.Printing.v24.1.Core assembly to be capable of completing the following tasks.

• Immediately Print a Treemap
• Print a Treemap Using the Standard Print Dialog
• Invoke the Print Preview Dialog to Print/Export a Treemap
• Export a Treemap from Code

Immediately Print a Treemap

To print a treemap by means of the system default printer without invoking any print dialogs, call the HierarchicalChartControlBase.Print method.

C#

private void printButton_OnClick(object sender, EventArgs e) {
    treeMap.Print();
}

VB.NET

Private Sub printButton_OnClick(sender As Object, e As EventArgs)
    treeMap.Print()
End Sub

Print a Treemap Using the Standard Print Dialog

The system print dialog makes it possible to configure common print settings before printing. For instance, you can set the number of printed copies.

To show the system print dialog, use the HierarchicalChartControlBase.ShowPrintDialog method.

C#

private void printButton_OnClick(object sender, EventArgs e) {
    treeMap.ShowPrintDialog();
}

VB.NET

Private Sub printButton_OnClick(sender As Object, e As EventArgs)
    treeMap.ShowPrintDialog()
End Sub

Invoke the Print Preview Dialog to Print/Export a Treemap

A treemap can be printed/exported with the Print Preview dialog. To invoke this dialog, use one of the following methods.

Method	Description
HierarchicalChartControlBase.ShowRibbonPrintPreview	Creates a document to be printed and displays the Print Preview.
HierarchicalChartControlBase.ShowPrintPreview	Creates a document to be printed and displays the Print Preview with the Ribbon.

The code below demonstrates how to invoke the Print Preview with the Ribbon.

C#

private void printButton_OnClick(object sender, EventArgs e) {
    treeMap.ShowRibbonPrintPreview();
}

VB.NET

Private Sub printButton_OnClick(sender As Object, e As EventArgs)
    treeMap.ShowRibbonPrintPreview()
End Sub

To immediately print a treemap, select the Quick Print item in the Preview.

1. The Print Preview

2. The Ribbon Print Preview

To show the standard system dialog before printing, select the Print item.

1. The Print Preview

2. The Ribbon Print Preview

Select a format from the Export To item’s drop-down list to export a treemap.

1. The Print Preview

2. The Ribbon Print Preview

Export a Treemap from Code

The TreeMap control supports the capability to export a treemap to numerous file formats.

Method	Description
HierarchicalChartControlBase.ExportToImage	Exports a treemap to an image file.
HierarchicalChartControlBase.ExportToMht	Exports a treemap to an MHT file.
HierarchicalChartControlBase.ExportToPdf	Exports a treemap to a PDF file.
HierarchicalChartControlBase.ExportToRtf	Exports a treemap to an RTF file.
HierarchicalChartControlBase.ExportToXls	Exports a treemap to an XLS file.
HierarchicalChartControlBase.ExportToXlsx	Exports a treemap to an XLSX file.
HierarchicalChartControlBase.ExportToDocx	Exports a treemap to a DOCX file.
HierarchicalChartControlBase.ExportToHtml	Exports a treemap to an HTML file.

The code below shows how to export a treemap to a PNG image.

C#

private void printButton_OnClick(object sender, EventArgs e) {
    treeMap.ExportToImage("D:\\treemap.png", ImageFormat.Png);
}

VB.NET

Private Sub printButton_OnClick(sender As Object, e As EventArgs)
    treeMap.ExportToImage("D:\treemap.png", ImageFormat.Png)
End Sub