DataGridTextBoxColumn 类

定义

TextBox 的单元格中承载 DataGridColumnStyle 控件以便编辑字符串。

public ref class DataGridTextBoxColumn : System::Windows::Forms::DataGridColumnStyle
public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle
type DataGridTextBoxColumn = class
    inherit DataGridColumnStyle
Public Class DataGridTextBoxColumn
Inherits DataGridColumnStyle
继承

示例

以下示例创建 ,DataGridTextBoxColumn并将其添加到 的 。GridColumnStylesCollectionDataGrid 若要运行此代码示例,请将其粘贴到具有 DataGrid 命名 dataGrid1 的窗体中,并从 的 Form构造函数调用它。

private:
   void AddColumn()
   {
      DataTable^ myTable = gcnew DataTable;
      
      // Add a new DataColumn to the DataTable.
      DataColumn^ myColumn = gcnew DataColumn( "myTextBoxColumn" );
      myColumn->DataType = System::Type::GetType( "System::String" );
      myColumn->DefaultValue = "default string";
      myTable->Columns->Add( myColumn );
      
      // Get the CurrencyManager for the DataTable.
      CurrencyManager^ cm = dynamic_cast<CurrencyManager^>(this->BindingContext[ myTable ]);
      
      // Use the CurrencyManager to get the PropertyDescriptor for the new column.
      System::ComponentModel::PropertyDescriptor^ pd = cm->GetItemProperties()[ "myTextBoxColumn" ];
      DataGridTextBoxColumn^ myColumnTextColumn;
      
      // Create the DataGridTextBoxColumn with the PropertyDescriptor.
      myColumnTextColumn = gcnew DataGridTextBoxColumn( pd );
      
      // Add the new DataGridColumn to the GridColumnsCollection.
      dataGrid1->DataSource = myTable;
      dataGrid1->TableStyles->Add( gcnew DataGridTableStyle );
      dataGrid1->TableStyles[ 0 ]->GridColumnStyles->Add( myColumnTextColumn );
   }
private void AddColumn()
{
     DataTable myTable= new DataTable();
 
     // Add a new DataColumn to the DataTable.
     DataColumn myColumn = new DataColumn("myTextBoxColumn");
     myColumn.DataType = System.Type.GetType("System.String");
     myColumn.DefaultValue="default string";
     myTable.Columns.Add(myColumn);
     // Get the CurrencyManager for the DataTable.
     CurrencyManager cm = (CurrencyManager)this.BindingContext[myTable];
     // Use the CurrencyManager to get the PropertyDescriptor for the new column.
     PropertyDescriptor pd = cm.GetItemProperties()["myTextBoxColumn"];
     DataGridTextBoxColumn myColumnTextColumn;
     // Create the DataGridTextBoxColumn with the PropertyDescriptor.
     myColumnTextColumn = new DataGridTextBoxColumn(pd);
     // Add the new DataGridColumn to the GridColumnsCollection.
     dataGrid1.DataSource= myTable;
     dataGrid1.TableStyles.Add(new DataGridTableStyle());
     dataGrid1.TableStyles[0].GridColumnStyles.Add(myColumnTextColumn);
 }
Private Sub AddColumn()
    Dim myTable As New DataTable()
    
    ' Add a new DataColumn to the DataTable.
    Dim myColumn As New DataColumn("myTextBoxColumn")
    myColumn.DataType = System.Type.GetType("System.String")
    myColumn.DefaultValue = "default string"
    myTable.Columns.Add(myColumn)
    ' Get the CurrencyManager for the DataTable.
    Dim cm As CurrencyManager = CType(Me.BindingContext(myTable), CurrencyManager)
    ' Use the CurrencyManager to get the PropertyDescriptor for the new column.
    Dim pd As PropertyDescriptor = cm.GetItemProperties()("myTextBoxColumn")
    Dim myColumnTextColumn As DataGridTextBoxColumn
    ' Create the DataGridTextBoxColumn with the PropertyDescriptor.
    myColumnTextColumn = New DataGridTextBoxColumn(pd)
    ' Add the new DataGridColumn to the GridColumnsCollection.
    dataGrid1.DataSource = myTable
    dataGrid1.TableStyles.Add(New DataGridTableStyle())
    dataGrid1.TableStyles(0).GridColumnStyles.Add(myColumnTextColumn)
End Sub

注解

DataGridTextBoxColumn 派生自 abstractDataGridColumnStyle。 在运行时, 承载 DataGridTextBoxColumn 一个 DataGridTextBox 允许用户编辑文本的控件。

添加到 类的特殊属性包括 Format、 和 HideEditBox。 这些属性允许访问托管 DataGridTextBox 控件及其属性,并设置显示值的格式。

如果数据源是包含DataTableDataColumn的对象,DataType应将 的 DataColumn 属性设置为可在文本框控件中以逻辑方式编辑的数据类型。 以下数据类型自动与 DataGridTextBoxColumnByte、、DateTimeDecimalDoubleInt16Int32、、Int64UInt16UInt64UInt32Single、 和 String关联。

注意

Visual Basic 不完全支持以下类型: DateTimeUInt16UInt32UInt64TimeSpan。 不允许 (运算符。)

构造函数

DataGridTextBoxColumn()

初始化 DataGridTextBoxColumn 类的新实例。

DataGridTextBoxColumn(PropertyDescriptor)

使用指定的 PropertyDescriptor初始化 类的新实例DataGridTextBoxColumn

DataGridTextBoxColumn(PropertyDescriptor, Boolean)

使用指定的 DataGridTextBoxColumn 初始化 PropertyDescriptor 类的新实例。 指定 DataGridTextBoxColumn 是否为默认列。

DataGridTextBoxColumn(PropertyDescriptor, String)

使用指定的 PropertyDescriptor 和 格式初始化 类的新实例DataGridTextBoxColumn

DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)

使用指定的 DataGridTextBoxColumn 和格式初始化 PropertyDescriptor 类的新实例。 指定此列是否为默认列。

属性

Alignment

获取或设置列中文本的对齐方式。

(继承自 DataGridColumnStyle)
CanRaiseEvents

获取一个指示组件是否可以引发事件的值。

(继承自 Component)
Container

获取包含 IContainerComponent

(继承自 Component)
DataGridTableStyle

获取列的 DataGridTableStyle

(继承自 DataGridColumnStyle)
DesignMode

获取一个值,用以指示 Component 当前是否处于设计模式。

(继承自 Component)
Events

获取附加到此 Component 的事件处理程序的列表。

(继承自 Component)
FontHeight

获取该列字体的高度。

(继承自 DataGridColumnStyle)
Format

获取或设置指定格式化文本的方法的一个或多个字符。

FormatInfo

获取或设置用于确定格式化值的方法的特定区域性信息。

HeaderAccessibleObject

获取列的 AccessibleObject

(继承自 DataGridColumnStyle)
HeaderText

获取或设置列标题的文本。

(继承自 DataGridColumnStyle)
MappingName

获取或设置列样式所映射到的数据成员的名称。

(继承自 DataGridColumnStyle)
NullText

获取或设置在列包含 null 时所显示的文本。

(继承自 DataGridColumnStyle)
PropertyDescriptor

获取或设置 PropertyDescriptorDataGridTextBoxColumn

ReadOnly

设置一个值,该值指示文本框列是否为只读。

Site

获取或设置 ComponentISite

(继承自 Component)
TextBox

获取寄宿的 TextBox 控件。

Width

获取或设置列的宽度。

(继承自 DataGridColumnStyle)

方法

Abort(Int32)

发出请求以中断一个编辑过程。

BeginUpdate()

一直挂起列的绘制,直到调用 EndUpdate() 方法为止。

(继承自 DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)

如果 DataGrid 没有有效数据源,或该列未映射到数据源中的有效属性,将引发异常。

(继承自 DataGridColumnStyle)
ColumnStartedEditing(Control)

通知 DataGrid 用户已开始编辑该列。

(继承自 DataGridColumnStyle)
Commit(CurrencyManager, Int32)

初始化一个请求以完成一个编辑过程。

ConcedeFocus()

通知此列焦点正被让出。

CreateHeaderAccessibleObject()

获取列的 AccessibleObject

(继承自 DataGridColumnStyle)
CreateObjRef(Type)

创建一个对象,该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。

(继承自 MarshalByRefObject)
Dispose()

释放由 Component 使用的所有资源。

(继承自 Component)
Dispose(Boolean)

释放由 Component 占用的非托管资源,还可以另外再释放托管资源。

(继承自 Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)

准备单元格以便进行编辑。

(继承自 DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)

使用指定的 CurrencyManager、行号和 Rectangle 参数准备单元格以便进行编辑。

(继承自 DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)

准备单元格以便进行编辑。

EndEdit()

结束对 DataGridColumnStyle 的编辑操作。

EndUpdate()

继续绘制由调用 BeginUpdate() 方法而挂起的列。

(继承自 DataGridColumnStyle)
EnterNullValue()

向列中输入 Value

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
GetColumnValueAtRow(CurrencyManager, Int32)

获取指定 CurrencyManager 中指定行内的值。

(继承自 DataGridColumnStyle)
GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetLifetimeService()
已过时.

检索控制此实例的生存期策略的当前生存期服务对象。

(继承自 MarshalByRefObject)
GetMinimumHeight()

DataGridColumnStyle 中获取单元格的高度。

GetPreferredHeight(Graphics, Object)

获取要用于自动调整大小的列的高度。

GetPreferredSize(Graphics, Object)

返回相对于指定值的单元格在指定行中的最佳宽度和高度。

GetService(Type)

返回一个对象,该对象表示由 Component 或它的 Container 提供的服务。

(继承自 Component)
GetType()

获取当前实例的 Type

(继承自 Object)
HideEditBox()

隐藏 DataGridTextBox 控件并将焦点移动到 DataGrid 控件。

InitializeLifetimeService()
已过时.

获取生存期服务对象来控制此实例的生存期策略。

(继承自 MarshalByRefObject)
Invalidate()

重新绘制列,并会向控件发送一条绘制消息。

(继承自 DataGridColumnStyle)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
MemberwiseClone(Boolean)

创建当前 MarshalByRefObject 对象的浅表副本。

(继承自 MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)

绘制具有指定 DataGridColumnStyleGraphicsRectangle 和行号的 CurrencyManager

Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)

绘制具有指定 DataGridColumnStyleGraphicsRectangle、行号和对齐方式的 CurrencyManager

Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)

绘制具有指定 DataGridColumnStyleGraphicsRectangle、行号、CurrencyManager 和前景色的 Brush

PaintText(Graphics, Rectangle, String, Boolean)

在给定位置处依据指定的对齐方式绘制文本和边框。

PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)

在指定位置用指定的颜色和对齐方式绘制文本和边框。

ReleaseHostedControl()

移除 DataGrid 保持的、对用于编辑数据的控件的引用。

ResetHeaderText()

HeaderText 重置为其默认值 null

(继承自 DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)

用来自指定 CurrencyManager 的值设置指定行中的值。

(继承自 DataGridColumnStyle)
SetDataGrid(DataGrid)

设置该列所属的 DataGrid 控件。

(继承自 DataGridColumnStyle)
SetDataGridInColumn(DataGrid)

TextBox 控件的 DataGrid 中添加一个 Control.ControlCollection 控件。

ToString()

返回包含 Component 的名称的 String(如果有)。 不应重写此方法。

(继承自 Component)
UpdateUI(CurrencyManager, Int32, String)

更新用户界面。

事件

AlignmentChanged

Alignment 属性值更改时发生。

(继承自 DataGridColumnStyle)
Disposed

在通过调用 Dispose() 方法释放组件时发生。

(继承自 Component)
FontChanged

当列的字体更改时发生。

(继承自 DataGridColumnStyle)
HeaderTextChanged

HeaderText 属性值更改时发生。

(继承自 DataGridColumnStyle)
MappingNameChanged

MappingName 值更改时发生。

(继承自 DataGridColumnStyle)
NullTextChanged

NullText 值更改时发生。

(继承自 DataGridColumnStyle)
PropertyDescriptorChanged

PropertyDescriptor 属性值更改时发生。

(继承自 DataGridColumnStyle)
ReadOnlyChanged

ReadOnly 属性值更改时发生。

(继承自 DataGridColumnStyle)
WidthChanged

Width 属性值更改时发生。

(继承自 DataGridColumnStyle)

显式接口实现

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

通知 DataGrid 控件用户已开始编辑该列。

(继承自 DataGridColumnStyle)

适用于

另请参阅