DataGridView.RowHeadersWidth Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft die Breite der Spalte in Pixel ab, die die Zeilenheader enthält, oder legt die Breite fest.

public:
 property int RowHeadersWidth { int get(); void set(int value); };
public int RowHeadersWidth { get; set; }
member this.RowHeadersWidth : int with get, set
Public Property RowHeadersWidth As Integer

Eigenschaftswert

Int32

Die Breite der Spalte, die Zeilenheader enthält, in Pixel. Der Standard ist 43.

Ausnahmen

ArgumentOutOfRangeException

Beim Festlegen dieser Eigenschaft ist der angegebene Wert kleiner als die Mindestbreite von 4 Pixel oder größer als die maximale Breite von 32.768 Pixel.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die RowHeadersWidth Eigenschaft in einem Zeilenbildszenario verwenden. Im Beispiel wird der Wert dieser Eigenschaft verwendet, um die Grenzen zu berechnen, in denen ein benutzerdefinierter Hintergrund gezeichnet wird.

Dieser Code ist Teil eines größeren Beispiels, das inHow verfügbar ist: Anpassen der Darstellung von Zeilen im Windows Forms DataGridView-Steuerelement.

// Paints the custom selection background for selected rows.
void dataGridView1_RowPrePaint(object sender,
        DataGridViewRowPrePaintEventArgs e)
{
    // Do not automatically paint the focus rectangle.
    e.PaintParts &= ~DataGridViewPaintParts.Focus;

    // 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);
        }
    }
}

' 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

Hinweise

Die RowHeadersWidth Eigenschaft kann verwendet werden, um die Größe der Zeilenüberschriftspalte auf eine angegebene Breite zu ändern. Um die Breite dieser Spalte anzupassen, um den Inhalt der Zeilenüberschriftenzellen anzupassen, verwenden Sie die AutoResizeRowHeadersWidth Methode.

Gilt für

Siehe auch