Exporter (0) Imprimer
Développer tout
Développer Réduire

DataGridView.RowHeadersWidth, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

Obtient ou définit la largeur, en pixels, de la colonne qui contient les en-têtes de ligne.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

[LocalizableAttribute(true)] 
public int RowHeadersWidth { get; set; }
/** @property */
public int get_RowHeadersWidth ()

/** @property */
public void set_RowHeadersWidth (int value)

public function get RowHeadersWidth () : int

public function set RowHeadersWidth (value : int)

Valeur de la propriété

Largeur, en pixels, de la colonne qui contient les en-têtes de ligne. La valeur par défaut est 43.

Type d'exceptionCondition

ArgumentOutOfRangeException

La valeur spécifiée lors de la définition de cette propriété est inférieure à la largeur minimale de 4 pixels ou est supérieure à la largeur maximale de 32768 pixels.

La propriété RowHeadersWidth peut être utilisée pour redimensionner la colonne d'en-tête de ligne à une largeur spécifiée. Pour ajuster la largeur de cette colonne au contenu des cellules d'en-tête de ligne, utilisez la méthode AutoResizeRowHeadersWidth.

L'exemple de code suivant illustre comment utiliser la propriété RowHeadersWidth dans un scénario de peinture de ligne. 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é.

Ce code est extrait d'un exemple plus développé disponible dans Comment : personnaliser l'apparence des lignes du contrôle DataGridView Windows Forms.

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

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft