DataGridTextBoxColumn Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fungiert als Host für ein TextBox-Steuerelement zum Bearbeiten von Zeichenfolgen in einer Zelle eines 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

Vererbung: Object

MarshalByRefObject

Component

DataGridColumnStyle
DataGridTextBoxColumn

Beispiele

Im folgenden Beispiel wird ein DataGridTextBoxColumn erstellt und dem GridColumnStylesCollection eines DataGridhinzugefügt. Um dieses Codebeispiel auszuführen, fügen Sie es in ein Formular mit einem DataGrid namen dataGrid1 ein, und rufen Sie es vom Konstruktor des Formauf.

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

Hinweise

Die DataGridTextBoxColumn -Klasse leitet sich von der abstract -Klasse DataGridColumnStyleab. Zur Laufzeit hostet das DataGridTextBoxColumn -Steuerelement ein DataGridTextBox Steuerelement, mit dem Benutzer Text bearbeiten können.

Zu den besonderen Eigenschaften, die der -Klasse hinzugefügt werden, gehören Format, und HideEditBox. Mit diesen Eigenschaften können Sie auf das gehostete DataGridTextBox Steuerelement und seine Attribute zugreifen und das Format für die Anzeige von Werten festlegen.

Wenn es sich bei der Datenquelle um ein DataTable enthaltenes DataColumn Objekt handelt, sollte die DataType -Eigenschaft von DataColumn auf einen Datentyp festgelegt werden, der logisch in einem Textfeld-Steuerelement bearbeitet werden kann. Die folgenden Datentypen werden automatisch einem zugeordnet: , , DateTime, Decimal, Double Int16, Int32, Int64 UInt16, , UInt32, UInt64, , , und String Single. Byte DataGridTextBoxColumn

Hinweis

Die folgenden Typen werden von Visual Basic nicht vollständig unterstützt: DateTime, , UInt32 UInt16, UInt64und TimeSpan. (Operatoren sind nicht zulässig.)

Konstruktoren

DataGridTextBoxColumn()	Initialisiert eine neue Instanz der DataGridTextBoxColumn-Klasse.
DataGridTextBoxColumn(PropertyDescriptor)	Initialisiert einen neuen instance der DataGridTextBoxColumn -Klasse mit einem angegebenen PropertyDescriptor.
DataGridTextBoxColumn(PropertyDescriptor, Boolean)	Initialisiert eine neue Instanz der DataGridTextBoxColumn-Klasse mit dem angegebenen PropertyDescriptor. Gibt an, ob es sich bei der DataGridTextBoxColumn um eine Standardspalte handelt.
DataGridTextBoxColumn(PropertyDescriptor, String)	Initialisiert einen neuen instance der DataGridTextBoxColumn -Klasse mit dem angegebenen Format und dem angegebenen PropertyDescriptor Format.
DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)	Initialisiert eine neue Instanz der DataGridTextBoxColumn-Klasse mit einem angegebenen PropertyDescriptor und Format. Gibt an, ob die Spalte die Standardspalte ist.

Eigenschaften

Alignment	Ruft die Textausrichtung in einer Spalte ab oder legt diese fest. (Geerbt von DataGridColumnStyle)
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
DataGridTableStyle	Ruft das DataGridTableStyle für die Spalte ab. (Geerbt von DataGridColumnStyle)
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
FontHeight	Ruft die Höhe der in der Spalte verwendeten Schriftart ab. (Geerbt von DataGridColumnStyle)
Format	Ruft das bzw. die Zeichen ab, die angeben, wie Text formatiert wird, oder legt diese fest.
FormatInfo	Ruft die kulturabhängigen Informationen ab, mit denen die Formatierung von Werten bestimmt wird, oder legt diese fest.
HeaderAccessibleObject	Ruft das AccessibleObject für die Spalte ab. (Geerbt von DataGridColumnStyle)
HeaderText	Ruft den Text des Spaltenkopfs ab oder legt diesen fest. (Geerbt von DataGridColumnStyle)
MappingName	Ruft den Namen des Datenmembers fest, dem das Spaltenformat zugeordnet werden soll, oder legt diesen fest. (Geerbt von DataGridColumnStyle)
NullText	Ruft den Text ab, der angezeigt wird, wenn die Spalte `null` enthält, oder legt diesen fest. (Geerbt von DataGridColumnStyle)
PropertyDescriptor	Ruft die PropertyDescriptor für den DataGridTextBoxColumn ab oder legt diese fest.
ReadOnly	Legt einen Wert fest, der angibt, ob die Textfeldspalte schreibgeschützt ist.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
TextBox	Ruft das gehostete TextBox-Steuerelement ab.
Width	Ruft die Breite der Spalte ab oder legt diese fest. (Geerbt von DataGridColumnStyle)

Methoden

Abort(Int32)	Initiiert eine Anforderung, einen Bearbeitungsvorgang zu unterbrechen.
BeginUpdate()	Unterbricht das Zeichnen der Spalte, bis die EndUpdate()-Methode aufgerufen wird. (Geerbt von DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)	Löst eine Ausnahme aus, wenn für das DataGrid keine gültige Datenquelle vorhanden ist oder diese Spalte keiner gültigen Eigenschaft in der Datenquelle zugeordnet ist. (Geerbt von DataGridColumnStyle)
ColumnStartedEditing(Control)	Benachrichtigt DataGrid darüber, dass der Benutzer mit dem Bearbeiten der Spalte begonnen hat. (Geerbt von DataGridColumnStyle)
Commit(CurrencyManager, Int32)	Initiiert eine Anforderung, einen Bearbeitungsvorgang abzuschließen.
ConcedeFocus()	Informiert die Spalte, dass der Fokus abgegeben wird.
CreateHeaderAccessibleObject()	Ruft das AccessibleObject für die Spalte ab. (Geerbt von DataGridColumnStyle)
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)	Bereitet eine Zelle für die Bearbeitung vor. (Geerbt von DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)	Bereitet die Zelle unter Verwendung des angegebenen CurrencyManager, der Zeilennummer und der Rectangle-Parameter für die Bearbeitung vor. (Geerbt von DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)	Bereitet eine Zelle für die Bearbeitung vor.
EndEdit()	Beendet einen Bearbeitungsvorgang für den DataGridColumnStyle.
EndUpdate()	Setzt das Zeichnen von Spalten fort, das durch den Aufruf der BeginUpdate()-Methode unterbrochen wurde. (Geerbt von DataGridColumnStyle)
EnterNullValue()	Gibt einen Value in der Spalte ein.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetColumnValueAtRow(CurrencyManager, Int32)	Ruft den Wert in der angegebenen Zeile aus dem angegebenen CurrencyManager ab. (Geerbt von DataGridColumnStyle)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetMinimumHeight()	Ruft die Höhe einer Zelle in einem DataGridColumnStyle ab.
GetPreferredHeight(Graphics, Object)	Ruft die Höhe ab, die bei der automatischen Größenanpassung von Spalten verwendet werden soll.
GetPreferredSize(Graphics, Object)	Gibt die optimale Breite und Höhe einer Zelle in einer angegebenen Zeile relativ zum angegebenen Wert zurück.
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HideEditBox()	Blendet das DataGridTextBox-Steuerelement aus und übergibt den Fokus an das DataGrid-Steuerelement.
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
Invalidate()	Zeichnet die Spalte neu und bewirkt, dass eine Zeichenmeldung an das Steuerelement gesendet wird. (Geerbt von DataGridColumnStyle)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)	Zeichnet einen DataGridColumnStyle mit dem angegebenen Graphics, dem angegebenen Rectangle, dem angegebenen CurrencyManager und der Zeilennummer.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Zeichnet einen DataGridColumnStyle mit der angegebenen Graphics, dem angegebenen Rectangle, dem angegebenen CurrencyManager, der angegebenen Zeilennummer und der angegebenen Ausrichtung.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)	Zeichnet einen DataGridColumnStyle mit der angegebenen Graphics, dem angegebenen Rectangle, dem angegebenen CurrencyManager, der angegebenen Zeilennummer, dem angegebenen Brush und der angegebenen Vordergrundfarbe.
PaintText(Graphics, Rectangle, String, Boolean)	Zeichnet Text und Rechteck mit der angegebenen Ausrichtung an der angegebenen Position.
PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)	Zeichnet Text und Rechteck mit den angegebenen Farben und der angegebenen Ausrichtung an der angegebenen Position.
ReleaseHostedControl()	Entfernt den im DataGrid enthaltenen Verweis auf das Steuerelement zum Bearbeiten von Daten.
ResetHeaderText()	Setzt den HeaderText auf den Standardwert `null` zurück. (Geerbt von DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)	Legt für den Wert in einer angegebenen Zeile den Wert aus einem angegebenen CurrencyManager fest. (Geerbt von DataGridColumnStyle)
SetDataGrid(DataGrid)	Legt das DataGrid-Steuerelement fest, zu dem diese Spalte gehört. (Geerbt von DataGridColumnStyle)
SetDataGridInColumn(DataGrid)	Fügt der TextBox des DataGrid-Steuerelements ein Control.ControlCollection-Steuerelement hinzu.
ToString()	Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. (Geerbt von Component)
UpdateUI(CurrencyManager, Int32, String)	Aktualisiert die Benutzeroberfläche.

Ereignisse

AlignmentChanged	Tritt ein, wenn der Alignment-Eigenschaftswert geändert wird. (Geerbt von DataGridColumnStyle)
Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)
FontChanged	Tritt ein, wenn die Schriftart der Spalte geändert wird. (Geerbt von DataGridColumnStyle)
HeaderTextChanged	Tritt ein, wenn der HeaderText-Eigenschaftswert geändert wird. (Geerbt von DataGridColumnStyle)
MappingNameChanged	Tritt ein, wenn sich der MappingName-Wert ändert. (Geerbt von DataGridColumnStyle)
NullTextChanged	Tritt ein, wenn sich der NullText-Wert ändert. (Geerbt von DataGridColumnStyle)
PropertyDescriptorChanged	Tritt ein, wenn der PropertyDescriptor-Eigenschaftswert geändert wird. (Geerbt von DataGridColumnStyle)
ReadOnlyChanged	Tritt ein, wenn der ReadOnly-Eigenschaftswert geändert wird. (Geerbt von DataGridColumnStyle)
WidthChanged	Tritt ein, wenn der Width-Eigenschaftswert geändert wird. (Geerbt von DataGridColumnStyle)

Explizite Schnittstellenimplementierungen

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

Benachrichtigt das DataGrid-Steuerelement darüber, dass der Benutzer mit dem Bearbeiten der Spalte begonnen hat.

(Geerbt von DataGridColumnStyle)

Gilt für: