DataGridTextBoxColumn Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Upozornění
DataGrid is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use DataGridView instead.
TextBox Hostuje ovládací prvek v buňce DataGridColumnStyle řetězce pro úpravy.
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
- Dědičnost
- Atributy
Příklady
Následující příklad vytvoří DataGridTextBoxColumn a přidá jej do GridColumnStylesCollection souboru DataGrid. Chcete-li spustit tento příklad kódu, vložte jej do formuláře, který má pojmenovaný DataGriddataGrid1 a volat jej z konstruktoru objektu 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
Poznámky
Třída DataGridTextBoxColumn je odvozena od abstract třídy DataGridColumnStyle. Za běhu hostuje DataGridTextBox ovládací prvek, DataGridTextBoxColumn který uživatelům umožňuje upravovat text.
Zvláštní vlastnosti přidané do třídy zahrnují Formata HideEditBox. Tyto vlastnosti umožňují přístup k hostovanýmu DataGridTextBox ovládacímu prvku a jeho atributům a nastavení formátu pro zobrazení hodnot.
Pokud je DataTable zdrojem dat obsahující DataColumn objekty, DataType vlastnost objektu DataColumn by měla být nastavena na datový typ, který lze logicky upravit v ovládacím prvku textového pole. Následující datové typy jsou automaticky přidruženy k : , , , , , , Int32Int64, UInt32UInt16, UInt64, Singlea .StringInt16DoubleDecimalDateTimeByteDataGridTextBoxColumn
Poznámka:
Jazyk Visual Basic nepodporuje následující typy: DateTime, UInt16, UInt32, UInt64a TimeSpan. (Operátory nejsou povolené.)
Konstruktory
| Name | Description |
|---|---|
| DataGridTextBoxColumn() |
Zastaralé.
Inicializuje novou instanci DataGridTextBoxColumn třídy. |
| DataGridTextBoxColumn(PropertyDescriptor, Boolean) |
Zastaralé.
Inicializuje novou instanci DataGridTextBoxColumn třídy pomocí zadané PropertyDescriptor. Určuje, jestli se jedná o DataGridTextBoxColumn výchozí sloupec. |
| DataGridTextBoxColumn(PropertyDescriptor, String, Boolean) |
Zastaralé.
Inicializuje novou instanci DataGridTextBoxColumn třídy se zadaným PropertyDescriptor a formátem. Určuje, jestli je sloupec výchozím sloupcem. |
| DataGridTextBoxColumn(PropertyDescriptor, String) |
Zastaralé.
Inicializuje novou instanci DataGridTextBoxColumn třídy se zadaným PropertyDescriptor a formátem. |
| DataGridTextBoxColumn(PropertyDescriptor) |
Zastaralé.
Inicializuje novou instanci DataGridTextBoxColumn třídy se zadaným PropertyDescriptor. |
Vlastnosti
| Name | Description |
|---|---|
| Alignment |
Zastaralé.
Získá nebo nastaví zarovnání textu ve sloupci. (Zděděno od DataGridColumnStyle) |
| CanRaiseEvents |
Zastaralé.
Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component) |
| Container |
Zastaralé.
Získá ten IContainer , který obsahuje Component. (Zděděno od Component) |
| DataGridTableStyle |
Zastaralé.
DataGridTableStyle Získá sloupec. (Zděděno od DataGridColumnStyle) |
| DesignMode |
Zastaralé.
Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu. (Zděděno od Component) |
| Events |
Zastaralé.
Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component) |
| FontHeight |
Zastaralé.
Získá výšku písma sloupce. (Zděděno od DataGridColumnStyle) |
| Format |
Zastaralé.
Získá nebo nastaví znaky, které určují, jak je text formátován. |
| FormatInfo |
Zastaralé.
Získá nebo nastaví informace specifické pro jazykovou verzi, které slouží k určení způsobu formátování hodnot. |
| HeaderAccessibleObject |
Zastaralé.
AccessibleObject Získá sloupec. (Zděděno od DataGridColumnStyle) |
| HeaderText |
Zastaralé.
Získá nebo nastaví text záhlaví sloupce. (Zděděno od DataGridColumnStyle) |
| MappingName |
Zastaralé.
Získá nebo nastaví název datového členu pro mapování stylu sloupce na. (Zděděno od DataGridColumnStyle) |
| NullText |
Zastaralé.
Získá nebo nastaví text, který se zobrazí, když sloupec obsahuje |
| PropertyDescriptor |
Zastaralé.
Získá nebo nastaví PropertyDescriptor pro DataGridTextBoxColumn. |
| ReadOnly |
Zastaralé.
Nastaví hodnotu označující, jestli je sloupec textového pole jen pro čtení. |
| ReadOnly |
Zastaralé.
Získá nebo nastaví hodnotu určující, zda lze data ve sloupci upravovat. (Zděděno od DataGridColumnStyle) |
| Site |
Zastaralé.
Získá nebo nastaví ISite .Component (Zděděno od Component) |
| TextBox |
Zastaralé.
Získá hostovaný TextBox ovládací prvek. |
| Width |
Zastaralé.
Získá nebo nastaví šířku sloupce. (Zděděno od DataGridColumnStyle) |
Metody
| Name | Description |
|---|---|
| Abort(Int32) |
Zastaralé.
Zahájí žádost o přerušení procedury úprav. |
| BeginUpdate() |
Zastaralé.
Pozastaví obraz sloupce, dokud EndUpdate() se metoda nevolá. (Zděděno od DataGridColumnStyle) |
| CheckValidDataSource(CurrencyManager) |
Zastaralé.
Vyvolá výjimku, pokud DataGrid nemá platný zdroj dat nebo pokud tento sloupec není namapován na platnou vlastnost ve zdroji dat. (Zděděno od DataGridColumnStyle) |
| ColumnStartedEditing(Control) |
Zastaralé.
DataGrid Informuje uživatele, že začal upravovat sloupec. (Zděděno od DataGridColumnStyle) |
| Commit(CurrencyManager, Int32) |
Zastaralé.
Zahájí žádost o dokončení postupu úprav. |
| ConcedeFocus() |
Zastaralé.
Informuje sloupec, že fokus je zřetězení. |
| ConcedeFocus() |
Zastaralé.
Upozorní sloupec, že musí převést fokus na ovládací prvek, který hostuje. (Zděděno od DataGridColumnStyle) |
| CreateHeaderAccessibleObject() |
Zastaralé.
AccessibleObject Získá sloupec. (Zděděno od DataGridColumnStyle) |
| CreateObjRef(Type) |
Zastaralé.
Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject) |
| Dispose() |
Zastaralé.
Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component) |
| Dispose(Boolean) |
Zastaralé.
Uvolní nespravované prostředky používané Component a volitelně uvolní spravované prostředky. (Zděděno od Component) |
| Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean) |
Zastaralé.
Připraví buňku pro úpravy. |
| Edit(CurrencyManager, Int32, Rectangle, Boolean, String) |
Zastaralé.
Připraví buňku pro úpravy pomocí zadaného CurrencyManagerčísla řádku a Rectangle parametrů. (Zděděno od DataGridColumnStyle) |
| Edit(CurrencyManager, Int32, Rectangle, Boolean) |
Zastaralé.
Připraví buňku pro úpravy. (Zděděno od DataGridColumnStyle) |
| EndEdit() |
Zastaralé.
Ukončí operaci úprav v objektu DataGridColumnStyle. |
| EndUpdate() |
Zastaralé.
Obnoví obraz sloupců pozastavených voláním BeginUpdate() metody. (Zděděno od DataGridColumnStyle) |
| EnterNullValue() |
Zastaralé.
Zadá do sloupce.Value |
| EnterNullValue() |
Zastaralé.
Zadá do Value sloupce. (Zděděno od DataGridColumnStyle) |
| Equals(Object) |
Zastaralé.
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetColumnValueAtRow(CurrencyManager, Int32) |
Zastaralé.
Získá hodnotu v zadaném řádku ze zadaného CurrencyManager. (Zděděno od DataGridColumnStyle) |
| GetHashCode() |
Zastaralé.
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetLifetimeService() |
Zastaralé.
Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| GetMinimumHeight() |
Zastaralé.
Získá výšku buňky v buňce DataGridColumnStyle. |
| GetPreferredHeight(Graphics, Object) |
Zastaralé.
Získá výšku, ve které se má použít pro automatickou změnu velikosti sloupců. |
| GetPreferredSize(Graphics, Object) |
Zastaralé.
Vrátí optimální šířku a výšku buňky v zadaném řádku vzhledem k zadané hodnotě. |
| GetService(Type) |
Zastaralé.
Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jeho Container. (Zděděno od Component) |
| GetType() |
Zastaralé.
Získá Type aktuální instance. (Zděděno od Object) |
| HideEditBox() |
Zastaralé.
Skryje DataGridTextBox ovládací prvek a přesune fokus na DataGrid ovládací prvek. |
| InitializeLifetimeService() |
Zastaralé.
Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| Invalidate() |
Zastaralé.
Překreslí sloupec a způsobí odeslání malování zprávy do ovládacího prvku. (Zděděno od DataGridColumnStyle) |
| MemberwiseClone() |
Zastaralé.
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| MemberwiseClone(Boolean) |
Zastaralé.
Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject) |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean) |
Zastaralé.
Nakreslí zadanou DataGridColumnStyleGraphicshodnotu , , Rectangle, CurrencyManagerčíslo řádku a zarovnání. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Zastaralé.
Nakreslí barvu DataGridColumnStyle zadaného Graphicstextu , , Rectangle, CurrencyManagerčíslo Brushřádku a barvu popředí. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Zastaralé.
Nakreslí zadanou DataGridColumnStyleGraphicshodnotu , , RectangleCurrencyManager, číslo řádku, barvu pozadí, barvu popředí a zarovnání. (Zděděno od DataGridColumnStyle) |
| Paint(Graphics, Rectangle, CurrencyManager, Int32) |
Zastaralé.
Nakreslí zadanou DataGridColumnStyleGraphicshodnotu , Rectangle, CurrencyManagera číslo řádku. |
| PaintText(Graphics, Rectangle, String, Boolean) |
Zastaralé.
Nakreslí text a obdélník na dané místo se zadaným zarovnáním. |
| PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean) |
Zastaralé.
Nakreslí text a obdélník na zadané místo se zadanými barvami a zarovnáním. |
| ReleaseHostedControl() |
Zastaralé.
Odebere odkaz, který DataGrid obsahuje ovládací prvek použitý k úpravě dat. |
| ReleaseHostedControl() |
Zastaralé.
Umožňuje sloupci uvolnit prostředky v případě, že ovládací prvek, který hostuje, není potřeba. (Zděděno od DataGridColumnStyle) |
| ResetHeaderText() |
Zastaralé.
HeaderText Obnoví výchozí hodnotu |
| SetColumnValueAtRow(CurrencyManager, Int32, Object) |
Zastaralé.
Nastaví hodnotu v zadaném řádku s hodnotou ze zadaného CurrencyManagerřádku . (Zděděno od DataGridColumnStyle) |
| SetDataGrid(DataGrid) |
Zastaralé.
DataGrid Nastaví ovládací prvek, do kterého tento sloupec patří. (Zděděno od DataGridColumnStyle) |
| SetDataGridInColumn(DataGrid) |
Zastaralé.
TextBox Přidá ovládací prvek do DataGrid ovládacího prvku Control.ControlCollection. |
| SetDataGridInColumn(DataGrid) |
Zastaralé.
DataGrid Nastaví sloupec. (Zděděno od DataGridColumnStyle) |
| ToString() |
Zastaralé.
String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component) |
| UpdateUI(CurrencyManager, Int32, String) |
Zastaralé.
Aktualizuje uživatelské rozhraní. |
| UpdateUI(CurrencyManager, Int32, String) |
Zastaralé.
Aktualizuje hodnotu zadaného řádku s daným textem. (Zděděno od DataGridColumnStyle) |
Událost
| Name | Description |
|---|---|
| AlignmentChanged |
Zastaralé.
Nastane, když se Alignment změní hodnota vlastnosti. (Zděděno od DataGridColumnStyle) |
| Disposed |
Zastaralé.
Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component) |
| FontChanged |
Zastaralé.
Nastane, když se změní písmo sloupce. (Zděděno od DataGridColumnStyle) |
| HeaderTextChanged |
Zastaralé.
Nastane, když se HeaderText změní hodnota vlastnosti. (Zděděno od DataGridColumnStyle) |
| MappingNameChanged |
Zastaralé.
Nastane, když se MappingName hodnota změní. (Zděděno od DataGridColumnStyle) |
| NullTextChanged |
Zastaralé.
Nastane, když se NullText hodnota změní. (Zděděno od DataGridColumnStyle) |
| PropertyDescriptorChanged |
Zastaralé.
Nastane, když se PropertyDescriptor změní hodnota vlastnosti. (Zděděno od DataGridColumnStyle) |
| ReadOnlyChanged |
Zastaralé.
Nastane, když se ReadOnly změní hodnota vlastnosti. (Zděděno od DataGridColumnStyle) |
| WidthChanged |
Zastaralé.
Nastane, když se Width změní hodnota vlastnosti. (Zděděno od DataGridColumnStyle) |
Explicitní implementace rozhraní
| Name | Description |
|---|---|
| IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control) |
Zastaralé.
DataGrid Informuje ovládací prvek, že uživatel začal upravovat sloupec. (Zděděno od DataGridColumnStyle) |