CustomDrawEventArgs.DefaultDraw() Method

Performs default painting of an element.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v22.2.dll

NuGet Package: DevExpress.Win.Grid

Declaration

C#

public void DefaultDraw()

VB.NET

Public Sub DefaultDraw

Remarks

The DefaultDraw method can be useful if you need to draw custom information over the default element rendering. To do this, call the DefaultDraw method and then draw custom information using the methods provided by the CustomDrawEventArgs.Graphics object.

The DefaultDraw method automatically sets the CustomDrawEventArgs.Handled property to true to prevent additional default painting from being performed after a custom draw event handler has been completed.

The DefaultDraw method does nothing if the CustomDrawEventArgs.Handled property has already been set to true.

Example

In the sample below, the GridView.CustomDrawCell event is handled to custom-paint data cells.

The CustomDrawEventArgs.DefaultDraw method applies the default draw to all cells. For all “Units in Stock” cells that display 0, a custom icon is drawn on top of this default cell rendering.

C#

Image warningImage = Image.FromFile("c:\\warning.png");

private void gridView1_CustomDrawCell(object sender, DevExpress.XtraGrid.Views.Base.RowCellCustomDrawEventArgs e) {
    if (e.Column.FieldName == "UnitsInStock") {
        e.DefaultDraw();
        if (Convert.ToInt32(e.CellValue) == 0)
            e.Cache.DrawImage(warningImage, e.Bounds.Location);
    }
}

VB.NET

Dim warningImage As Image = Image.FromFile("c:\warningImage.png")

Private Sub GridView1_CustomDrawCell(sender As Object, e As RowCellCustomDrawEventArgs) Handles GridView1.CustomDrawCell
    If e.Column.FieldName = "UnitsInStock" Then
        e.DefaultDraw()
        If Convert.ToInt32(e.CellValue) = 0 Then
            e.Cache.DrawImage(warningImage, e.Bounds.Location)
        End If
    End If
End Sub