WindowControlOptions Class
Specifies how to print a control assigned to a PrintableComponentContainer.
Namespace: DevExpress.XtraReports.UI
Assembly: DevExpress.XtraReports.v20.1.dll
NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core
Declaration
Related API Members
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.
using System.Windows.Forms;
using DevExpress.XtraReports.UI;
// ...
// Create an XtraReport instance.
XtraReport report = new XtraReport() {
Bands = {
new DetailBand()
}
};
// Create a DataGridView 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.PrintableComponent = dataGridView;
// Specify that the WM_PRINT message is used to print the control inside the printable component container.
printableComponentContainer.WindowControlOptions.DrawMethod = WinControlDrawMethod.UseWMPrint;
// Specify that the control inside the printable component container is always printed as an image.
printableComponentContainer.WindowControlOptions.PrintMode = WinControlPrintMode.AsImage;
// Specify that the printed image is a bitmap, not a metafile.
printableComponentContainer.WindowControlOptions.ImageType = WinControlImageType.Bitmap;
// Add the printable component container to the report.
report.Bands[BandKind.Detail].Controls.Add(printableComponentContainer);