DataGridTextBoxColumn Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Hostuje kontrolkę TextBox w komórce elementu do DataGridColumnStyle edycji ciągów.

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

Dziedziczenie: Object

MarshalByRefObject

Component

DataGridColumnStyle
DataGridTextBoxColumn

Przykłady

Poniższy przykład tworzy obiekt DataGridTextBoxColumn i dodaje go do GridColumnStylesCollection elementu DataGrid. Aby uruchomić ten przykład kodu, wklej go w formularzu DataGrid o nazwie dataGrid1 i wywołaj go z konstruktora .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

Uwagi

Klasa DataGridTextBoxColumn pochodzi z abstract klasy DataGridColumnStyle. W czasie wykonywania hostuje DataGridTextBoxColumn kontrolkę DataGridTextBox , która umożliwia użytkownikom edytowanie tekstu.

Właściwości specjalne dodane do klasy to Format, i HideEditBox. Te właściwości umożliwiają dostęp do hostowanej DataGridTextBox kontrolki i jej atrybutów oraz ustawienie formatu wyświetlania wartości.

Jeśli źródło danych jest obiektem zawierającym DataTable DataColumn, właściwość DataColumn elementu powinna być ustawiona na typ danych, DataType który można logicznie edytować w kontrolce pola tekstowego. Następujące typy danych są automatycznie skojarzone z elementem DataGridTextBoxColumn : Byte, , Decimal Double Int32 Int64 Int16 DateTime UInt32 UInt64 UInt16 Singlei .String

Uwaga

Następujące typy nie są w pełni obsługiwane przez program Visual Basic: DateTime, , UInt16 UInt32, UInt64i TimeSpan. (Operatory są niedozwolone).

Konstruktory

DataGridTextBoxColumn()	Inicjuje nowe wystąpienie klasy DataGridTextBoxColumn.
DataGridTextBoxColumn(PropertyDescriptor)	Inicjuje DataGridTextBoxColumn nowe wystąpienie klasy o określonej wartości PropertyDescriptor.
DataGridTextBoxColumn(PropertyDescriptor, Boolean)	Inicjuje DataGridTextBoxColumn nowe wystąpienie klasy przy użyciu określonego PropertyDescriptorelementu . Określa, czy jest DataGridTextBoxColumn to kolumna domyślna.
DataGridTextBoxColumn(PropertyDescriptor, String)	Inicjuje DataGridTextBoxColumn nowe wystąpienie klasy z określonym PropertyDescriptor i formatem.
DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)	Inicjuje DataGridTextBoxColumn nowe wystąpienie klasy o określonym formacie PropertyDescriptor i. Określa, czy kolumna jest kolumną domyślną.

Właściwości

Alignment	Pobiera lub ustawia wyrównanie tekstu w kolumnie. (Odziedziczone po DataGridColumnStyle)
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DataGridTableStyle	Pobiera element DataGridTableStyle dla kolumny. (Odziedziczone po DataGridColumnStyle)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
FontHeight	Pobiera wysokość czcionki kolumny. (Odziedziczone po DataGridColumnStyle)
Format	Pobiera lub ustawia znaki określające sposób formatowania tekstu.
FormatInfo	Pobiera lub ustawia informacje specyficzne dla kultury używane do określania sposobu formatowania wartości.
HeaderAccessibleObject	Pobiera element AccessibleObject dla kolumny. (Odziedziczone po DataGridColumnStyle)
HeaderText	Pobiera lub ustawia tekst nagłówka kolumny. (Odziedziczone po DataGridColumnStyle)
MappingName	Pobiera lub ustawia nazwę elementu członkowskiego danych, aby zamapować styl kolumny na. (Odziedziczone po DataGridColumnStyle)
NullText	Pobiera lub ustawia tekst wyświetlany, gdy kolumna zawiera `null`element . (Odziedziczone po DataGridColumnStyle)
PropertyDescriptor	Pobiera lub ustawia wartość PropertyDescriptor dla parametru DataGridTextBoxColumn.
ReadOnly	Ustawia wartość wskazującą, czy kolumna pola tekstowego jest tylko do odczytu.
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
TextBox	Pobiera hostowaną TextBox kontrolkę.
Width	Pobiera lub ustawia szerokość kolumny. (Odziedziczone po DataGridColumnStyle)

Metody

Abort(Int32)	Inicjuje żądanie przerwania procedury edycji.
BeginUpdate()	Zawiesza obraz kolumny do momentu EndUpdate() wywołania metody . (Odziedziczone po DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)	Zgłasza wyjątek, jeśli DataGrid nie ma prawidłowego źródła danych lub jeśli ta kolumna nie jest mapowana na prawidłową właściwość w źródle danych. (Odziedziczone po DataGridColumnStyle)
ColumnStartedEditing(Control)	Informuje DataGrid użytkownika o rozpoczęciu edytowania kolumny. (Odziedziczone po DataGridColumnStyle)
Commit(CurrencyManager, Int32)	Inicjuje żądanie ukończenia procedury edycji.
ConcedeFocus()	Informuje kolumnę o przyznaniu fokusu.
CreateHeaderAccessibleObject()	Pobiera element AccessibleObject dla kolumny. (Odziedziczone po DataGridColumnStyle)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)	Przygotowuje komórkę do edycji. (Odziedziczone po DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)	Przygotowuje komórkę do edycji przy użyciu określonego CurrencyManager, numeru wiersza i Rectangle parametrów. (Odziedziczone po DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)	Przygotowuje komórkę do edycji.
EndEdit()	Kończy operację edycji w obiekcie DataGridColumnStyle.
EndUpdate()	Wznawia malowanie kolumn zawieszonych przez wywołanie BeginUpdate() metody . (Odziedziczone po DataGridColumnStyle)
EnterNullValue()	Wprowadza wartość Value w kolumnie .
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetColumnValueAtRow(CurrencyManager, Int32)	Pobiera wartość w określonym wierszu z określonego CurrencyManager. (Odziedziczone po DataGridColumnStyle)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetMinimumHeight()	Pobiera wysokość komórki w obiekcie DataGridColumnStyle.
GetPreferredHeight(Graphics, Object)	Pobiera wysokość, która ma być używana do automatycznego zmieniania rozmiaru kolumn.
GetPreferredSize(Graphics, Object)	Zwraca optymalną szerokość i wysokość komórki w określonym wierszu względem określonej wartości.
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
HideEditBox()	Ukrywa kontrolkę DataGridTextBox i przenosi fokus do kontrolki DataGrid .
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
Invalidate()	Ponownie rysuje kolumnę i powoduje wysłanie komunikatu farby do kontrolki. (Odziedziczone po DataGridColumnStyle)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)	Maluje element DataGridColumnStyle o określonym Graphicsnumerze , Rectangle, CurrencyManageri wierszu.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Maluje element DataGridColumnStyle z określoną Graphicswartością , , Rectangle CurrencyManager, numerem wiersza i wyrównaniem.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)	Maluje element DataGridColumnStyle o określonym Graphicskolorze , , Rectangle CurrencyManagerwiersza, Brushi pierwszego planu.
PaintText(Graphics, Rectangle, String, Boolean)	Rysuje tekst i prostokąt w danej lokalizacji z określonym wyrównaniem.
PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)	Rysuje tekst i prostokąt w określonej lokalizacji z określonymi kolorami i wyrównaniem.
ReleaseHostedControl()	Usuwa odwołanie do DataGrid kontrolki używanej do edytowania danych.
ResetHeaderText()	Resetuje wartość domyślną HeaderText , `null`. (Odziedziczone po DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)	Ustawia wartość w określonym wierszu z wartością z określonej CurrencyManagerwartości . (Odziedziczone po DataGridColumnStyle)
SetDataGrid(DataGrid)	Ustawia kontrolkę DataGrid , do którą należy ta kolumna. (Odziedziczone po DataGridColumnStyle)
SetDataGridInColumn(DataGrid)	Dodaje kontrolkę TextBox do kontrolki DataGrid Control.ControlCollection.
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)
UpdateUI(CurrencyManager, Int32, String)	Aktualizacje interfejs użytkownika.

Zdarzenia

AlignmentChanged	Występuje, gdy Alignment wartość właściwości ulegnie zmianie. (Odziedziczone po DataGridColumnStyle)
Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
FontChanged	Występuje, gdy czcionka kolumny ulegnie zmianie. (Odziedziczone po DataGridColumnStyle)
HeaderTextChanged	Występuje, gdy HeaderText wartość właściwości ulegnie zmianie. (Odziedziczone po DataGridColumnStyle)
MappingNameChanged	Występuje, gdy MappingName wartość się zmienia. (Odziedziczone po DataGridColumnStyle)
NullTextChanged	Występuje, gdy NullText wartość się zmienia. (Odziedziczone po DataGridColumnStyle)
PropertyDescriptorChanged	Występuje, gdy PropertyDescriptor wartość właściwości ulegnie zmianie. (Odziedziczone po DataGridColumnStyle)
ReadOnlyChanged	Występuje, gdy ReadOnly wartość właściwości ulegnie zmianie. (Odziedziczone po DataGridColumnStyle)
WidthChanged	Występuje, gdy Width wartość właściwości ulegnie zmianie. (Odziedziczone po DataGridColumnStyle)

Jawne implementacje interfejsu

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

Informuje kontrolkę DataGrid , że użytkownik zaczął edytować kolumnę.

(Odziedziczone po DataGridColumnStyle)

Dotyczy