DataGridViewCell Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Представляет отдельную ячейку в элементе управления DataGridView.

public ref class DataGridViewCell abstract : System::Windows::Forms::DataGridViewElement, ICloneable, IDisposable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))]
public abstract class DataGridViewCell : System.Windows.Forms.DataGridViewElement, ICloneable, IDisposable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))>]
type DataGridViewCell = class
    inherit DataGridViewElement
    interface ICloneable
    interface IDisposable

Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable

Наследование

Object

DataGridViewElement

DataGridViewCell

Производный

System.Windows.Forms.DataGridViewButtonCell

System.Windows.Forms.DataGridViewCheckBoxCell

System.Windows.Forms.DataGridViewComboBoxCell

System.Windows.Forms.DataGridViewHeaderCell

System.Windows.Forms.DataGridViewImageCell

System.Windows.Forms.DataGridViewLinkCell

System.Windows.Forms.DataGridViewTextBoxCell

Атрибуты

TypeConverterAttribute

Реализации

ICloneable IDisposable

Примеры

В следующем примере кода показано использование этого типа. Дополнительные сведения об этом примере см. в статье How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control.

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(Object^ /*sender*/, 
    DataGridViewCellFormattingEventArgs^ e)
{
    if ( (e->ColumnIndex == this->dataGridView1->Columns["Rating"]->Index)
        && e->Value != nullptr )
    {
        DataGridViewCell^ cell = 
            this->dataGridView1->Rows[e->RowIndex]->Cells[e->ColumnIndex];
        if (e->Value->Equals("*"))
        {                
            cell->ToolTipText = "very bad";
        }
        else if (e->Value->Equals("**"))
        {
            cell->ToolTipText = "bad";
        }
        else if (e->Value->Equals("***"))
        {
            cell->ToolTipText = "good";
        }
        else if (e->Value->Equals("****"))
        {
            cell->ToolTipText = "very good";
        }
    }
}

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(object sender, 
    DataGridViewCellFormattingEventArgs e)
{
    if ( (e.ColumnIndex == this.dataGridView1.Columns["Rating"].Index)
        && e.Value != null )
    {
        DataGridViewCell cell = 
            this.dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];
        if (e.Value.Equals("*"))
        {                
            cell.ToolTipText = "very bad";
        }
        else if (e.Value.Equals("**"))
        {
            cell.ToolTipText = "bad";
        }
        else if (e.Value.Equals("***"))
        {
            cell.ToolTipText = "good";
        }
        else if (e.Value.Equals("****"))
        {
            cell.ToolTipText = "very good";
        }
    }
}

' Sets the ToolTip text for cells in the Rating column.
Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting

    If e.ColumnIndex = Me.dataGridView1.Columns("Rating").Index _
        AndAlso (e.Value IsNot Nothing) Then

        With Me.dataGridView1.Rows(e.RowIndex).Cells(e.ColumnIndex)

            If e.Value.Equals("*") Then
                .ToolTipText = "very bad"
            ElseIf e.Value.Equals("**") Then
                .ToolTipText = "bad"
            ElseIf e.Value.Equals("***") Then
                .ToolTipText = "good"
            ElseIf e.Value.Equals("****") Then
                .ToolTipText = "very good"
            End If

        End With

    End If

End Sub

Комментарии

Класс DataGridViewCell представляет отдельную ячейку в элементе DataGridView управления . Ячейки можно получить через коллекцию CellsDataGridViewRowобъекта .

Строка и столбец для идентифицируют DataGridViewCell расположение ячейки DataGridViewв . Типичная ячейка содержит данные, относящиеся к строке и столбцу, в которых она содержится. Ячейку можно настроить несколькими способами, задав ее свойства и обрабатывая связанные с ней события.

Примечания для тех, кто реализует этот метод

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

Конструкторы

DataGridViewCell()

Инициализирует новый экземпляр класса DataGridViewCell.

Свойства

AccessibilityObject	Получает значение DataGridViewCell.DataGridViewCellAccessibleObject, присвоенное объекту DataGridViewCell.
ColumnIndex	Получает индекс столбца для данной ячейки.
ContentBounds	Возвращает прямоугольник, ограничивающий область содержимого ячейки.
ContextMenuStrip	Получает или задает контекстное меню, связанное с ячейкой.
DataGridView	Получает элемент управления DataGridView, связанный с данным элементом. (Унаследовано от DataGridViewElement)
DefaultNewRowValue	Возвращает значение по умолчанию для ячейки в строке для новых записей.
Displayed	Получает значение, показывающее, отображается ли ячейка в текущий момент на экране.
EditedFormattedValue	Получает текущее форматированное значение ячейки независимо от того, находится ли ячейка в режиме редактирования, и что значение не зафиксировано.
EditType	Получает тип размещенного элемента управления "Поле ввода", который относится к ячейке.
ErrorIconBounds	Возвращает границы значка ошибки для ячейки.
ErrorText	Получает или задает текст, описывающий условие ошибки, связанное с ячейкой.
FormattedValue	Возвращает значение ячейки, отформатированное для отображения.
FormattedValueType	Получает тип форматированного значения, связанного с ячейкой.
Frozen	Получает значение, указывающее, заморожена ли ячейка.
HasStyle	Получает значение, показывающее, было ли установлено свойство Style.
InheritedState	Возвращает текущее состояние ячейки как наследуемое от состояния ее строки и столбца.
InheritedStyle	Получает стиль, применяемый в текущий момент к ячейке.
IsInEditMode	Возвращает значение, указывающее, редактируется ли данная ячейка в настоящий момент.
OwningColumn	Возвращает столбец, в котором содержится данная ячейка.
OwningRow	Получает строку, содержащую эту ячейку.
PreferredSize	Получает размер (в пикселях) прямоугольной области, в которую может быть вписана ячейка.
ReadOnly	Получает или задает значение, показывающее, можно ли изменять данные в ячейке.
Resizable	Получает значение, указывающее возможность изменения размеров ячейки.
RowIndex	Получает индекс родительской строки ячейки.
Selected	Получает или задает значение, указывающее, была ли выбрана ячейка.
Size	Возвращает размер ячейки.
State	Получает состояние пользовательского интерфейса для элемента. (Унаследовано от DataGridViewElement)
Style	Получает или задает стиль ячейки.
Tag	Получает или задает объект, содержащий дополнительные данные о ячейке.
ToolTipText	Возвращает или задает текст всплывающей подсказки, связанной с этой ячейкой.
Value	Получает или задает значение, связанное с этой ячейкой.
ValueType	Получает или задает тип данных для значений в ячейке.
Visible	Получает значение, указывающее, находится ли ячейка в скрытой строке или скрытом столбце.

Методы

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Изменяет стиль границ входной ячейки в соответствии с указанными критериями.
BorderWidths(DataGridViewAdvancedBorderStyle)	Возвращает объект Rectangle, представляющий значения ширины всех полей ячейки.
ClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли отменен общий доступ к строке ячейки, если щелкнуть ячейку.
Clone()	Создает точную копию данной ячейки.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли отменен общий доступ к строке ячейки, если щелкнуть содержимое ячейки.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли отменен общий доступ к строке ячейки по двойному щелчку содержимого ячейки.
CreateAccessibilityInstance()	Создает новый доступный объект для DataGridViewCell.
DetachEditingControl()	Удаляет элемент управления "Правка" ячейки из объекта DataGridView.
Dispose()	Освобождает все ресурсы, занятые модулем DataGridViewCell.
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом DataGridViewCell, а при необходимости освобождает также управляемые ресурсы.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли отменен общий доступ к строке ячейки по двойному щелчку ячейки.
EnterUnsharesRow(Int32, Boolean)	Указывает, будет ли отменен общий доступ к родительской строке при перемещении фокуса на ячейку.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Finalize()	Освобождает неуправляемые ресурсы и выполняет другие операции очистки, перед тем как объект DataGridViewCell будет утилизирован во время сборки мусора.
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Извлекает форматированное значение ячейки для копирования в объект Clipboard.
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Возвращает прямоугольник, ограничивающий область содержимого ячейки, которая рассчитывается, используя указанный объект Graphics и стиль ячейки.
GetContentBounds(Int32)	Возвращает прямоугольник, ограничивающий область содержимого ячейки, используя объект Graphics по умолчанию и стиль ячейки, действующий в текущий момент для ячейки.
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Возвращает текущее форматированное значение ячейки независимо от того, находится ли ячейка в режиме редактирования и что значение не было зафиксировано.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Возвращает прямоугольник, ограничивающий значок ошибки ячейки, если такой отображается.
GetErrorText(Int32)	Возвращает строку, представляющую ошибку для ячейки.
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Возвращает значение ячейки, отформатированное для отображения.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetInheritedContextMenuStrip(Int32)	Возвращает наследуемое контекстное меню для текущей ячейки.
GetInheritedState(Int32)	Возвращает значение, указывающее текущее состояние ячейки, как наследуемое от состояния ее строки и столбца.
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Получает стиль, примененный к ячейке.
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Вычисляет предпочтительный размер ячейки в пикселях.
GetSize(Int32)	Возвращает размер ячейки.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValue(Int32)	Получает значение ячейки.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Инициализирует элемент управления, используемый для изменения ячейки.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Указывает, будет ли отменен общий доступ к родительской строке при нажатии пользователем клавиши, когда фокус установлен на ячейку.
KeyEntersEditMode(KeyEventArgs)	Определяет, должен ли режим редактирования запускаться на основе заданной клавиши.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Указывает, будет ли отменен общий доступ к строке, если нажать клавишу, когда фокус установлен на ячейку в строке.
KeyUpUnsharesRow(KeyEventArgs, Int32)	Указывает, будет ли отменен общий доступ к родительской строке при отпускании пользователем клавиши, когда фокус установлен на ячейку.
LeaveUnsharesRow(Int32, Boolean)	Указывает, будет ли отменен общий доступ к строке при перемещении фокуса с ячейки в строке.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Возвращает высоту указанного текста в пикселях при заданных характеристиках.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)	Возвращает высоту указанного текста в пикселях при заданных характеристиках. Кроме того, показывает, превышает ли требуемая ширина заданную максимальную ширину.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)	Возвращает идеальные значения высоты и ширины указанного текста при заданных характеристиках.
MeasureTextSize(Graphics, String, Font, TextFormatFlags)	Возвращает значения высоты и ширины указанного текста при заданных характеристиках.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)	Возвращает ширину указанного текста в пикселях при заданных характеристиках.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли отменен общий доступ к строке по щелчку пользователем кнопки мыши, когда указатель установлен на ячейку в строке.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли отменен общий доступ к строке, когда пользователь дважды щелкает ячейку в этой строке.
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли отменен общий доступ к строке при удерживании пользователем кнопки мыши, когда указатель наведен на ячейку в строке.
MouseEnterUnsharesRow(Int32)	Указывает, будет ли отменен общий доступ к строке при перемещении указателя мыши на ячейку в строке.
MouseLeaveUnsharesRow(Int32)	Указывает, будет ли отменен общий доступ к строке, когда указатель мыши перемещается со строки.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли отменен общий доступ к строке при перемещении указателя мыши на ячейку в строке.
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли отменен общий доступ к строке при отпускании пользователем кнопки мыши, когда указатель установлен на ячейку в строке.
OnClick(DataGridViewCellEventArgs)	Вызывается по щелчку ячейки.
OnContentClick(DataGridViewCellEventArgs)	Вызывается по щелчку содержимого ячейки.
OnContentDoubleClick(DataGridViewCellEventArgs)	Вызывается по двойному щелчку содержимого ячейки.
OnDataGridViewChanged()	Вызывается при изменении свойства DataGridView ячейки.
OnDoubleClick(DataGridViewCellEventArgs)	Вызывается по двойному щелчку ячейки.
OnEnter(Int32, Boolean)	Вызывается при перемещении фокуса на ячейку.
OnKeyDown(KeyEventArgs, Int32)	Вызывается при нажатии клавиши знака, когда фокус установлен на ячейку.
OnKeyPress(KeyPressEventArgs, Int32)	Вызывается при нажатии клавиши, когда фокус установлен на ячейку.
OnKeyUp(KeyEventArgs, Int32)	Вызывается при отпускании клавиши знака, когда фокус установлен на ячейку.
OnLeave(Int32, Boolean)	Вызывается при перемещении фокуса с ячейки.
OnMouseClick(DataGridViewCellMouseEventArgs)	Вызывается по щелчку пользователем кнопки мыши, когда указатель наведен на ячейку.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Вызывается по двойному щелчку пользователем кнопки мыши, когда указатель наведен на ячейку.
OnMouseDown(DataGridViewCellMouseEventArgs)	Вызывается при удерживании пользователем кнопки мыши, когда указатель наведен на ячейку.
OnMouseEnter(Int32)	Вызывается при перемещении указателя мыши на ячейку.
OnMouseLeave(Int32)	Вызывается, когда указатель мыши покидает ячейку.
OnMouseMove(DataGridViewCellMouseEventArgs)	Вызывается при перемещении указателя мыши внутри ячейки.
OnMouseUp(DataGridViewCellMouseEventArgs)	Вызывается при отпускании пользователем кнопки мыши, когда указатель наведен на ячейку.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Закрашивает текущую ячейку DataGridViewCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Окрашивает границу текущей ячейки DataGridViewCell.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Окрашивает значок ошибки текущей ячейки DataGridViewCell.
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Преобразует значение, отформатированное для отображения, в реальное значение ячейки.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Задает местоположение и размер элемента управления "Поле ввода", размещаемого ячейкой в элементе управления DataGridView.
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Задает местоположение и размер панели редактирования, размещаемой в ячейке, и возвращает нормальные границы элемента управления "поле ввода" в панели редактирования.
RaiseCellClick(DataGridViewCellEventArgs)	Вызывает событие CellClick. (Унаследовано от DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Вызывает событие CellContentClick. (Унаследовано от DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Вызывает событие CellContentDoubleClick. (Унаследовано от DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Вызывает событие CellValueChanged. (Унаследовано от DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Вызывает событие DataError. (Унаследовано от DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Вызывает событие MouseWheel. (Унаследовано от DataGridViewElement)
SetValue(Int32, Object)	Устанавливает значение ячейки.
ToString()	Возвращает строку, которая описывает текущий объект.

См. также раздел

• DataGridView
• ICloneable
• IDisposable