DataGridTextBoxColumn Класс

Определение

Размещает элемент управления TextBox в ячейке объекта DataGridColumnStyle для редактирования строк.Hosts a TextBox control in a cell of a DataGridColumnStyle for editing strings.

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 .The following example creates a DataGridTextBoxColumn and adds it to the GridColumnStylesCollection of a DataGrid. Чтобы выполнить этот пример кода, вставьте его в форму с DataGrid именем dataGrid1 и вызовите ее из конструктора Form .To run this code example, paste it into a form that has a DataGrid named dataGrid1 and call it from the constructor of the 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 .The DataGridTextBoxColumn class derives from the abstract class DataGridColumnStyle. Во время выполнения в DataGridTextBoxColumn размещается DataGridTextBox элемент управления, который позволяет пользователям редактировать текст.At run time, the DataGridTextBoxColumn hosts a DataGridTextBox control that allows users to edit text.

К классу добавлены специальные свойства: Format , и HideEditBox .Special properties added to the class include Format, and HideEditBox. Эти свойства позволяют получить доступ к размещенному DataGridTextBox элементу управления и его атрибутам, а также задать формат отображения значений.These properties allow you to access the hosted DataGridTextBox control and its attributes, and set the format for displaying values.

Если источник данных содержит DataTable DataColumn объекты, DataType свойство объекта DataColumn должно иметь тип данных, который может быть логически изменен в элементе управления "текстовое поле".If the data source is a DataTable containing DataColumn objects, the DataType property of the DataColumn should be set to a data type that can logically be edited in a text box control. Следующие типы данных автоматически связываются со следующими типами DataGridTextBoxColumn : Byte , DateTime ,,, Decimal Double Int16 , Int32 , Int64 , UInt16 UInt32 UInt64 Single String ,,, и.The following data types are automatically associated with a DataGridTextBoxColumn : Byte, DateTime, Decimal, Double, Int16, Int32, Int64, UInt16, UInt32, UInt64, Single, and String.

Примечание

Следующие типы не полностью поддерживаются Visual Basic: DateTime , UInt16 , UInt32 , UInt64 и TimeSpan .The following types are not fully supported by Visual Basic: DateTime, UInt16, UInt32, UInt64, and TimeSpan. (Операторы не разрешены.)(Operators are not allowed.)

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

DataGridTextBoxColumn()

Инициализирует новый экземпляр класса DataGridTextBoxColumn.Initializes a new instance of the DataGridTextBoxColumn class.

DataGridTextBoxColumn(PropertyDescriptor)

Инициализирует новый экземпляр DataGridTextBoxColumn с указанным объектом PropertyDescriptor.Initializes a new instance of a DataGridTextBoxColumn with a specified PropertyDescriptor.

DataGridTextBoxColumn(PropertyDescriptor, Boolean)

Инициализирует новый экземпляр класса DataGridTextBoxColumn с использованием указанного объекта PropertyDescriptor.Initializes a new instance of the DataGridTextBoxColumn class using the specified PropertyDescriptor. Указывает, является ли DataGridTextBoxColumn столбцом по умолчанию.Specifies whether the DataGridTextBoxColumn is a default column.

DataGridTextBoxColumn(PropertyDescriptor, String)

Инициализирует новый экземпляр класса DataGridTextBoxColumn с заданными PropertyDescriptor и форматом.Initializes a new instance of a DataGridTextBoxColumn with the specified PropertyDescriptor and format.

DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)

Инициализирует новый экземпляр класса DataGridTextBoxColumn с заданными PropertyDescriptor и форматом.Initializes a new instance of the DataGridTextBoxColumn class with a specified PropertyDescriptor and format. Указывает, является ли данный столбец столбцом по умолчанию.Specifies whether the column is the default column.

Свойства

Alignment

Получает или задает выравнивание текста в столбце.Gets or sets the alignment of text in a column.

(Унаследовано от DataGridColumnStyle)
CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
Container

Возвращает объект IContainer, который содержит коллекцию Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
DataGridTableStyle

Получает объект DataGridTableStyle для столбца.Gets the DataGridTableStyle for the column.

(Унаследовано от DataGridColumnStyle)
DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
FontHeight

Получает высоту шрифта столбца.Gets the height of the column's font.

(Унаследовано от DataGridColumnStyle)
Format

Получает или задает знаки, задающие форматирование текста.Gets or sets the character(s) that specify how text is formatted.

FormatInfo

Получает или задает сведения о языке и региональных параметрах, используемые для определения форматирования значений.Gets or sets the culture specific information used to determine how values are formatted.

HeaderAccessibleObject

Получает объект AccessibleObject для столбца.Gets the AccessibleObject for the column.

(Унаследовано от DataGridColumnStyle)
HeaderText

Получает или задает текст заголовка столбца.Gets or sets the text of the column header.

(Унаследовано от DataGridColumnStyle)
MappingName

Получает или задает имя элемента данных, на который отображается стиль столбца.Gets or sets the name of the data member to map the column style to.

(Унаследовано от DataGridColumnStyle)
NullText

Получает или задает текст, который отображается, если столбец имеет значение null.Gets or sets the text that is displayed when the column contains null.

(Унаследовано от DataGridColumnStyle)
PropertyDescriptor

Возвращает или задает PropertyDescriptor для объекта DataGridTextBoxColumn.Gets or sets the PropertyDescriptor for the DataGridTextBoxColumn.

ReadOnly

Задает значение, указывающее, является ли столбец с текстовыми полями доступным только для чтения.Sets a value indicating whether the text box column is read-only.

Site

Получает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Унаследовано от Component)
TextBox

Получает размещаемый элемент управления TextBox.Gets the hosted TextBox control.

Width

Получает или задает ширину столбца.Gets or sets the width of the column.

(Унаследовано от DataGridColumnStyle)

Методы

Abort(Int32)

Инициирует запрос на прерывание процедуры редактирования.Initiates a request to interrupt an edit procedure.

BeginUpdate()

Приостанавливает заливку столбца до тех пор, пока не будет вызван метод EndUpdate().Suspends the painting of the column until the EndUpdate() method is called.

(Унаследовано от DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)

Вызывает исключение, если объект DataGrid не имеет допустимого источника данных, либо если этот столбец не сопоставлен с допустимым свойством в источнике данных.Throws an exception if the DataGrid does not have a valid data source, or if this column is not mapped to a valid property in the data source.

(Унаследовано от DataGridColumnStyle)
ColumnStartedEditing(Control)

Информирует объект DataGrid о том, что пользователь начал редактирование столбца.Informs the DataGrid that the user has begun editing the column.

(Унаследовано от DataGridColumnStyle)
Commit(CurrencyManager, Int32)

Инициирует запрос на завершение процедуры редактирования.Initiates a request to complete an editing procedure.

ConcedeFocus()

Информирует столбец о передаче фокуса. Informs the column that the focus is being conceded.

CreateHeaderAccessibleObject()

Получает объект AccessibleObject для столбца.Gets the AccessibleObject for the column.

(Унаследовано от DataGridColumnStyle)
CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Унаследовано от Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)

Подготавливает ячейку к редактированию.Prepares a cell for editing.

(Унаследовано от DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)

Подготавливает ячейку к редактированию с помощью указанного объекта CurrencyManager, номера строки и параметров Rectangle.Prepares the cell for editing using the specified CurrencyManager, row number, and Rectangle parameters.

(Унаследовано от DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)

Подготавливает ячейку к редактированию.Prepares a cell for editing.

EndEdit()

Заканчивает операцию изменения для DataGridColumnStyle.Ends an edit operation on the DataGridColumnStyle.

EndUpdate()

Возобновляет заливку столбца, приостановленную вызовом метода BeginUpdate().Resumes the painting of columns suspended by calling the BeginUpdate() method.

(Унаследовано от DataGridColumnStyle)
EnterNullValue()

Вводит Value в столбец.Enters a Value in the column.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetColumnValueAtRow(CurrencyManager, Int32)

Получает значение в указанной строке из указанного объекта CurrencyManager.Gets the value in the specified row from the specified CurrencyManager.

(Унаследовано от DataGridColumnStyle)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()
Является устаревшей.

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetMinimumHeight()

Получает высоту ячейки в DataGridColumnStyle.Gets the height of a cell in a DataGridColumnStyle.

GetPreferredHeight(Graphics, Object)

Получает высоту, которая должна использоваться для автоматического изменения размера столбцов.Gets the height to be used in for automatically resizing columns.

GetPreferredSize(Graphics, Object)

Возвращает оптимальные ширину и высоту ячейки в указанном столбце по отношению к заданному значению.Returns the optimum width and height of the cell in a specified row relative to the specified value.

GetService(Type)

Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
HideEditBox()

Скрывает элемент управления DataGridTextBox и переносит фокус на элемент управления DataGrid.Hides the DataGridTextBox control and moves the focus to the DataGrid control.

InitializeLifetimeService()
Является устаревшей.

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
Invalidate()

Перерисовывает столбец и вызывает отправку в элемент управления сообщения о заливке.Redraws the column and causes a paint message to be sent to the control.

(Унаследовано от DataGridColumnStyle)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)

Закрашивает объект DataGridColumnStyle с указанными объектами Graphics, Rectangle, CurrencyManager и номером строки.Paints the a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, and row number.

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

Закрашивает объект DataGridColumnStyle с указанными Graphics, Rectangle, CurrencyManager, номером строки и выравниванием.Paints a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, row number, and alignment.

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

Закрашивает объект DataGridColumnStyle с указанными Graphics, Rectangle, CurrencyManager, номером строки, Brush и основным цветом.Paints a DataGridColumnStyle with the specified Graphics, Rectangle, CurrencyManager, row number, Brush, and foreground color.

PaintText(Graphics, Rectangle, String, Boolean)

Рисует текст и прямоугольник в заданном месте с указанным выравниванием.Draws the text and rectangle at the given location with the specified alignment.

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

Рисует текст и прямоугольник в заданном месте с указанными цветами и выравниванием.Draws the text and rectangle at the specified location with the specified colors and alignment.

ReleaseHostedControl()

Удаляет содержащуюся в DataGrid ссылку на элемент управления, используемый для редактирования данных.Removes the reference that the DataGrid holds to the control used to edit data.

ResetHeaderText()

Сбрасывает свойство HeaderText, устанавливая для него значение по умолчанию, равное null.Resets the HeaderText to its default value, null.

(Унаследовано от DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)

Задает значение в указанной строке равным значению из указанного объекта CurrencyManager.Sets the value in a specified row with the value from a specified CurrencyManager.

(Унаследовано от DataGridColumnStyle)
SetDataGrid(DataGrid)

Задает элемент управления DataGrid, содержащий данный столбец.Sets the DataGrid control that this column belongs to.

(Унаследовано от DataGridColumnStyle)
SetDataGridInColumn(DataGrid)

Добавляет элемент управления TextBox к коллекции DataGrid элемента управления Control.ControlCollection.Adds a TextBox control to the DataGrid control's Control.ControlCollection.

ToString()

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Унаследовано от Component)
UpdateUI(CurrencyManager, Int32, String)

Обновляет пользовательский интерфейс.Updates the user interface.

События

AlignmentChanged

Происходит при изменении значения свойства Alignment.Occurs when the Alignment property value changes.

(Унаследовано от DataGridColumnStyle)
Disposed

Возникает при удалении компонента путем вызова метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)
FontChanged

Происходит при изменении шрифта столбца.Occurs when the column's font changes.

(Унаследовано от DataGridColumnStyle)
HeaderTextChanged

Происходит при изменении значения свойства HeaderText.Occurs when the HeaderText property value changes.

(Унаследовано от DataGridColumnStyle)
MappingNameChanged

Происходит при изменении значения свойства MappingName.Occurs when the MappingName value changes.

(Унаследовано от DataGridColumnStyle)
NullTextChanged

Происходит при изменении значения свойства NullText.Occurs when the NullText value changes.

(Унаследовано от DataGridColumnStyle)
PropertyDescriptorChanged

Происходит при изменении значения свойства PropertyDescriptor.Occurs when the PropertyDescriptor property value changes.

(Унаследовано от DataGridColumnStyle)
ReadOnlyChanged

Происходит при изменении значения свойства ReadOnly.Occurs when the ReadOnly property value changes.

(Унаследовано от DataGridColumnStyle)
WidthChanged

Происходит при изменении значения свойства Width.Occurs when the Width property value changes.

(Унаследовано от DataGridColumnStyle)

Явные реализации интерфейса

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

Информирует элемент управления DataGrid о том, что пользователь начал редактирование столбца.Informs the DataGrid control that the user has begun editing the column.

(Унаследовано от DataGridColumnStyle)

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

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