WinControlContainer.DrawMethod Property

Gets or sets which message should be used to paint a control placed inside the WinControlContainer.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v20.2.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Reporting.Core

Declaration

C#

[DefaultValue(WinControlDrawMethod.UseWMPaint)]
[SRCategory(ReportStringId.CatBehavior)]
public virtual WinControlDrawMethod DrawMethod { get; set; }

VB.NET

<SRCategory(ReportStringId.CatBehavior)>
<DefaultValue(WinControlDrawMethod.UseWMPaint)>
Public Overridable Property DrawMethod As WinControlDrawMethod

Property Value

Type	Default	Description
WinControlDrawMethod	UseWMPaint	The message that should be used to paint a control placed in the WinControlContainer.

Available values:

Name	Description
UseWMPaint	Use the WM_PAINT message to draw the Windows Forms control.
UseWMPrint	Use the WM_PRINT message to draw the Windows Forms control.
UseWMPaintRecursive	Use the WM_PAINT message to recursively draw the Windows Forms control and all its child controls.
UseWMPrintRecursive	Use the WM_PRINT message to recursively draw the Windows Forms control and all its child controls.

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.

C#

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.NET

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)

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DrawMethod property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

Reporting_how-to-embed-a-gaugecontrol-into-the-end-user-designers-toolbox-e1177/CS/WindowsApplication1/MyGaugeControl.cs#L13

    this.WinControl = gauge;
    this.DrawMethod = WinControlDrawMethod.UseWMPaintRecursive;
}

VB.NET

Reporting_how-to-embed-a-gaugecontrol-into-the-end-user-designers-toolbox-e1177/VB/WindowsApplication1/MyGaugeControl.vb#L16

Me.WinControl = gauge
Me.DrawMethod = WinControlDrawMethod.UseWMPaintRecursive