DataGridView.RowPrePaint Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre antes de uma DataGridViewRow ser pintada.
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 de evento
Exemplos
O exemplo de código a seguir demonstra como usar um manipulador para o RowPrePaint evento para pintar uma tela de fundo de linha de gradiente se a linha estiver selecionada. Este exemplo faz parte de um exemplo maior disponível em How 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
Comentários
Você pode lidar com esse evento sozinho ou em combinação com o RowPostPaint evento para personalizar a aparência das linhas no controle. Você mesmo pode pintar linhas inteiras ou pintar partes específicas de linhas e usar os seguintes métodos da DataGridViewRowPrePaintEventArgs classe para pintar outras partes:
Você também pode usar a VisualStyleRenderer classe para pintar controles padrão usando o tema atual. Para obter mais informações, consulte Renderizando controles com estilos visuais. Se você estiver usando o Visual Studio 2005, também terá acesso a uma grande biblioteca de imagens padrão que pode ser usada com o DataGridView controle .
Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.
