DataGridViewPaintParts Enumeration

Note: This enumeration is new in the .NET Framework version 2.0.

Defines values for specifying the parts of a DataGridViewCell that are to be painted.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

'Declaration
<FlagsAttribute> _
Public Enumeration DataGridViewPaintParts
'Usage
Dim instance As DataGridViewPaintParts

/** @attribute FlagsAttribute() */ 
public enum DataGridViewPaintParts
FlagsAttribute 
public enum DataGridViewPaintParts

 Member nameDescription
AllAll parts of the cell should be painted. 
BackgroundThe background of the cell should be painted. 
BorderThe border of the cell should be painted. 
ContentBackgroundThe background of the cell content should be painted. 
ContentForegroundThe foreground of the cell content should be painted. 
ErrorIconThe cell error icon should be painted. 
FocusThe focus rectangle should be painted around the cell. 
NoneNothing should be painted. 
SelectionBackgroundThe background of the cell should be painted when the cell is selected. 

This enumeration is used by the protected DataGridViewCell.Paint method and by handlers for the CellPainting, RowPrePaint, and RowPostPaint events of the DataGridView control.

The following code example illustrates the use of this type. This example is part of a larger example available in How to: Customize the Appearance of Rows in the Windows Forms DataGridView Control.

' Paints the custom selection background for selected rows.
Sub dataGridView1_RowPrePaint(ByVal sender As Object, _
    ByVal e As DataGridViewRowPrePaintEventArgs) _
    Handles dataGridView1.RowPrePaint

    ' Do not automatically paint the focus rectangle.
    e.PaintParts = e.PaintParts And Not DataGridViewPaintParts.Focus

    ' Determine whether the cell should be painted with the 
    ' custom selection background.
    If (e.State And DataGridViewElementStates.Selected) = _
        DataGridViewElementStates.Selected Then

        ' Calculate the bounds of the row.
        Dim rowBounds As New Rectangle( _
            Me.dataGridView1.RowHeadersWidth, e.RowBounds.Top, _
            Me.dataGridView1.Columns.GetColumnsWidth( _
            DataGridViewElementStates.Visible) - _
            Me.dataGridView1.HorizontalScrollingOffset + 1, _
            e.RowBounds.Height)

        ' Paint the custom selection background.
        Dim backbrush As New _
            System.Drawing.Drawing2D.LinearGradientBrush(rowBounds, _
            Me.dataGridView1.DefaultCellStyle.SelectionBackColor, _
            e.InheritedRowStyle.ForeColor, _
            System.Drawing.Drawing2D.LinearGradientMode.Horizontal)
        Try
            e.Graphics.FillRectangle(backbrush, rowBounds)
        Finally
            backbrush.Dispose()
        End Try
    End If

End Sub 'dataGridView1_RowPrePaint

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show: