DataGridTextBoxColumn Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Varning
DataGrid is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use DataGridView instead.
Är värd för en TextBox kontroll i en cell i en DataGridColumnStyle för redigering av strängar.
public ref class DataGridTextBoxColumn : System::Windows::Forms::DataGridColumnStyle
public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class DataGridTextBoxColumn : System.Windows.Forms.DataGridColumnStyle
type DataGridTextBoxColumn = class
inherit DataGridColumnStyle
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type DataGridTextBoxColumn = class
inherit DataGridColumnStyle
Public Class DataGridTextBoxColumn
Inherits DataGridColumnStyle
- Arv
- Attribut
Exempel
I följande exempel skapas en DataGridTextBoxColumn och läggs till i GridColumnStylesCollection en DataGrid. Om du vill köra det här kodexemplet klistrar du in det i ett formulär som har ett DataGrid namn dataGrid1 och anropar det från konstruktorn för 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
Kommentarer
Klassen DataGridTextBoxColumn härleds från abstract klassen DataGridColumnStyle. Vid körning är DataGridTextBoxColumn värd för en DataGridTextBox kontroll som gör det möjligt för användare att redigera text.
Särskilda egenskaper som läggs till i klassen inkluderar Format, och HideEditBox. Med de här egenskaperna kan du komma åt den värdbaserade DataGridTextBox kontrollen och dess attribut och ange formatet för att visa värden.
Om datakällan är ett DataTable innehållande DataColumn objekt DataType ska egenskapen DataColumn för den anges till en datatyp som logiskt kan redigeras i en textrutekontroll. Följande datatyper associeras automatiskt med : , , , , DataGridTextBoxColumn, Byte, DateTime, Decimal, Double, Int16, , Int32, Int64och UInt16. UInt32UInt64SingleString
Note
Följande typer stöds inte fullt ut av Visual Basic: DateTime, UInt16, UInt32, UInt64 och TimeSpan. (Operatorer är inte tillåtna.)
Konstruktorer
| Name | Description |
|---|---|
| DataGridTextBoxColumn() |
Föråldrad.
Initierar en ny instans av DataGridTextBoxColumn klassen. |
| DataGridTextBoxColumn(PropertyDescriptor, Boolean) |
Föråldrad.
Initierar en ny instans av DataGridTextBoxColumn klassen med den angivna PropertyDescriptor. Anger om DataGridTextBoxColumn är en standardkolumn. |
| DataGridTextBoxColumn(PropertyDescriptor, String, Boolean) |
Föråldrad.
Initierar en ny instans av DataGridTextBoxColumn klassen med ett angivet PropertyDescriptor format. Anger om kolumnen är standardkolumnen. |
| DataGridTextBoxColumn(PropertyDescriptor, String) |
Föråldrad.
Initierar en ny instans av DataGridTextBoxColumn klassen med angivet PropertyDescriptor format och format. |
| DataGridTextBoxColumn(PropertyDescriptor) |
Föråldrad.
Initierar en ny instans av DataGridTextBoxColumn klassen med en angiven PropertyDescriptor. |
Egenskaper
| Name | Description |
|---|---|
| Alignment |
Föråldrad.
Hämtar eller anger justering av text i en kolumn. (Ärvd från DataGridColumnStyle) |
| CanRaiseEvents |
Föråldrad.
Hämtar ett värde som anger om komponenten kan generera en händelse. (Ärvd från Component) |
| Container |
Föråldrad.
Hämtar som IContainer innehåller Component. (Ärvd från Component) |
| DataGridTableStyle |
Föråldrad.
DataGridTableStyle Hämtar för kolumnen. (Ärvd från DataGridColumnStyle) |
| DesignMode |
Föråldrad.
Hämtar ett värde som anger om det Component för närvarande är i designläge. (Ärvd från Component) |
| Events |
Föråldrad.
Hämtar listan över händelsehanterare som är kopplade till den här Component. (Ärvd från Component) |
| FontHeight |
Föråldrad.
Hämtar höjden på kolumnens teckensnitt. (Ärvd från DataGridColumnStyle) |
| Format |
Föråldrad.
Hämtar eller anger de tecken som anger hur text formateras. |
| FormatInfo |
Föråldrad.
Hämtar eller anger den kulturspecifika information som används för att fastställa hur värden formateras. |
| HeaderAccessibleObject |
Föråldrad.
AccessibleObject Hämtar för kolumnen. (Ärvd från DataGridColumnStyle) |
| HeaderText |
Föråldrad.
Hämtar eller anger texten i kolumnrubriken. (Ärvd från DataGridColumnStyle) |
| MappingName |
Föråldrad.
Hämtar eller anger namnet på datamedlemmen som kolumnformatet ska mappas till. (Ärvd från DataGridColumnStyle) |
| NullText |
Föråldrad.
Hämtar eller anger den text som visas när kolumnen innehåller |
| PropertyDescriptor |
Föråldrad.
Hämtar eller anger PropertyDescriptor för DataGridTextBoxColumn. |
| ReadOnly |
Föråldrad.
Anger ett värde som anger om textrutekolumnen är skrivskyddad. |
| ReadOnly |
Föråldrad.
Hämtar eller anger ett värde som anger om data i kolumnen kan redigeras. (Ärvd från DataGridColumnStyle) |
| Site |
Föråldrad.
Hämtar eller ställer in ISite i Component. (Ärvd från Component) |
| TextBox |
Föråldrad.
Hämtar värdbaserad TextBox kontroll. |
| Width |
Föråldrad.
Hämtar eller anger kolumnens bredd. (Ärvd från DataGridColumnStyle) |
Metoder
| Name | Description |
|---|---|
| Abort(Int32) |
Föråldrad.
Initierar en begäran om att avbryta en redigeringsprocedur. |
| BeginUpdate() |
Föråldrad.
Pausar målningen av kolumnen tills EndUpdate() metoden anropas. (Ärvd från DataGridColumnStyle) |
| CheckValidDataSource(CurrencyManager) |
Föråldrad.
Utlöser ett undantag om den DataGrid inte har en giltig datakälla, eller om den här kolumnen inte är mappad till en giltig egenskap i datakällan. (Ärvd från DataGridColumnStyle) |
| ColumnStartedEditing(Control) |
Föråldrad.
Informerar om DataGrid att användaren har börjat redigera kolumnen. (Ärvd från DataGridColumnStyle) |
| Commit(CurrencyManager, Int32) |
Föråldrad.
Initierar en begäran om att slutföra en redigeringsprocedur. |
| ConcedeFocus() |
Föråldrad.
Informerar kolumnen om att fokus släpps in. |
| ConcedeFocus() |
Föråldrad.
Meddelar en kolumn att den måste avstå från fokus till den kontroll som den är värd för. (Ärvd från DataGridColumnStyle) |
| CreateHeaderAccessibleObject() |
Föråldrad.
AccessibleObject Hämtar för kolumnen. (Ärvd från DataGridColumnStyle) |
| CreateObjRef(Type) |
Föråldrad.
Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject) |
| Dispose() |
Föråldrad.
Släpper alla resurser som används av Component. (Ärvd från Component) |
| Dispose(Boolean) |
Föråldrad.
Släpper de ohanterade resurser som används av Component och släpper eventuellt de hanterade resurserna. (Ärvd från Component) |
| Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean) |
Föråldrad.
Förbereder en cell för redigering. |
| Edit(CurrencyManager, Int32, Rectangle, Boolean, String) |
Föråldrad.
Förbereder cellen för redigering med angivet CurrencyManagerradnummer och Rectangle parametrar. (Ärvd från DataGridColumnStyle) |
| Edit(CurrencyManager, Int32, Rectangle, Boolean) |
Föråldrad.
Förbereder en cell för redigering. (Ärvd från DataGridColumnStyle) |
| EndEdit() |
Föråldrad.
Avslutar en redigeringsåtgärd på DataGridColumnStyle. |
| EndUpdate() |
Föråldrad.
Återupptar målningen av kolumner som pausats genom att anropa BeginUpdate() metoden. (Ärvd från DataGridColumnStyle) |
| EnterNullValue() |
Föråldrad.
Anger en Value i kolumnen. |
| EnterNullValue() |
Föråldrad.
Anger en Value i kolumnen. (Ärvd från DataGridColumnStyle) |
| Equals(Object) |
Föråldrad.
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetColumnValueAtRow(CurrencyManager, Int32) |
Föråldrad.
Hämtar värdet på den angivna raden från den angivna CurrencyManager. (Ärvd från DataGridColumnStyle) |
| GetHashCode() |
Föråldrad.
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetLifetimeService() |
Föråldrad.
Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| GetMinimumHeight() |
Föråldrad.
Hämtar höjden på en cell i en DataGridColumnStyle. |
| GetPreferredHeight(Graphics, Object) |
Föråldrad.
Hämtar den höjd som ska användas i för automatisk storleksändring av kolumner. |
| GetPreferredSize(Graphics, Object) |
Föråldrad.
Returnerar cellens optimala bredd och höjd på en angiven rad i förhållande till det angivna värdet. |
| GetService(Type) |
Föråldrad.
Returnerar ett objekt som representerar en tjänst som tillhandahålls av Component eller av dess Container. (Ärvd från Component) |
| GetType() |
Föråldrad.
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| HideEditBox() |
Föråldrad.
Döljer DataGridTextBox kontrollen och flyttar fokus till DataGrid kontrollen. |
| InitializeLifetimeService() |
Föråldrad.
Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| Invalidate() |
Föråldrad.
Ritar om kolumnen och gör att ett färgmeddelande skickas till kontrollen. (Ärvd från DataGridColumnStyle) |
| MemberwiseClone() |
Föråldrad.
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| MemberwiseClone(Boolean) |
Föråldrad.
Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject) |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean) |
Föråldrad.
Målar en DataGridColumnStyle med det angivna Graphicsradnumret , Rectangle, CurrencyManager, och justeringen. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Föråldrad.
Målar en DataGridColumnStyle med angiven Graphics, Rectangle, CurrencyManager, radnummer, Brushoch förgrundsfärg. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Föråldrad.
Målar en DataGridColumnStyle med angivet Graphicsradnummer, RectangleCurrencyManagerbakgrundsfärg, förgrundsfärg och justering. (Ärvd från DataGridColumnStyle) |
| Paint(Graphics, Rectangle, CurrencyManager, Int32) |
Föråldrad.
Målar a DataGridColumnStyle med det angivna Graphicsradnumret , Rectangle, CurrencyManageroch . |
| PaintText(Graphics, Rectangle, String, Boolean) |
Föråldrad.
Ritar texten och rektangeln på den angivna platsen med den angivna justeringen. |
| PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean) |
Föråldrad.
Ritar texten och rektangeln på den angivna platsen med angivna färger och justering. |
| ReleaseHostedControl() |
Föråldrad.
Tar bort referensen DataGrid som innehåller den kontroll som används för att redigera data. |
| ReleaseHostedControl() |
Föråldrad.
Tillåter att kolumnen frigör resurser när kontrollen den är värd för inte behövs. (Ärvd från DataGridColumnStyle) |
| ResetHeaderText() |
Föråldrad.
Återställer HeaderText till dess standardvärde, |
| SetColumnValueAtRow(CurrencyManager, Int32, Object) |
Föråldrad.
Anger värdet på en angiven rad med värdet från en angiven CurrencyManager. (Ärvd från DataGridColumnStyle) |
| SetDataGrid(DataGrid) |
Föråldrad.
Anger den kontroll som den DataGrid här kolumnen tillhör. (Ärvd från DataGridColumnStyle) |
| SetDataGridInColumn(DataGrid) |
Föråldrad.
Lägger till en TextBox kontroll i DataGrid kontrollens Control.ControlCollection. |
| SetDataGridInColumn(DataGrid) |
Föråldrad.
DataGrid Anger för kolumnen. (Ärvd från DataGridColumnStyle) |
| ToString() |
Föråldrad.
Returnerar ett String som innehåller namnet på Component, om det finns. Den här metoden bör inte åsidosättas. (Ärvd från Component) |
| UpdateUI(CurrencyManager, Int32, String) |
Föråldrad.
Uppdaterar användargränssnittet. |
| UpdateUI(CurrencyManager, Int32, String) |
Föråldrad.
Uppdaterar värdet för en angiven rad med den angivna texten. (Ärvd från DataGridColumnStyle) |
Händelser
| Name | Description |
|---|---|
| AlignmentChanged |
Föråldrad.
Inträffar när egenskapsvärdet Alignment ändras. (Ärvd från DataGridColumnStyle) |
| Disposed |
Föråldrad.
Inträffar när komponenten tas bort av ett anrop till Dispose() metoden. (Ärvd från Component) |
| FontChanged |
Föråldrad.
Inträffar när kolumnens teckensnitt ändras. (Ärvd från DataGridColumnStyle) |
| HeaderTextChanged |
Föråldrad.
Inträffar när egenskapsvärdet HeaderText ändras. (Ärvd från DataGridColumnStyle) |
| MappingNameChanged |
Föråldrad.
Inträffar när värdet MappingName ändras. (Ärvd från DataGridColumnStyle) |
| NullTextChanged |
Föråldrad.
Inträffar när värdet NullText ändras. (Ärvd från DataGridColumnStyle) |
| PropertyDescriptorChanged |
Föråldrad.
Inträffar när egenskapsvärdet PropertyDescriptor ändras. (Ärvd från DataGridColumnStyle) |
| ReadOnlyChanged |
Föråldrad.
Inträffar när egenskapsvärdet ReadOnly ändras. (Ärvd från DataGridColumnStyle) |
| WidthChanged |
Föråldrad.
Inträffar när egenskapsvärdet Width ändras. (Ärvd från DataGridColumnStyle) |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control) |
Föråldrad.
Informerar kontrollen om DataGrid att användaren har börjat redigera kolumnen. (Ärvd från DataGridColumnStyle) |