DataGridViewRowPrePaintEventArgs.State Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Zustand der aktuellen DataGridViewRow ab.

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

Eigenschaftswert

DataGridViewElementStates

Eine bitweise Kombination der DataGridViewElementStates-Werte, die den Zustand der Zeile angibt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die State -Eigenschaft verwendet wird, um zu bestimmen, ob eine Zeile ausgewählt ist. Wenn die Zeile ausgewählt ist, zeichnet der Code einen benutzerdefinierten Hintergrund. Die Variable , eist vom Typ DataGridViewRowPrePaintEventArgs. Dieses Codebeispiel ist Teil eines größeren Beispiels unter Gewusst wie: Anpassen der Darstellung von Zeilen im Windows Forms DataGridView-Steuerelement.

// 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

Hinweise

Diese Eigenschaft kann verwendet werden, um zu bestimmen, ob die Zeile unter anderem eingefroren, schreibgeschützt oder ausgewählt ist.

Weitere Informationen

• DataGridView
• DataGridViewRow
• DataGridViewElementStates