DataGridViewCell Класс

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Исходный код:: DataGridViewCell.cs

Исходный код:: DataGridViewCell.cs

Исходный код:: DataGridViewCell.cs

Исходный код:: DataGridViewCell.cs

Исходный код:: DataGridViewCell.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет отдельную ячейку в элементе 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))]
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.Interfaces | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
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

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))>]
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.Interfaces | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
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

Подробнее…

Атрибуты: TypeConverterAttribute DynamicallyAccessedMembersAttribute

Реализации: ICloneable IDisposable

Примеры

В следующем примере кода показано использование этого типа. Дополнительные сведения об этом примере см. в разделе How to: Добавление подсказок в отдельные ячейки в элементе управления DataGridView Windows Forms.

// 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. Типичная ячейка содержит данные, относящиеся к строке и столбцу, в котором он содержится. Ячейку можно настроить несколькими способами, задав его свойства и обрабатывая события, связанные с ним.

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

При получении и 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, Boolean)	Возвращает высоту в пикселях указанного текста, учитывая указанные характеристики. Также указывает, превышает ли требуемую ширину указанную максимальную ширину.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Возвращает высоту в пикселях указанного текста, учитывая указанные характеристики.
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()	Возвращает строку, описывающую текущий объект.

Применяется к

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

Обратная связь

Были ли сведения на этой странице полезными?