Cette documentation est archivée et n’est pas conservée.

DataGridViewRowPrePaintEventArgs, classe

Fournit des données pour l'événement RowPrePaint.

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

public class DataGridViewRowPrePaintEventArgs : HandledEventArgs
public class DataGridViewRowPrePaintEventArgs extends HandledEventArgs
public class DataGridViewRowPrePaintEventArgs extends HandledEventArgs
Non applicable.

L'événement RowPrePaint se produit avant qu'une ligne soit peinte sur un contrôle DataGridView. RowPrePaint vous permet de modifier manuellement l'apparence de la ligne avant que les cellules soient peintes. Ceci est utile si vous souhaitez personnaliser la ligne, par exemple pour créer une ligne où le contenu d'une colonne s'étend sur plusieurs colonnes. Utilisez les propriétés dans DataGridViewRowPrePaintEventArgs pour obtenir les paramètres de la ligne sans accéder directement à la ligne dans DataGridView.

L'exemple de code suivant montre comment gérer l'événement RowPrePaint pour dessiner un arrière-plan personnalisé pour les cellules sélectionnées. Cet exemple de code fait partie d'un exemple plus développé fourni 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);
        }
    }
}

System.Object
   System.EventArgs
     System.ComponentModel.HandledEventArgs
      System.Windows.Forms.DataGridViewRowPrePaintEventArgs

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0
Afficher: