Skip to main content

WindowControlOptions Class

Specifies how to print a control assigned to a PrintableComponentContainer.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v23.1.dll

NuGet Package: DevExpress.Reporting.Core


public class WindowControlOptions


When you create a PrintableComponentContainer to print a control in a report, you can specify how to render the control inside the container. Create an instance of the WindowControlOptions class and assign it to the container’s WindowControlOptions property.

The following WindowControlOptions properties specify how to render a control inside the PrintableComponentContainer:

  • DrawMethod - gets or sets which message should be used to paint a control.
  • PrintMode - gets or sets if a control is printed as a brick or image.
  • ImageType - gets or sets whether to render a control as a bitmap or metafile. This property is in effect when a control is rendered as an image. See the PrintMode property description for more information.


The code sample below creates a DataGridView control instance and adds this instance to a report. The sample specifies that the DataGridView control is printed as a bitmap image.

using DevExpress.XtraReports.UI;
using System.Windows.Forms;
// ...
// Create an XtraReport instance.
XtraReport report = new XtraReport()
    Bands = {
        new DetailBand()
// Create a DataGrid control instance.
DataGridView dataGridView = new DataGridView();
// Create a PrintableComponentContainer instance for the data grid.
PrintableComponentContainer printableComponentContainer = new PrintableComponentContainer();
// Place the data grid inside the printable component container.
printableComponentContainer.WinControl = dataGridView;
// Specify that the control inside the printable component container is always printed as an image.
printableComponentContainer.PrintMode = WinControlPrintMode.AsImage;
// Specify that the control inside the printable component container is always printed as a bitmap.
printableComponentContainer.WindowControlOptions.ImageType = WinControlImageType.Bitmap;
// Add the printable component container to the report.


See Also