Skip to main content

TreeList.OptionsPrint Property

Provides access to options that specify how the control is printed and exported.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v23.2.dll

NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.TreeList

Declaration

[XtraSerializableProperty(XtraSerializationVisibility.Content, XtraSerializationFlags.DefaultValue)]
public TreeListOptionsPrint OptionsPrint { get; }

Property Value

Type Description
TreeListOptionsPrint

A TreeListOptionsPrint object that contains the print and export options.

Remarks

The ShowRibbonPrintPreview() method invokes the Preview window that allows a user to do the following:

  • select the control’s visual elements to be printed
  • set the page size, orientation, and margins
  • specify headers and footers
  • navigate through the preview
  • select a printer, set the number of copies, and print the control
  • export the data to different formats (PDF, HTML, XLS, etc.)

Tree List Ribbon Print Preview

Commands in the window are displayed in the ribbon. You can also call the ShowPrintPreview() method, which invokes the print preview window where commands are displayed in bars.

A user can call the following commands in the ribbon:

  • Print — invokes the print dialog, which allows a user to select a printer, specify the number of copies, define the page range, and print the control. You can call the PrintDialog() method to invoke this dialog.

    Tree List Print Dialog

  • Print Quick — prints the control without the print dialog. You can call the Print() method to print the control without the print dialog.

  • Options — invokes a window that allows a user to specify the visual elements that should be printed: vertical grid lines, headers, etc. You can use the OptionsPrint property to specify these options in code.

    Tree List Print Options

Note that you can only print controls if the project references the XtraPrinting library. To check if the control can be printed, use the IsPrintingAvailable property. To check if the control is currently being printed, use the IsPrinting property.

See Also