DataGridViewColumnCollection.GetColumnsWidth 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

傳回要顯示所有符合指定之篩選條件需求的資料行所需的寬度 (以像素為單位)。

public:
 int GetColumnsWidth(System::Windows::Forms::DataGridViewElementStates includeFilter);

public int GetColumnsWidth (System.Windows.Forms.DataGridViewElementStates includeFilter);

member this.GetColumnsWidth : System.Windows.Forms.DataGridViewElementStates -> int

Public Function GetColumnsWidth (includeFilter As DataGridViewElementStates) As Integer

參數

includeFilter

DataGridViewElementStates

表示包含篩選條件之 DataGridViewElementStates 值的位元 (Bitwise) 組合。

傳回

Int32

此寬度是要顯示所有符合篩選條件需求時所需的寬度 (以像素為單位)。

例外狀況

ArgumentException

includeFilter 不是 DataGridViewElementStates 值的有效位元組合。

範例

下列程式碼範例說明如何使用這個方法。 此範例是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

另請參閱

• DataGridView
• DataGridViewColumn
• DataGridViewElementStates