DataGridTextBoxColumn Класс

Ссылка

Определение

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

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

Важно!

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

Размещает элемент управления 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

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

MarshalByRefObject

Component

DataGridColumnStyle
DataGridTextBoxColumn

Примеры

В следующем примере создается 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. Во время выполнения размещает DataGridTextBoxColumn элемент DataGridTextBox управления, который позволяет пользователям изменять текст.

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

Если источником данных является DataTable объект , содержащий DataColumn объекты, свойство DataType DataColumn должно иметь тип данных, который можно логически редактировать в элементе управления "Текстовое поле". Следующие типы данных автоматически связываются с DataGridTextBoxColumn : Byte, DateTime, Decimal, Double, Int16, Int32, Int64, , UInt16, UInt32, UInt64, Singleи String.

Примечание

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

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

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

Свойства

Alignment	Получает или задает выравнивание текста в столбце. (Унаследовано от DataGridColumnStyle)
CanRaiseEvents	Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component)
Container	Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от 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	Возвращает или задает PropertyDescriptor для объекта DataGridTextBoxColumn.
ReadOnly	Задает значение, указывающее, является ли столбец с текстовыми полями доступным только для чтения.
Site	Получает или задает ISite объекта Component. (Унаследовано от 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)	Закрашивает объект DataGridColumnStyle с указанными объектами Graphics, Rectangle, CurrencyManager и номером строки.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Закрашивает объект DataGridColumnStyle с указанными Graphics, Rectangle, CurrencyManager, номером строки и выравниванием.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)	Закрашивает объект DataGridColumnStyle с указанными Graphics, Rectangle, 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()	Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от 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)

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

Бөлісу құралы: