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


DataGridViewCell Класс

Определение

Представляет отдельную ячейку в элементе управления 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
Наследование
DataGridViewCell
Производный
Атрибуты
Реализации

Примеры

В следующем примере кода показано использование этого типа. Дополнительные сведения об этом примере см. в статье 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()

Возвращает строку, которая описывает текущий объект.

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

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