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 и добавляется в 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 объекты, свойство DataTypeDataColumn должно иметь тип данных, который можно логически редактировать в элементе управления "Текстовое поле". Следующие типы данных автоматически связываются с 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)

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

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