DataGridViewTextBoxCell Класс

Определение

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

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

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

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

Исходный код:: 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 управления, в котором пользователь может изменить значение ячейки (при условииReadOnly, что для свойства DataGridViewTextBoxCell задано значение false).DataGridViewTextBoxEditingControl

Тип 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()	Возвращает строку, описывающую текущий объект.

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

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

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

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

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