DataGridView.RowHeadersWidth Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

DataGridView.cs

Mendapatkan atau mengatur lebar, dalam piksel, dari kolom yang berisi header baris.

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

Nilai Properti

Int32

Lebar, dalam piksel, dari kolom yang berisi header baris. Defaultnya adalah 43.

Pengecualian

ArgumentOutOfRangeException

Nilai yang ditentukan saat mengatur properti ini kurang dari lebar minimum 4 piksel atau lebih besar dari lebar maksimum 32768 piksel.

Contoh

Contoh kode berikut mengilustrasikan cara menggunakan RowHeadersWidth properti dalam skenario lukisan baris. Dalam contoh, nilai properti ini digunakan untuk menghitung batas di mana latar belakang kustom digambar.

Kode ini adalah bagian dari contoh yang lebih besar yang tersedia diCara: Menyesuaikan Tampilan Baris di Kontrol Windows Forms DataGridView.

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

Keterangan

RowHeadersWidth Properti dapat digunakan untuk mengubah ukuran kolom header baris menjadi lebar yang ditentukan. Untuk menyesuaikan lebar kolom ini agar pas dengan isi sel header baris, gunakan metode .AutoResizeRowHeadersWidth

Lihat juga

• AutoResizeRowHeadersWidth
• Kontrol DataGridView (Formulir Windows)