DataGridViewRowPrePaintEventArgs.State Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém o estado do DataGridViewRow atual.

public:
 property System::Windows::Forms::DataGridViewElementStates State { System::Windows::Forms::DataGridViewElementStates get(); };

public System.Windows.Forms.DataGridViewElementStates State { get; }

member this.State : System.Windows.Forms.DataGridViewElementStates

Public ReadOnly Property State As DataGridViewElementStates

Valor da propriedade

DataGridViewElementStates

Uma combinação bit a bit dos DataGridViewElementStates valores que especifica o estado da linha.

Exemplos

O exemplo de código a seguir demonstra como usar a State propriedade para determinar se uma linha está selecionada. Se a linha estiver selecionada, o código pintará uma tela de fundo personalizada. A variável , e, é do tipo DataGridViewRowPrePaintEventArgs. Este exemplo de código faz parte de um exemplo maior fornecido em Como personalizar a aparência de linhas no controle Windows Forms DataGridView.

// Determine whether the cell should be painted
// with the custom selection background.
if ((e.State & DataGridViewElementStates.Selected) ==
            DataGridViewElementStates.Selected)
{
    // Calculate the bounds of the row.
    Rectangle rowBounds = new Rectangle(
        this.dataGridView1.RowHeadersWidth, e.RowBounds.Top,
        this.dataGridView1.Columns.GetColumnsWidth(
            DataGridViewElementStates.Visible) -
        this.dataGridView1.HorizontalScrollingOffset + 1,
        e.RowBounds.Height);

    // Paint the custom selection background.
    using (Brush backbrush =
        new System.Drawing.Drawing2D.LinearGradientBrush(rowBounds,
            this.dataGridView1.DefaultCellStyle.SelectionBackColor,
            e.InheritedRowStyle.ForeColor,
            System.Drawing.Drawing2D.LinearGradientMode.Horizontal))
    {
        e.Graphics.FillRectangle(backbrush, rowBounds);
    }
}

' 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

Comentários

Essa propriedade pode ser usada para determinar se a linha está congelada, somente leitura ou selecionada, entre outros estados.

Confira também

• DataGridView
• DataGridViewRow
• DataGridViewElementStates