DataGridView.RowHeadersWidth Proprietà
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.
Ottiene o imposta la larghezza, in pixel, della colonna che contiene le intestazioni di riga.
public:
property int RowHeadersWidth { int get(); void set(int value); };public int RowHeadersWidth { get; set; }member this.RowHeadersWidth : int with get, setPublic Property RowHeadersWidth As IntegerValore della proprietà
Larghezza, in pixel, della colonna che contiene intestazioni di riga. Il valore predefinito è 43.
Eccezioni
Il valore specificato quando si imposta questa proprietà è minore della larghezza minima di 4 pixel o è maggiore della larghezza massima di 32768 pixel.
Esempio
Nell'esempio di codice seguente viene illustrato come utilizzare la RowHeadersWidth proprietà in uno scenario di disegno di riga. Nell'esempio, il valore di questa proprietà viene utilizzato per calcolare i limiti all'interno del quale viene disegnato uno sfondo personalizzato.
Questo codice fa parte di un esempio più ampio disponibile inProcedura: Personalizzare l'aspetto delle righe nel controllo DataGridView di 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
La RowHeadersWidth proprietà può essere utilizzata per ridimensionare la colonna dell'intestazione di riga in una larghezza specificata. Per regolare la larghezza di questa colonna in base al contenuto delle celle dell'intestazione di riga, utilizzare il AutoResizeRowHeadersWidth metodo .
