DataGridViewTextBoxCell Класс

Ссылка

Определение

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

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

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

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

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

Важно!

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

Отображает изменяемые текстовые сведения в элементе управления DataGridView.

public ref class DataGridViewTextBoxCell : System::Windows::Forms::DataGridViewCell

public class DataGridViewTextBoxCell : System.Windows.Forms.DataGridViewCell

type DataGridViewTextBoxCell = class
    inherit DataGridViewCell

Public Class DataGridViewTextBoxCell
Inherits DataGridViewCell

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

DataGridViewElement

DataGridViewCell
DataGridViewTextBoxCell

Примеры

В следующем примере кода показано, как использовать в DataGridViewCell качестве шаблона для DataGridViewColumn. Изменения стиля, внесенные в любую ячейку столбца, влияют на все ячейки столбца. Этот пример входит в состав более крупного примера использования класса DataGridViewColumn.

void CustomizeCellsInThirdColumn()
{
   int thirdColumn = 2;
   DataGridViewColumn^ column = dataGridView->Columns[ thirdColumn ];
   DataGridViewCell^ cell = gcnew DataGridViewTextBoxCell;
   cell->Style->BackColor = Color::Wheat;
   column->CellTemplate = cell;
}

private void CustomizeCellsInThirdColumn()
{
    int thirdColumn = 2;
    DataGridViewColumn column =
        dataGridView.Columns[thirdColumn];
    DataGridViewCell cell = new DataGridViewTextBoxCell();

    cell.Style.BackColor = Color.Wheat;
    column.CellTemplate = cell;
}

Private Sub CustomizeCellsInThirdColumn()

    Dim thirdColumn As Integer = 2
    Dim column As DataGridViewColumn = _
        dataGridView.Columns(thirdColumn)
    Dim cell As DataGridViewCell = _
        New DataGridViewTextBoxCell()

    cell.Style.BackColor = Color.Wheat
    column.CellTemplate = cell
End Sub

Класс DataGridViewTextBoxCell является специализированным типом , используемым DataGridViewCell для отображения одной строки редактируемой текстовой информации. В выбранном DataGridViewTextBoxCell в данный момент размещается DataGridViewTextBoxEditingControl элемент управления, в котором пользователь может изменять значение ячейки (при условииDataGridViewTextBoxCell, что ReadOnly свойство объекта имеет значение false).

— DataGridViewTextBoxColumn это тип столбца, специализированный для хранения ячеек этого типа. По умолчанию объект инициализируется DataGridViewTextBoxColumn.CellTemplate новым DataGridViewTextBoxCell. Чтобы создать шаблон ячеек в столбце после существующего DataGridViewTextBoxCell, задайте для свойства столбца CellTemplate ячейку, используемую в качестве шаблона.

Свойства столбца, связанные с ячейками, являются оболочками для свойств ячейки шаблона с аналогичными именами. Изменение значений свойств ячейки шаблона повлияет только на ячейки на основе шаблона, которые добавляются после изменения. Однако изменение значений свойств столбца, связанных с ячейками, обновит ячейку шаблона и все остальные ячейки в столбце и при необходимости обновит отображение столбца.

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

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

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

DataGridViewTextBoxCell()

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

Свойства

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

Методы

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Изменяет стиль границ входной ячейки в соответствии с указанными критериями. (Унаследовано от DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Возвращает объект Rectangle, представляющий значения ширины всех полей ячейки. (Унаследовано от DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли отменен общий доступ к строке ячейки, если щелкнуть ячейку. (Унаследовано от DataGridViewCell)
Clone()	Создает точную копию данной ячейки.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли отменен общий доступ к строке ячейки, если щелкнуть содержимое ячейки. (Унаследовано от DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли отменен общий доступ к строке ячейки по двойному щелчку содержимого ячейки. (Унаследовано от DataGridViewCell)
CreateAccessibilityInstance()	Создает новый AccessibleObject для этого экземпляра DataGridViewTextBoxCell.
CreateAccessibilityInstance()	Создает новый доступный объект для DataGridViewCell. (Унаследовано от DataGridViewCell)
DetachEditingControl()	Удаляет элемент управления "Правка" ячейки из объекта DataGridView.
Dispose()	Освобождает все ресурсы, занятые модулем DataGridViewCell. (Унаследовано от DataGridViewCell)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом DataGridViewCell, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли отменен общий доступ к строке ячейки по двойному щелчку ячейки. (Унаследовано от DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Указывает, будет ли отменен общий доступ к родительской строке при перемещении фокуса на ячейку. (Унаследовано от DataGridViewCell)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Извлекает форматированное значение ячейки для копирования в объект Clipboard. (Унаследовано от DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Возвращает прямоугольник, ограничивающий область содержимого ячейки, которая рассчитывается, используя указанный объект Graphics и стиль ячейки.
GetContentBounds(Int32)	Возвращает прямоугольник, ограничивающий область содержимого ячейки, используя объект Graphics по умолчанию и стиль ячейки, действующий в текущий момент для ячейки. (Унаследовано от DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Возвращает текущее форматированное значение ячейки независимо от того, находится ли ячейка в режиме редактирования и что значение не было зафиксировано. (Унаследовано от DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Возвращает прямоугольник, ограничивающий значок ошибки ячейки, если такой отображается.
GetErrorText(Int32)	Возвращает строку, представляющую ошибку для ячейки. (Унаследовано от DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Возвращает значение ячейки, отформатированное для отображения. (Унаследовано от DataGridViewCell)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetInheritedContextMenuStrip(Int32)	Возвращает наследуемое контекстное меню для текущей ячейки. (Унаследовано от DataGridViewCell)
GetInheritedState(Int32)	Возвращает значение, указывающее текущее состояние ячейки, как наследуемое от состояния ее строки и столбца. (Унаследовано от DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Получает стиль, примененный к ячейке. (Унаследовано от DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Вычисляет предпочтительный размер ячейки в пикселях.
GetSize(Int32)	Возвращает размер ячейки. (Унаследовано от DataGridViewCell)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValue(Int32)	Получает значение ячейки. (Унаследовано от DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Присоединяет и инициализирует размещенный элемент управления, поддерживающий редактирование.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Указывает, будет ли отменен общий доступ к родительской строке при нажатии пользователем клавиши, когда фокус установлен на ячейку. (Унаследовано от DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	Определяет, должен ли режим редактирования запускаться на основе заданной клавиши.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Указывает, будет ли отменен общий доступ к строке, если нажать клавишу, когда фокус установлен на ячейку в строке. (Унаследовано от DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Указывает, будет ли отменен общий доступ к родительской строке при отпускании пользователем клавиши, когда фокус установлен на ячейку. (Унаследовано от DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Указывает, будет ли отменен общий доступ к строке при перемещении фокуса с ячейки в строке. (Унаследовано от DataGridViewCell)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли отменен общий доступ к строке по щелчку пользователем кнопки мыши, когда указатель установлен на ячейку в строке. (Унаследовано от DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли отменен общий доступ к строке, когда пользователь дважды щелкает ячейку в этой строке. (Унаследовано от DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли отменен общий доступ к строке при удерживании пользователем кнопки мыши, когда указатель наведен на ячейку в строке. (Унаследовано от DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Указывает, будет ли отменен общий доступ к строке при перемещении указателя мыши на ячейку в строке. (Унаследовано от DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Указывает, будет ли отменен общий доступ к строке, когда указатель мыши перемещается со строки. (Унаследовано от DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли отменен общий доступ к строке при перемещении указателя мыши на ячейку в строке. (Унаследовано от DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли отменен общий доступ к строке при отпускании пользователем кнопки мыши, когда указатель установлен на ячейку в строке. (Унаследовано от DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Вызывается по щелчку ячейки. (Унаследовано от DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Вызывается по щелчку содержимого ячейки. (Унаследовано от DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Вызывается по двойному щелчку содержимого ячейки. (Унаследовано от DataGridViewCell)
OnDataGridViewChanged()	Вызывается при изменении свойства DataGridView ячейки. (Унаследовано от DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Вызывается по двойному щелчку ячейки. (Унаследовано от DataGridViewCell)
OnEnter(Int32, Boolean)	Вызывается DataGridView при перемещении указателя выбора на ячейку.
OnKeyDown(KeyEventArgs, Int32)	Вызывается при нажатии клавиши знака, когда фокус установлен на ячейку. (Унаследовано от DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Вызывается при нажатии клавиши, когда фокус установлен на ячейку. (Унаследовано от DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Вызывается при отпускании клавиши знака, когда фокус установлен на ячейку. (Унаследовано от DataGridViewCell)
OnLeave(Int32, Boolean)	Вызывается объектом DataGridView при покидании указателем мыши ячейки.
OnMouseClick(DataGridViewCellMouseEventArgs)	Вызывается объектом DataGridView при покидании указателем мыши ячейки.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Вызывается по двойному щелчку пользователем кнопки мыши, когда указатель наведен на ячейку. (Унаследовано от DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Вызывается при удерживании пользователем кнопки мыши, когда указатель наведен на ячейку. (Унаследовано от DataGridViewCell)
OnMouseEnter(Int32)	Вызывается при перемещении указателя мыши на ячейку. (Унаследовано от DataGridViewCell)
OnMouseLeave(Int32)	Вызывается, когда указатель мыши покидает ячейку. (Унаследовано от DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Вызывается при перемещении указателя мыши внутри ячейки. (Унаследовано от DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Вызывается при отпускании пользователем кнопки мыши, когда указатель наведен на ячейку. (Унаследовано от DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Закрашивает текущую ячейку DataGridViewCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Окрашивает границу текущей ячейки DataGridViewCell. (Унаследовано от DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Окрашивает значок ошибки текущей ячейки DataGridViewCell. (Унаследовано от DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Преобразует значение, отформатированное для отображения, в реальное значение ячейки. (Унаследовано от DataGridViewCell)
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Задает местоположение и размер элемента управления "Поле ввода", размещаемого в ячейке элемента управления DataGridView.
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Задает местоположение и размер панели редактирования, размещаемой в ячейке, и возвращает нормальные границы элемента управления "поле ввода" в панели редактирования. (Унаследовано от DataGridViewCell)
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)	Устанавливает значение ячейки. (Унаследовано от DataGridViewCell)
ToString()	Возвращает строку, которая описывает текущий объект.

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

Продукт	Версии
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

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

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.

Отзыв о .NET

.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:

Открыть проблему с документацией Отзыв о продукте

Подключайтесь, создавайте код и развивайтесь

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