DataGridView.RowHeadersWidth Propiedad

Definición

Obtiene o establece el ancho, en píxeles, de la columna que contiene los encabezados de fila.Gets or sets the width, in pixels, of the column that contains the row headers.

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

Valor de propiedad

El ancho, en píxeles, de la columna que contiene los encabezados de fila.The width, in pixels, of the column that contains row headers. El valor predeterminado es 43.The default is 43.

Excepciones

El valor especificado al establecer esta propiedad es menor que el ancho mínimo de 4 píxeles o es mayor que el ancho máximo de 32.768 píxeles.The specified value when setting this property is less than the minimum width of 4 pixels or is greater than the maximum width of 32768 pixels.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la propiedad RowHeadersWidth en un escenario de dibujo de filas.The following code example illustrates how to use the RowHeadersWidth property in a row-painting scenario. En el ejemplo, el valor de esta propiedad se utiliza para calcular los límites dentro de los cuales se dibuja un fondo personalizado.In the example, the value of this property is used to calculate the bounds within which a custom background is drawn.

Este código forma parte de un ejemplo más grande disponible en @ no__t-0How para: Personalice la apariencia de las filas en el control DataGridView Windows Forms @ no__t-0.This code is part of a larger example available inHow to: Customize the Appearance of Rows in the Windows Forms DataGridView Control.

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

Comentarios

La propiedad RowHeadersWidth se puede usar para cambiar el tamaño de la columna de encabezado de fila a un ancho especificado.The RowHeadersWidth property can be used to resize the row header column to a specified width. Para ajustar el ancho de esta columna para ajustarse al contenido de las celdas de encabezado de fila, use el método AutoResizeRowHeadersWidth.To adjust the width of this column to fit the contents of the row header cells, use the AutoResizeRowHeadersWidth method.

Se aplica a

Consulte también: