DataGridViewTextBoxCell 类

定义

显示 DataGridView 控件中的可编辑文本信息。Displays editable text information in a DataGridView control.

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
继承
DataGridViewTextBoxCell

示例

下面的代码示例演示如何将DataGridViewCell用作的模板。 DataGridViewColumnThe following code example demonstrates how to use a DataGridViewCell as a template for a DataGridViewColumn. 对列中的任何单元格所做的样式更改都将影响列的所有单元格。Style changes made to any cell in the column affect all of the column's cells. 此代码示例是为DataGridViewColumn类提供的更大示例的一部分。This code example is part of a larger example provided for the DataGridViewColumn class.

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

注解

类是一种专用DataGridViewCell类型, 用于显示基于文本的可编辑信息的单个字符串。 DataGridViewTextBoxCellThe DataGridViewTextBoxCell class is a specialized type of DataGridViewCell used to display a single string of editable text-based information. 当前DataGridViewTextBoxCell选定的承载一个DataGridViewTextBoxEditingControl控件, 用户可以在其中编辑单元格ReadOnly的值 (假定的DataGridViewTextBoxCell属性设置为false)。The currently selected DataGridViewTextBoxCell hosts a DataGridViewTextBoxEditingControl control in which the user can edit the cell's value (assuming the ReadOnly property of the DataGridViewTextBoxCell is set to false).

DataGridViewTextBoxColumn是专用于保存此类型的单元格的列类型。The DataGridViewTextBoxColumn is the column type specialized to hold cells of this type. 默认情况下, DataGridViewTextBoxColumn.CellTemplate初始化为新DataGridViewTextBoxCell的。By default, the DataGridViewTextBoxColumn.CellTemplate is initialized to a new DataGridViewTextBoxCell. 若要在现有DataGridViewTextBoxCell的后面对列中的单元格进行样式设置, 请将列的CellTemplate属性设置为要用作模式的单元格。To pattern the cells within a column after an existing DataGridViewTextBoxCell, set the column's CellTemplate property to the cell to use as a pattern.

此列的单元格相关属性是模板单元的名称相同的属性的包装。The cell-related properties of the column are wrappers for the similarly-named properties of the template cell. 更改模板单元的属性值将仅影响基于更改后添加的模板的单元格。Changing the property values of the template cell will affect only cells based on the template that are added after the change. 但是, 更改列的单元格相关属性值将更新列中的模板单元和所有其他单元, 并在必要时刷新列显示。Changing the cell-related property values of the column, however, will update the template cell and all other cells in the column, and refresh the column display if necessary.

继承者说明

当从DataGridViewTextBoxCell派生类派生并向其添加新属性时, 请确保Clone()重写方法以在克隆操作过程中复制新属性。When you derive from DataGridViewTextBoxCell and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. 还应调用基类的Clone()方法, 以便将基类的属性复制到新单元。You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

构造函数

DataGridViewTextBoxCell()

初始化 DataGridViewTextBoxCell 类的新实例。Initializes a new instance of the DataGridViewTextBoxCell class.

属性

AccessibilityObject

获取分配给 DataGridViewCell.DataGridViewCellAccessibleObjectDataGridViewCellGets the DataGridViewCell.DataGridViewCellAccessibleObject assigned to the DataGridViewCell.

(继承自 DataGridViewCell)
ColumnIndex

获取此单元格的列索引。Gets the column index for this cell.

(继承自 DataGridViewCell)
ContentBounds

获取环绕单元格内容区域的边框。Gets the bounding rectangle that encloses the cell's content area.

(继承自 DataGridViewCell)
ContextMenuStrip

获取或设置与单元格关联的快捷菜单。Gets or sets the shortcut menu associated with the cell.

(继承自 DataGridViewCell)
DataGridView

获取与此元素关联的 DataGridView 控件。Gets the DataGridView control associated with this element.

(继承自 DataGridViewElement)
DefaultNewRowValue

获取新记录所在行中单元格的默认值。Gets the default value for a cell in the row for new records.

(继承自 DataGridViewCell)
Displayed

获取一个值,该值指示当前该单元格是否显示在屏幕上。Gets a value that indicates whether the cell is currently displayed on-screen.

(继承自 DataGridViewCell)
EditedFormattedValue

获取该单元格的当前格式化值,而不考虑该单元格是否处于编辑模式,也不论是否尚未提交此值。Gets the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

(继承自 DataGridViewCell)
EditType

获取单元格的寄宿编辑控件的类型。Gets the type of the cell's hosted editing control.

(继承自 DataGridViewCell)
ErrorIconBounds

获取单元格的错误图标的界限。Gets the bounds of the error icon for the cell.

(继承自 DataGridViewCell)
ErrorText

获取或设置描述与该单元格关联的错误条件的文本。Gets or sets the text describing an error condition associated with the cell.

(继承自 DataGridViewCell)
FormattedValue

获取为显示进行格式化的单元格的值。Gets the value of the cell as formatted for display.

(继承自 DataGridViewCell)
FormattedValueType

获取与该单元格关联的格式化值的类型。Gets the type of the formatted value associated with the cell.

Frozen

获取指示单元格是否已被冻结的值。Gets a value indicating whether the cell is frozen.

(继承自 DataGridViewCell)
HasStyle

获取指示是否已设置 Style 属性的值。Gets a value indicating whether the Style property has been set.

(继承自 DataGridViewCell)
InheritedState

获取该单元格从它的行和列的状态继承后的当前状态。Gets the current state of the cell as inherited from the state of its row and column.

(继承自 DataGridViewCell)
InheritedStyle

获取当前应用于单元格的样式。Gets the style currently applied to the cell.

(继承自 DataGridViewCell)
IsInEditMode

获取一个值,该值指示此单元格当前是否处于编辑状态。Gets a value indicating whether this cell is currently being edited.

(继承自 DataGridViewCell)
MaxInputLength

获取或设置可以在文本框中输入的最大字符数。Gets or sets the maximum number of characters that can be entered into the text box.

OwningColumn

获取包含此单元格的列。Gets the column that contains this cell.

(继承自 DataGridViewCell)
OwningRow

获取包含此单元格的行。Gets the row that contains this cell.

(继承自 DataGridViewCell)
PreferredSize

获取适合该单元格的矩形区域的大小(以像素为单位)。Gets the size, in pixels, of a rectangular area into which the cell can fit.

(继承自 DataGridViewCell)
ReadOnly

获取或设置一个值,该值表示是否可以编辑该单元格的数据。Gets or sets a value indicating whether the cell's data can be edited.

(继承自 DataGridViewCell)
Resizable

获取一个值,该值指示是否可以调整单元格的大小。Gets a value indicating whether the cell can be resized.

(继承自 DataGridViewCell)
RowIndex

获取单元格父行的索引。Gets the index of the cell's parent row.

(继承自 DataGridViewCell)
Selected

获取或设置一个值,该值指示是否已选定该单元格。Gets or sets a value indicating whether the cell has been selected.

(继承自 DataGridViewCell)
Size

获取单元格的大小。Gets the size of the cell.

(继承自 DataGridViewCell)
State

获取元素的用户界面 (UI) 状态。Gets the user interface (UI) state of the element.

(继承自 DataGridViewElement)
Style

获取或设置单元格的样式。Gets or sets the style for the cell.

(继承自 DataGridViewCell)
Tag

获取或设置包含有关单元格补充数据的对象。Gets or sets the object that contains supplemental data about the cell.

(继承自 DataGridViewCell)
ToolTipText

获取或设置与此单元格关联的 ToolTip 文本。Gets or sets the ToolTip text associated with this cell.

(继承自 DataGridViewCell)
Value

获取或设置与此单元格关联的值。Gets or sets the value associated with this cell.

(继承自 DataGridViewCell)
ValueType

获取或设置单元格中值的数据类型。Gets or sets the data type of the values in the cell.

Visible

获取一个值,该值指示单元格是否位于已隐藏的行或列中。Gets a value indicating whether the cell is in a row or column that has been hidden.

(继承自 DataGridViewCell)

方法

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

根据指定条件修改输入单元格的边框样式。Modifies the input cell border style according to the specified criteria.

(继承自 DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)

返回一个 Rectangle,它表示所有单元格的边距宽度。Returns a Rectangle that represents the widths of all the cell margins.

(继承自 DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)

指示在单击单元格时,是否对单元格所在的行取消共享。Indicates whether the cell's row will be unshared when the cell is clicked.

(继承自 DataGridViewCell)
Clone()

创建此单元格的精确副本。Creates an exact copy of this cell.

ContentClickUnsharesRow(DataGridViewCellEventArgs)

指示在单击单元格的内容时,是否对该单元格所在的行取消共享。Indicates whether the cell's row will be unshared when the cell's content is clicked.

(继承自 DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

指示在双击单元格的内容时,是否对该单元格所在的行取消共享。Indicates whether the cell's row will be unshared when the cell's content is double-clicked.

(继承自 DataGridViewCell)
CreateAccessibilityInstance()

为此 DataGridViewTextBoxCell 实例创建新 AccessibleObjectCreates a new AccessibleObject for this DataGridViewTextBoxCell instance.

DetachEditingControl()

DataGridView 中移除单元格的编辑控件。Removes the cell's editing control from the DataGridView.

Dispose()

释放由 DataGridViewCell 使用的所有资源。Releases all resources used by the DataGridViewCell.

(继承自 DataGridViewCell)
Dispose(Boolean)

释放由 DataGridViewCell 占用的非托管资源,还可以另外再释放托管资源。Releases the unmanaged resources used by the DataGridViewCell and optionally releases the managed resources.

(继承自 DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)

指示在双击单元格时,是否对该单元格所在的行取消共享。Indicates whether the cell's row will be unshared when the cell is double-clicked.

(继承自 DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)

指示在焦点移到某单元格时,是否对相应父行取消共享。Indicates whether the parent row will be unshared when the focus moves to the cell.

(继承自 DataGridViewCell)
Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

检索要复制到 Clipboard 的单元格的已设置格式的值。Retrieves the formatted value of the cell to copy to the Clipboard.

(继承自 DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)

返回围绕单元格内容区域的边框,该区域是使用指定的 Graphics 和单元格样式计算的。Returns the bounding rectangle that encloses the cell's content area, which is calculated using the specified Graphics and cell style.

GetContentBounds(Int32)

使用默认的 Graphics 和单元格当前应用的单元格样式,返回围绕单元格内容区域的边框。Returns the bounding rectangle that encloses the cell's content area using a default Graphics and cell style currently in effect for the cell.

(继承自 DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)

返回该单元格的当前格式化值,而不考虑该单元格是否处于编辑模式,也无论是否尚未提交此值。Returns the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

(继承自 DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)

如果显示了单元格的错误图标,则返回环绕该图标的边框。Returns the bounding rectangle that encloses the cell's error icon, if one is displayed.

GetErrorText(Int32)

返回表示单元格错误的字符串。Returns a string that represents the error for the cell.

(继承自 DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)

获取为显示进行格式化的单元格的值。Gets the value of the cell as formatted for display.

(继承自 DataGridViewCell)
GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetInheritedContextMenuStrip(Int32)

获取当前单元格的继承快捷菜单。Gets the inherited shortcut menu for the current cell.

(继承自 DataGridViewCell)
GetInheritedState(Int32)

返回一个值,该值指示此单元格从它的行和列的状态继承后的当前状态。Returns a value indicating the current state of the cell as inherited from the state of its row and column.

(继承自 DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

获取应用于单元格的样式。Gets the style applied to the cell.

(继承自 DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

计算单元格的首选大小(以像素为单位)。Calculates the preferred size, in pixels, of the cell.

GetSize(Int32)

获取单元格的大小。Gets the size of the cell.

(继承自 DataGridViewCell)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
GetValue(Int32)

获取单元格的值。Gets the value of the cell.

(继承自 DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)

附加并初始化寄宿的编辑控件。Attaches and initializes the hosted editing control.

KeyDownUnsharesRow(KeyEventArgs, Int32)

指示在焦点位于单元格上,同时用户按任意键时,是否对父行取消共享。Indicates whether the parent row is unshared if the user presses a key while the focus is on the cell.

(继承自 DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)

确定是否应基于给定键启动编辑模式。Determines if edit mode should be started based on the given key.

KeyPressUnsharesRow(KeyPressEventArgs, Int32)

指示在焦点位于该行的单元格上并同时按任意键时,是否取消行的共享。Indicates whether a row will be unshared if a key is pressed while a cell in the row has focus.

(继承自 DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)

指示当焦点位于单元格上,同时用户释放某个键时,是否对父行取消共享。Indicates whether the parent row is unshared when the user releases a key while the focus is on the cell.

(继承自 DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)

指示在焦点离开某行的单元格时,是否对该行取消共享。Indicates whether a row will be unshared when the focus leaves a cell in the row.

(继承自 DataGridViewCell)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)

指示在鼠标指针位于某行的单元格上,同时用户单击鼠标按钮时,是否应对该行取消共享。Indicates whether a row will be unshared if the user clicks a mouse button while the pointer is on a cell in the row.

(继承自 DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

指示当用户双击行中的单元格时,是否将对该行取消共享。Indicates whether a row will be unshared if the user double-clicks a cell in the row.

(继承自 DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)

指示在指针位于行中某个单元格上,同时用户按住鼠标按钮时,是否对该行取消共享。Indicates whether a row will be unshared when the user holds down a mouse button while the pointer is on a cell in the row.

(继承自 DataGridViewCell)
MouseEnterUnsharesRow(Int32)

指示当鼠标指针移过行中某个单元格上时,该行是否取消共享状态。Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.

(继承自 DataGridViewCell)
MouseLeaveUnsharesRow(Int32)

指示当鼠标指针离开某行时,该行是否取消共享状态。Indicates whether a row will be unshared when the mouse pointer leaves the row.

(继承自 DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

指示当鼠标指针移过行中某个单元格上时,该行是否取消共享状态。Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.

(继承自 DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)

指示在鼠标指针位于行中某个单元格上,同时用户释放鼠标按钮时,是否对该行取消共享。Indicates whether a row will be unshared when the user releases a mouse button while the pointer is on a cell in the row.

(继承自 DataGridViewCell)
OnClick(DataGridViewCellEventArgs)

在单击单元格时进行调用。Called when the cell is clicked.

(继承自 DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)

在单击单元格的内容时进行调用。Called when the cell's contents are clicked.

(继承自 DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)

在双击单元格的内容时进行调用。Called when the cell's contents are double-clicked.

(继承自 DataGridViewCell)
OnDataGridViewChanged()

在单元格的 DataGridView 属性更改时调用。Called when the DataGridView property of the cell changes.

(继承自 DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)

在双击单元格时进行调用。Called when the cell is double-clicked.

(继承自 DataGridViewCell)
OnEnter(Int32, Boolean)

当选择光标移动到单元格时由 DataGridView 调用。Called by DataGridView when the selection cursor moves onto a cell.

OnKeyDown(KeyEventArgs, Int32)

在焦点位于单元格上并同时按下字符键时进行调用。Called when a character key is pressed while the focus is on a cell.

(继承自 DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)

在焦点位于单元格上并同时按任意键时进行调用。Called when a key is pressed while the focus is on a cell.

(继承自 DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)

在焦点位于单元格上并同时释放字符键时进行调用。Called when a character key is released while the focus is on a cell.

(继承自 DataGridViewCell)
OnLeave(Int32, Boolean)

当鼠标离开单元格时,由 DataGridView 调用。Called by the DataGridView when the mouse leaves a cell.

OnMouseClick(DataGridViewCellMouseEventArgs)

当鼠标离开单元格时,由 DataGridView 调用。Called by DataGridView when the mouse leaves a cell.

OnMouseDoubleClick(DataGridViewCellMouseEventArgs)

在指针位于单元格上,同时用户双击鼠标按钮时进行调用。Called when the user double-clicks a mouse button while the pointer is on a cell.

(继承自 DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)

在指针位于单元格上,同时用户按住鼠标按钮时进行调用。Called when the user holds down a mouse button while the pointer is on a cell.

(继承自 DataGridViewCell)
OnMouseEnter(Int32)

当鼠标指针移到单元格上时调用。Called when the mouse pointer moves over a cell.

(继承自 DataGridViewCell)
OnMouseLeave(Int32)

在鼠标指针离开单元格时调用。Called when the mouse pointer leaves the cell.

(继承自 DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)

当鼠标指针在单元格内移动时调用。Called when the mouse pointer moves within a cell.

(继承自 DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)

在指针位于单元格上,同时用户释放鼠标按钮时进行调用。Called when the user releases a mouse button while the pointer is on a cell.

(继承自 DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)

绘制当前的 DataGridViewCellPaints the current DataGridViewCell.

PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)

绘制当前 DataGridViewCell 的边框。Paints the border of the current DataGridViewCell.

(继承自 DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

绘制当前 DataGridViewCell 的错误图标。Paints the error icon of the current DataGridViewCell.

(继承自 DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

将为便于显示而进行了格式设置的值转换为实际的单元格值。Converts a value formatted for display to an actual cell value.

(继承自 DataGridViewCell)
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

设置由 DataGridView 控件中的单元格承载的编辑控件的位置和大小。Sets the location and size of the editing control hosted by a cell in the DataGridView control.

PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

设置单元格承载的编辑面板的位置和大小,并返回编辑面板内编辑控件的正常界限。Sets the location and size of the editing panel hosted by the cell, and returns the normal bounds of the editing control within the editing panel.

(继承自 DataGridViewCell)
RaiseCellClick(DataGridViewCellEventArgs)

引发 CellClick 事件。Raises the CellClick event.

(继承自 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

引发 CellContentClick 事件。Raises the CellContentClick event.

(继承自 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

引发 CellContentDoubleClick 事件。Raises the CellContentDoubleClick event.

(继承自 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

引发 CellValueChanged 事件。Raises the CellValueChanged event.

(继承自 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

引发 DataError 事件。Raises the DataError event.

(继承自 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

引发 MouseWheel 事件。Raises the MouseWheel event.

(继承自 DataGridViewElement)
SetValue(Int32, Object)

设置单元格的值。Sets the value of the cell.

(继承自 DataGridViewCell)
ToString()

返回描述当前对象的字符串。Returns a string that describes the current object.

适用于

另请参阅