Back to Devexpress

WindowControlOptions Class

xtrareports-devexpress-dot-xtrareports-dot-ui-50a42957.md

latest4.9 KB
Original Source

WindowControlOptions Class

Specifies how to print a control assigned to a PrintableComponentContainer.

Namespace : DevExpress.XtraReports.UI

Assembly : DevExpress.XtraReports.v25.2.dll

NuGet Package : DevExpress.Reporting.Core

Declaration

csharp
public class WindowControlOptions
vb
Public Class WindowControlOptions

The following members return WindowControlOptions objects:

Remarks

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.

Example

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.

csharp
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.
report.Bands[BandKind.Detail].Controls.Add(printableComponentContainer);
vb
Imports DevExpress.XtraReports.UI
' ...
' Create an XtraReport instance.
Dim report = New XtraReport()
Dim band = New DetailBand()
report.Bands.Add(band)
' Create a DataGrid control instance.
Dim dataGridView As New DataGridView()
' Create a PrintableComponentContainer instance for the data grid.
Dim printableComponentContainer As 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.
report.Bands(BandKind.Detail).Controls.Add(printableComponentContainer)

Inheritance

Object WindowControlOptions

See Also

WindowControlOptions Members

Use Third-Party Controls

DevExpress.XtraReports.UI Namespace