DataGridView.RowHeadersWidth Propriété

Définition

Obtient ou définit la largeur, en pixels, de la colonne qui contient les en-têtes de lignes.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

Valeur de propriété

Largeur, en pixels, de la colonne qui contient les en-têtes de lignes.The width, in pixels, of the column that contains row headers. La valeur par défaut est 43.The default is 43.

Exceptions

La valeur spécifiée lors de la définition de cette propriété est inférieure à la largeur minimale de 4 pixels ou supérieure à la largeur maximale de 32 768 pixels.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.

Exemples

L’exemple de code suivant illustre l’utilisation de la propriété RowHeadersWidth dans un scénario de peinture de lignes.The following code example illustrates how to use the RowHeadersWidth property in a row-painting scenario. Dans l’exemple, la valeur de cette propriété est utilisée pour calculer les limites dans lesquelles un arrière-plan personnalisé est dessiné.In the example, the value of this property is used to calculate the bounds within which a custom background is drawn.

Ce code fait partie d’un exemple plus complet disponible dans How pour : Personnaliser l’apparence des lignes dans le contrôle DataGridView Windows Forms.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

Remarques

La propriété RowHeadersWidth peut être utilisée pour redimensionner la colonne d’en-tête de ligne à une largeur spécifiée.The RowHeadersWidth property can be used to resize the row header column to a specified width. Pour ajuster la largeur de cette colonne en fonction du contenu des cellules d’en-tête de ligne, utilisez la méthode AutoResizeRowHeadersWidth.To adjust the width of this column to fit the contents of the row header cells, use the AutoResizeRowHeadersWidth method.

S’applique à

Voir aussi