Практическое руководство. Дополнительные возможности управления внешним видом и поведением ячеек и столбцов элемента управления DataGridView в Windows Forms

Статья
11/05/2008

Обновлен: Ноябрь 2007

Внешний вид и поведение элемента управления DataGridView можно настроить несколькими способами при помощи свойств, событий и сопутствующих классов. В ряде случаев к ячейкам могут предъявлятся требования, когда этих функций будет недостаточно. Дополнительные функциональные возможности можно получить, создав пользовательский класс DataGridViewCell.

Пользовательский класс DataGridViewCell можно получить из базового класса DataGridViewCell или одного из его производных классов. Хотя любой тип ячейки можно отобразить в любом типе столбца, как правило, потребуется также создать пользовательский класс DataGridViewColumn, специально предназначенный для отображения пользовательского типа ячейки. Классы столбцов могут быть производными от DataGridViewColumn или одного из его производных типов.

В следующем примере кода будет создан пользовательский класс ячейки с именем DataGridViewRolloverCell, обнаруживающий пересечение курсором мыши границ ячейки. При помещении курсора мыши в пределы ячейки рисуется внутренняя рамка. Этот новый тип будет производным от DataGridViewTextBoxCell и во всех других отношениях его поведение соответствует поведению базового класса. Сопутствующий класс столбца имеет имя DataGridViewRolloverColumn.

Для использования этих классов необходимо создать форму с элементом управления DataGridView, добавить один или несколько объектов DataGridViewRolloverColumn в коллекцию Columns и заполнить элемент управления столбцами со значениями.

Примечание.
Пример не будет работать правильно с пустыми строками. Например, пустые строки создаются при добавлении строк в элемент управления путем настройки свойства RowCount. Это происходит потому, что добавленные в этом случае строки автоматически становятся общими, и это означает, что объекты DataGridViewRolloverCell не будут создаваться до тех пор, пока не щелкнуть отдельные строки, отменив тем самым блокирование связанных общих строк.

Пример не будет работать правильно с пустыми строками. Например, пустые строки создаются при добавлении строк в элемент управления путем настройки свойства RowCount. Это происходит потому, что добавленные в этом случае строки автоматически становятся общими, и это означает, что объекты DataGridViewRolloverCell не будут создаваться до тех пор, пока не щелкнуть отдельные строки, отменив тем самым блокирование связанных общих строк.

Так как подобный тип настройки ячеек требует, чтобы строки не были общими, он не подходит для использования с большими наборами данных. Дополнительные сведения о совместном использовании строк см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

Примечание.
При наследовании от класса DataGridViewCell или DataGridViewColumn и добавлении в производный класс новых свойств необходимо переопределить метод Clone, чтобы копировать новые свойства в ходе выполнения копирования. Кроме того, необходимо вызвать метод Clone базового класса, чтобы свойства базового класса копировались в новую ячейку или столбец.

При наследовании от класса DataGridViewCell или DataGridViewColumn и добавлении в производный класс новых свойств необходимо переопределить метод Clone, чтобы копировать новые свойства в ходе выполнения копирования. Кроме того, необходимо вызвать метод Clone базового класса, чтобы свойства базового класса копировались в новую ячейку или столбец.

Настройка ячеек и столбцов в элементе управления DataGridView

Создайте новый, производный от типа DataGridViewTextBoxCell класс ячейки с именем DataGridViewRolloverCell.

Public Class DataGridViewRolloverCell
    Inherits DataGridViewTextBoxCell


...


End Class

public class DataGridViewRolloverCell : DataGridViewTextBoxCell
{


...


}

Переопределите метод Paint в классе DataGridViewRolloverCell. При переопределении сначала вызовите реализацию базового класса, обрабатывающую функциональные возможности содержащегося текстового поля. Затем используйте метод PointToClient элемента управления для преобразования положения курсора (в координатах экрана) в DataGridView координаты клиентской области. Если координаты курсора попадают в границы ячейки, рисуется внутренняя рамка.

Protected Overrides Sub Paint( _
    ByVal graphics As Graphics, _
    ByVal clipBounds As Rectangle, _
    ByVal cellBounds As Rectangle, _
    ByVal rowIndex As Integer, _
    ByVal elementState As DataGridViewElementStates, _
    ByVal value As Object, _
    ByVal formattedValue As Object, _
    ByVal errorText As String, _
    ByVal cellStyle As DataGridViewCellStyle, _
    ByVal advancedBorderStyle As DataGridViewAdvancedBorderStyle, _
    ByVal paintParts As DataGridViewPaintParts)

    ' Call the base class method to paint the default cell appearance.
    MyBase.Paint(graphics, clipBounds, cellBounds, rowIndex, elementState, _
        value, formattedValue, errorText, cellStyle, _
        advancedBorderStyle, paintParts)

    ' Retrieve the client location of the mouse pointer.
    Dim cursorPosition As Point = _
        Me.DataGridView.PointToClient(Cursor.Position)

    ' If the mouse pointer is over the current cell, draw a custom border.
    If cellBounds.Contains(cursorPosition) Then
        Dim newRect As New Rectangle(cellBounds.X + 1, _
            cellBounds.Y + 1, cellBounds.Width - 4, _
            cellBounds.Height - 4)
        graphics.DrawRectangle(Pens.Red, newRect)
    End If

End Sub

protected override void Paint(
    Graphics graphics,
    Rectangle clipBounds,
    Rectangle cellBounds,
    int rowIndex,
    DataGridViewElementStates cellState,
    object value,
    object formattedValue,
    string errorText,
    DataGridViewCellStyle cellStyle,
    DataGridViewAdvancedBorderStyle advancedBorderStyle,
    DataGridViewPaintParts paintParts)
{
    // Call the base class method to paint the default cell appearance.
    base.Paint(graphics, clipBounds, cellBounds, rowIndex, cellState,
        value, formattedValue, errorText, cellStyle,
        advancedBorderStyle, paintParts);

    // Retrieve the client location of the mouse pointer.
    Point cursorPosition =
        this.DataGridView.PointToClient(Cursor.Position);

    // If the mouse pointer is over the current cell, draw a custom border.
    if (cellBounds.Contains(cursorPosition))
    {
        Rectangle newRect = new Rectangle(cellBounds.X + 1,
            cellBounds.Y + 1, cellBounds.Width - 4,
            cellBounds.Height - 4);
        graphics.DrawRectangle(Pens.Red, newRect);
    }
}

Переопределите методы OnMouseEnter и OnMouseLeave в классе DataGridViewRolloverCell, чтобы заставить ячейки менять представление при помещении курсора мыши в их границы или при выходе курсора за пределы ячейки.

' Force the cell to repaint itself when the mouse pointer enters it.
Protected Overrides Sub OnMouseEnter(ByVal rowIndex As Integer)
    Me.DataGridView.InvalidateCell(Me)
End Sub

' Force the cell to repaint itself when the mouse pointer leaves it.
Protected Overrides Sub OnMouseLeave(ByVal rowIndex As Integer)
    Me.DataGridView.InvalidateCell(Me)
End Sub

// Force the cell to repaint itself when the mouse pointer enters it.
protected override void OnMouseEnter(int rowIndex)
{
    this.DataGridView.InvalidateCell(this);
}

// Force the cell to repaint itself when the mouse pointer leaves it.
protected override void OnMouseLeave(int rowIndex)
{
    this.DataGridView.InvalidateCell(this);
}

Создайте новый, производный от типа DataGridViewColumn класс с именем DataGridViewRolloverCellColumn. В конструкторе назначьте новый объект DataGridViewRolloverCell его свойству CellTemplate.

Public Class DataGridViewRolloverCellColumn
    Inherits DataGridViewColumn

    Public Sub New()
        Me.CellTemplate = New DataGridViewRolloverCell()
    End Sub

End Class

public class DataGridViewRolloverCellColumn : DataGridViewColumn
{
    public DataGridViewRolloverCellColumn()
    {
        this.CellTemplate = new DataGridViewRolloverCell();
    }
}

Пример

В полном примере кода содержится небольшая тестовая форма, демонстрирующая поведение пользовательского типа ячейки.

Imports System
Imports System.Drawing
Imports System.Windows.Forms

Class Form1
    Inherits Form

    <STAThreadAttribute()> _
    Public Shared Sub Main()
        Application.Run(New Form1())
    End Sub

    Public Sub New()
        Dim dataGridView1 As New DataGridView()
        Dim col As New DataGridViewRolloverCellColumn()
        dataGridView1.Columns.Add(col)
        dataGridView1.Rows.Add(New String() {""})
        dataGridView1.Rows.Add(New String() {""})
        dataGridView1.Rows.Add(New String() {""})
        dataGridView1.Rows.Add(New String() {""})
        Me.Controls.Add(dataGridView1)
        Me.Text = "DataGridView rollover-cell demo"
    End Sub

End Class

Public Class DataGridViewRolloverCell
    Inherits DataGridViewTextBoxCell

    Protected Overrides Sub Paint( _
        ByVal graphics As Graphics, _
        ByVal clipBounds As Rectangle, _
        ByVal cellBounds As Rectangle, _
        ByVal rowIndex As Integer, _
        ByVal elementState As DataGridViewElementStates, _
        ByVal value As Object, _
        ByVal formattedValue As Object, _
        ByVal errorText As String, _
        ByVal cellStyle As DataGridViewCellStyle, _
        ByVal advancedBorderStyle As DataGridViewAdvancedBorderStyle, _
        ByVal paintParts As DataGridViewPaintParts)

        ' Call the base class method to paint the default cell appearance.
        MyBase.Paint(graphics, clipBounds, cellBounds, rowIndex, elementState, _
            value, formattedValue, errorText, cellStyle, _
            advancedBorderStyle, paintParts)

        ' Retrieve the client location of the mouse pointer.
        Dim cursorPosition As Point = _
            Me.DataGridView.PointToClient(Cursor.Position)

        ' If the mouse pointer is over the current cell, draw a custom border.
        If cellBounds.Contains(cursorPosition) Then
            Dim newRect As New Rectangle(cellBounds.X + 1, _
                cellBounds.Y + 1, cellBounds.Width - 4, _
                cellBounds.Height - 4)
            graphics.DrawRectangle(Pens.Red, newRect)
        End If

    End Sub

    ' Force the cell to repaint itself when the mouse pointer enters it.
    Protected Overrides Sub OnMouseEnter(ByVal rowIndex As Integer)
        Me.DataGridView.InvalidateCell(Me)
    End Sub

    ' Force the cell to repaint itself when the mouse pointer leaves it.
    Protected Overrides Sub OnMouseLeave(ByVal rowIndex As Integer)
        Me.DataGridView.InvalidateCell(Me)
    End Sub

End Class

Public Class DataGridViewRolloverCellColumn
    Inherits DataGridViewColumn

    Public Sub New()
        Me.CellTemplate = New DataGridViewRolloverCell()
    End Sub

End Class

using System;
using System.Drawing;
using System.Windows.Forms;

class Form1 : Form
{
    [STAThreadAttribute()]
    public static void Main()
    {
        Application.Run(new Form1());
    }

    public Form1()
    {
        DataGridView dataGridView1 = new DataGridView();
        DataGridViewRolloverCellColumn col =
            new DataGridViewRolloverCellColumn();
        dataGridView1.Columns.Add(col);
        dataGridView1.Rows.Add(new string[] { "" });
        dataGridView1.Rows.Add(new string[] { "" });
        dataGridView1.Rows.Add(new string[] { "" });
        dataGridView1.Rows.Add(new string[] { "" });
        this.Controls.Add(dataGridView1);
        this.Text = "DataGridView rollover-cell demo";
    }
}

public class DataGridViewRolloverCell : DataGridViewTextBoxCell
{
    protected override void Paint(
        Graphics graphics,
        Rectangle clipBounds,
        Rectangle cellBounds,
        int rowIndex,
        DataGridViewElementStates cellState,
        object value,
        object formattedValue,
        string errorText,
        DataGridViewCellStyle cellStyle,
        DataGridViewAdvancedBorderStyle advancedBorderStyle,
        DataGridViewPaintParts paintParts)
    {
        // Call the base class method to paint the default cell appearance.
        base.Paint(graphics, clipBounds, cellBounds, rowIndex, cellState,
            value, formattedValue, errorText, cellStyle,
            advancedBorderStyle, paintParts);

        // Retrieve the client location of the mouse pointer.
        Point cursorPosition =
            this.DataGridView.PointToClient(Cursor.Position);

        // If the mouse pointer is over the current cell, draw a custom border.
        if (cellBounds.Contains(cursorPosition))
        {
            Rectangle newRect = new Rectangle(cellBounds.X + 1,
                cellBounds.Y + 1, cellBounds.Width - 4,
                cellBounds.Height - 4);
            graphics.DrawRectangle(Pens.Red, newRect);
        }
    }

    // Force the cell to repaint itself when the mouse pointer enters it.
    protected override void OnMouseEnter(int rowIndex)
    {
        this.DataGridView.InvalidateCell(this);
    }

    // Force the cell to repaint itself when the mouse pointer leaves it.
    protected override void OnMouseLeave(int rowIndex)
    {
        this.DataGridView.InvalidateCell(this);
    }

}

public class DataGridViewRolloverCellColumn : DataGridViewColumn
{
    public DataGridViewRolloverCellColumn()
    {
        this.CellTemplate = new DataGridViewRolloverCell();
    }
}

Компиляция кода

Для этого примера требуются следующие компоненты:

Ссылки на сборки System, System.Windows.Forms и System.Drawing.

Дополнительные сведения о построении этого примера из командной строки для Visual Basic или Visual C# см. в разделе Построение из командной строки (Visual Basic) или Построение из командной строки с помощью csc.exe. Можно также построить этот пример в Visual Studio путем вставки кода в новый проект. Дополнительные сведения см. в разделах Практическое руководство. Компиляция и выполнение откомпилированного примера кода формы Windows Forms с помощью Visual Studio и Практическое руководство. Компиляция и выполнение откомпилированного примера кода формы Windows Forms с помощью Visual Studio и Практическое руководство. Компиляция и выполнение откомпилированного примера кода формы Windows Forms с помощью Visual Studio.

См. также

Поделиться через

Практическое руководство. Дополнительные возможности управления внешним видом и поведением ячеек и столбцов элемента управления DataGridView в Windows Forms

Настройка ячеек и столбцов в элементе управления DataGridView

Пример

Компиляция кода

См. также

Основные понятия

Ссылки

Другие ресурсы

Дополнительные ресурсы