DataGridTextBoxColumn Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridTextBoxColumn.cs

Внимание

DataGrid is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use DataGridView instead.

TextBox Размещает элемент управления в ячейке строки DataGridColumnStyle редактирования.

public ref class DataGridTextBoxColumn : System::Windows::Forms::DataGridColumnStyle

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type DataGridTextBoxColumn = class
    inherit DataGridColumnStyle

Public Class DataGridTextBoxColumn
Inherits DataGridColumnStyle

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

Object

MarshalByRefObject

Component

DataGridColumnStyle

DataGridTextBoxColumn

Атрибуты

BrowsableAttribute ObsoleteAttribute

Примеры

В следующем примере создается и DataGridTextBoxColumn добавляется в GridColumnStylesCollection объект DataGrid. Чтобы запустить этот пример кода, вставьте его в форму с 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 является производным abstract от класса DataGridColumnStyle. Во время выполнения хост-элемент DataGridTextBoxColumnDataGridTextBox управления, позволяющий пользователям изменять текст.

Специальные свойства, добавленные в класс, включают Formatи HideEditBox. Эти свойства позволяют получить доступ к размещенного DataGridTextBox элемента управления и его атрибутам и задать формат для отображения значений.

Если источник данных является DataTable содержащими DataColumn объектами, DataType свойство объекта DataColumn должно быть задано в тип данных, который можно логически изменить в элементе управления текстового поля. Следующие типы данных автоматически связываются с DataGridTextBoxColumn : Byte, DecimalInt16Int32Int64DoubleDateTimeUInt32UInt64UInt16Singleи .String

Замечание

Следующие типы не полностью поддерживаются Visual Basic: DateTime, UInt16, UInt32, UInt64и TimeSpan. (Операторы не допускаются.)

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

Имя	Описание
DataGridTextBoxColumn()	Устаревшие.. Инициализирует новый экземпляр класса DataGridTextBoxColumn.
DataGridTextBoxColumn(PropertyDescriptor, Boolean)	Устаревшие.. Инициализирует новый экземпляр класса с помощью указанного DataGridTextBoxColumnPropertyDescriptor. Указывает, является ли DataGridTextBoxColumn столбец по умолчанию.
DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)	Устаревшие.. Инициализирует новый экземпляр DataGridTextBoxColumn класса с указанным PropertyDescriptor и форматом. Указывает, является ли столбец столбцом по умолчанию.
DataGridTextBoxColumn(PropertyDescriptor, String)	Устаревшие.. Инициализирует новый экземпляр DataGridTextBoxColumn класса с указанным PropertyDescriptor и форматом.
DataGridTextBoxColumn(PropertyDescriptor)	Устаревшие.. Инициализирует новый экземпляр DataGridTextBoxColumn класса с указанным PropertyDescriptor.

Свойства

Имя	Описание
Alignment	Устаревшие.. Возвращает или задает выравнивание текста в столбце. (Унаследовано от DataGridColumnStyle)
DataGridTableStyle	Устаревшие.. DataGridTableStyle Возвращает столбец. (Унаследовано от DataGridColumnStyle)
FontHeight	Устаревшие.. Возвращает высоту шрифта столбца. (Унаследовано от DataGridColumnStyle)
Format	Устаревшие.. Возвращает или задает символы, определяющие форматирование текста.
FormatInfo	Устаревшие.. Возвращает или задает сведения о языке и региональных параметрах, используемые для определения форматирования значений.
HeaderAccessibleObject	Устаревшие.. AccessibleObject Возвращает столбец. (Унаследовано от DataGridColumnStyle)
HeaderText	Устаревшие.. Возвращает или задает текст заголовка столбца. (Унаследовано от DataGridColumnStyle)
MappingName	Устаревшие.. Возвращает или задает имя элемента данных для сопоставления стиля столбца. (Унаследовано от DataGridColumnStyle)
NullText	Устаревшие.. Возвращает или задает текст, отображаемый при добавлении столбца null. (Унаследовано от DataGridColumnStyle)
PropertyDescriptor	Устаревшие.. Возвращает или задает PropertyDescriptor значение для DataGridTextBoxColumnпараметра .
ReadOnly	Устаревшие.. Возвращает или задает значение, указывающее, можно ли изменять данные в столбце. (Унаследовано от DataGridColumnStyle)
TextBox	Устаревшие.. Возвращает размещенный TextBox элемент управления.
Width	Устаревшие.. Возвращает или задает ширину столбца. (Унаследовано от DataGridColumnStyle)

Методы

Имя	Описание
Abort(Int32)	Устаревшие.. Инициирует запрос на прерывание процедуры редактирования.
BeginUpdate()	Устаревшие.. Приостанавливает рисование столбца до вызова EndUpdate() метода. (Унаследовано от DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)	Устаревшие.. Создает исключение, если DataGrid у него нет допустимого источника данных или если этот столбец не сопоставлен с допустимым свойством в источнике данных. (Унаследовано от DataGridColumnStyle)
ColumnStartedEditing(Control)	Устаревшие.. DataGrid Сообщает пользователю, что пользователь начал редактировать столбец. (Унаследовано от DataGridColumnStyle)
Commit(CurrencyManager, Int32)	Устаревшие.. Инициирует запрос на завершение процедуры редактирования.
ConcedeFocus()	Устаревшие.. Уведомляет столбец о том, что он должен отклинить фокус на элемент управления, на котором он размещен. (Унаследовано от DataGridColumnStyle)
CreateHeaderAccessibleObject()	Устаревшие.. AccessibleObject Возвращает столбец. (Унаследовано от DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)	Устаревшие.. Подготавливает ячейку для редактирования.
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)	Устаревшие.. Подготавливает ячейку для редактирования с помощью указанного CurrencyManagerномера строки и Rectangle параметров. (Унаследовано от DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean)	Устаревшие.. Подготавливает ячейку для редактирования. (Унаследовано от DataGridColumnStyle)
EndEdit()	Устаревшие.. Завершает операцию редактирования в объекте DataGridColumnStyle.
EndUpdate()	Устаревшие.. Возобновляет рисование столбцов, приостановленных путем вызова BeginUpdate() метода. (Унаследовано от DataGridColumnStyle)
EnterNullValue()	Устаревшие.. Вводится Value в столбец. (Унаследовано от DataGridColumnStyle)
GetColumnValueAtRow(CurrencyManager, Int32)	Устаревшие.. Возвращает значение в указанной строке из указанной CurrencyManagerстроки. (Унаследовано от DataGridColumnStyle)
GetMinimumHeight()	Устаревшие.. Возвращает высоту ячейки в объекте DataGridColumnStyle.
GetPreferredHeight(Graphics, Object)	Устаревшие.. Возвращает высоту, используемую для автоматического изменения размера столбцов.
GetPreferredSize(Graphics, Object)	Устаревшие.. Возвращает оптимальную ширину и высоту ячейки в указанной строке относительно указанного значения.
HideEditBox()	Устаревшие.. Скрывает элемент управления и перемещает DataGridTextBox фокус на DataGrid элемент управления.
Invalidate()	Устаревшие.. Перерисовывает столбец и приводит к отправке в элемент управления сообщения с краской. (Унаследовано от DataGridColumnStyle)
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Устаревшие.. Закрашивает заданный DataGridColumnStyleGraphics, RectangleCurrencyManagerномер строки и выравнивание.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)	Устаревшие.. Рисует указанный DataGridColumnStyleGraphicsRectangleCurrencyManager, номер строки, цвет фона, цвет переднего плана и выравнивание. (Унаследовано от DataGridColumnStyle)
Paint(Graphics, Rectangle, CurrencyManager, Int32)	Устаревшие.. Закрашивает DataGridColumnStyle заданный Graphics, RectangleCurrencyManagerи номер строки.
PaintText(Graphics, Rectangle, String, Boolean)	Устаревшие.. Рисует текст и прямоугольник в заданном расположении с указанным выравниванием.
PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)	Устаревшие.. Рисует текст и прямоугольник в указанном расположении с указанными цветами и выравниванием.
ReleaseHostedControl()	Устаревшие.. Позволяет столбцу освободить ресурсы, если элемент управления, на котором он размещается, не требуется. (Унаследовано от DataGridColumnStyle)
ResetHeaderText()	Устаревшие.. Сбрасывает HeaderText значение nullпо умолчанию. (Унаследовано от DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)	Устаревшие.. Задает значение в указанной строке со значением из указанного CurrencyManager. (Унаследовано от DataGridColumnStyle)
SetDataGrid(DataGrid)	Устаревшие.. Задает элемент DataGrid управления, к которому принадлежит этот столбец. (Унаследовано от DataGridColumnStyle)
SetDataGridInColumn(DataGrid)	Устаревшие.. DataGrid Задает для столбца. (Унаследовано от DataGridColumnStyle)
UpdateUI(CurrencyManager, Int32, String)	Устаревшие.. Обновляет значение указанной строки с заданным текстом. (Унаследовано от DataGridColumnStyle)

События

Имя	Описание
AlignmentChanged	Устаревшие.. Происходит при Alignment изменении значения свойства. (Унаследовано от DataGridColumnStyle)
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)

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

• DataGridBoolColumn
• DataGridColumnStyle
• DataColumn
• DataType
• DataGrid
• DataGridTextBox
• TextBox