DataGridView.RowPrePaint Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica prima che un oggetto DataGridViewRow venga disegnato.
public:
event System::Windows::Forms::DataGridViewRowPrePaintEventHandler ^ RowPrePaint;public event System.Windows.Forms.DataGridViewRowPrePaintEventHandler RowPrePaint;public event System.Windows.Forms.DataGridViewRowPrePaintEventHandler? RowPrePaint;member this.RowPrePaint : System.Windows.Forms.DataGridViewRowPrePaintEventHandler Public Custom Event RowPrePaint As DataGridViewRowPrePaintEventHandler Tipo evento
Esempio
Nell'esempio di codice seguente viene illustrato come usare un gestore per l'evento RowPrePaint per disegnare uno sfondo di riga sfumato se la riga è selezionata. Questo esempio fa parte di un esempio più ampio disponibile in Procedura: Personalizzare l'aspetto delle righe nel controllo 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);
}
}
}
' 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
Commenti
È possibile gestire questo evento da solo o in combinazione con l'evento per personalizzare l'aspetto RowPostPaint delle righe nel controllo . È possibile disegnare manualmente intere righe o disegnare parti specifiche di righe e utilizzare i metodi seguenti della DataGridViewRowPrePaintEventArgs classe per disegnare altre parti:
È anche possibile usare la VisualStyleRenderer classe per disegnare i controlli standard usando il tema corrente. Per altre informazioni, vedere Rendering di controlli con stili di visualizzazione. Se si usa Visual Studio 2005, è anche possibile accedere a una vasta libreria di immagini standard che è possibile usare con il DataGridView controllo .
Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.
