DataGridTextBoxColumn Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

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í.

Hostuje TextBox ovládací prvek v buňce pro DataGridColumnStyle úpravy řetězců.

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

Dědičnost: Object

MarshalByRefObject

Component

DataGridColumnStyle
DataGridTextBoxColumn

Příklady

Následující příklad vytvoří DataGridTextBoxColumn a přidá ho do GridColumnStylesCollection .DataGrid Pokud chcete spustit tento příklad kódu, vložte ho do formuláře s DataGrid názvem dataGrid1 a zavolejte ho z konstruktoru 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 z abstract třídy DataGridColumnStyle. Za běhu hostuje DataGridTextBoxColumn DataGridTextBox ovládací prvek, který uživatelům umožňuje upravovat text.

Mezi speciální vlastnosti přidané do třídy patří Format, a HideEditBox. Tyto vlastnosti umožňují přístup k hostovanému DataGridTextBox ovládacímu prvku a jeho atributům a nastavit formát pro zobrazení hodnot.

Pokud je DataTable zdrojem dat obsahující DataColumn objekty, DataType vlastnost DataColumn by měla být nastavena na datový typ, který lze logicky upravit v ovládacím prvku textové pole. Následující datové typy jsou automaticky přidruženy k DataGridTextBoxColumn : , , DateTime, Decimal, Double Int16, Int32, Int64 UInt16, , UInt32, UInt64, Single, a String Byte.

Poznámka

Visual Basic plně nepodporuje následující typy: DateTime, , UInt16 UInt32, UInt64a TimeSpan. (Operátory nejsou povolené.)

Konstruktory

DataGridTextBoxColumn()	Inicializuje novou instanci DataGridTextBoxColumn třídy .
DataGridTextBoxColumn(PropertyDescriptor)	Inicializuje novou instanci DataGridTextBoxColumn třídy se zadaným PropertyDescriptorobjektem .
DataGridTextBoxColumn(PropertyDescriptor, Boolean)	Inicializuje novou instanci DataGridTextBoxColumn třídy pomocí zadané PropertyDescriptor. Určuje, jestli DataGridTextBoxColumn je výchozí sloupec.
DataGridTextBoxColumn(PropertyDescriptor, String)	Inicializuje novou instanci DataGridTextBoxColumn třídy se zadaným PropertyDescriptor formátem a .
DataGridTextBoxColumn(PropertyDescriptor, String, Boolean)	Inicializuje novou instanci DataGridTextBoxColumn třídy se zadaným PropertyDescriptor formátem a . Určuje, jestli je sloupec výchozím sloupcem.

Vlastnosti

Alignment	Získá nebo nastaví zarovnání textu ve sloupci. (Zděděno od DataGridColumnStyle)
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
DataGridTableStyle	Získá pro DataGridTableStyle sloupec . (Zděděno od DataGridColumnStyle)
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
FontHeight	Získá výšku písma sloupce. (Zděděno od DataGridColumnStyle)
Format	Získá nebo nastaví znaky, které určují, jak je text formátován.
FormatInfo	Získá nebo nastaví informace specifické pro jazykovou verzi, které slouží k určení, jak jsou hodnoty formátovány.
HeaderAccessibleObject	Získá pro AccessibleObject sloupec . (Zděděno od DataGridColumnStyle)
HeaderText	Získá nebo nastaví text záhlaví sloupce. (Zděděno od DataGridColumnStyle)
MappingName	Získá nebo nastaví název datového členu mapovat styl sloupce na. (Zděděno od DataGridColumnStyle)
NullText	Získá nebo nastaví text, který se zobrazí, když sloupec obsahuje `null`. (Zděděno od DataGridColumnStyle)
PropertyDescriptor	Získá nebo nastaví pro PropertyDescriptor DataGridTextBoxColumn.
ReadOnly	Nastaví hodnotu označující, jestli je sloupec textového pole jen pro čtení.
Site	Získá nebo nastaví ISite z Component. (Zděděno od Component)
TextBox	Získá hostovaný TextBox ovládací prvek.
Width	Získá nebo nastaví šířku sloupce. (Zděděno od DataGridColumnStyle)

Metody

Abort(Int32)	Iniciuje žádost o přerušení procedury úprav.
BeginUpdate()	Pozastaví malování sloupce, dokud není EndUpdate() volána metoda. (Zděděno od DataGridColumnStyle)
CheckValidDataSource(CurrencyManager)	Vyvolá výjimku, pokud DataGrid objekt nemá platný zdroj dat nebo pokud tento sloupec není namapován na platnou vlastnost ve zdroji dat. (Zděděno od DataGridColumnStyle)
ColumnStartedEditing(Control)	Informuje, DataGrid že uživatel začal upravovat sloupec. (Zděděno od DataGridColumnStyle)
Commit(CurrencyManager, Int32)	Zahájí žádost o dokončení editační procedury.
ConcedeFocus()	Informuje sloupec, že se fokus připouští.
CreateHeaderAccessibleObject()	Získá pro AccessibleObject sloupec . (Zděděno od DataGridColumnStyle)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané nástrojem Component a volitelně uvolní spravované prostředky. (Zděděno od Component)
Edit(CurrencyManager, Int32, Rectangle, Boolean)	Připraví buňku pro úpravy. (Zděděno od DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String)	Připraví buňku pro úpravy pomocí zadaných CurrencyManagerparametrů , číslo řádku a Rectangle . (Zděděno od DataGridColumnStyle)
Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean)	Připraví buňku pro úpravy.
EndEdit()	Ukončí operaci úprav na .DataGridColumnStyle
EndUpdate()	Obnoví malování sloupců pozastavených voláním BeginUpdate() metody . (Zděděno od DataGridColumnStyle)
EnterNullValue()	Do sloupce zadá .Value
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetColumnValueAtRow(CurrencyManager, Int32)	Získá hodnotu v zadaném řádku ze zadaného CurrencyManager. (Zděděno od DataGridColumnStyle)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetMinimumHeight()	Získá výšku buňky v objektu DataGridColumnStyle.
GetPreferredHeight(Graphics, Object)	Získá výšku, která má být použita pro automatickou změnu velikosti sloupců.
GetPreferredSize(Graphics, Object)	Vrátí optimální šířku a výšku buňky v zadaném řádku vzhledem k zadané hodnotě.
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container (Zděděno od Component)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
HideEditBox()	Skryje ovládací prvek a přesune fokus DataGridTextBox na ovládací DataGrid prvek.
InitializeLifetimeService()	Zastaralé. Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Invalidate()	Překreslí sloupec a způsobí odeslání zprávy malování do ovládacího prvku. (Zděděno od DataGridColumnStyle)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
Paint(Graphics, Rectangle, CurrencyManager, Int32)	Vykreslí a DataGridColumnStyle zadaným Graphicsčíslem řádku , Rectangle, CurrencyManagera .
Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean)	Vykreslí zadanou DataGridColumnStyle Graphicshodnotu , Rectangle, CurrencyManagerčíslo řádku a zarovnání.
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean)	Vykreslí DataGridColumnStyle barvu na zadanou Graphicsbarvu , Rectangle, , CurrencyManagerčíslo Brushřádku a popředí.
PaintText(Graphics, Rectangle, String, Boolean)	Nakreslí text a obdélník na dané místo se zadaným zarovnáním.
PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean)	Nakreslí text a obdélník na zadané místo se zadanými barvami a zarovnáním.
ReleaseHostedControl()	Odebere odkaz, který DataGrid uchovává na ovládací prvek použitý k úpravě dat.
ResetHeaderText()	HeaderText Obnoví výchozí hodnotu `null`. (Zděděno od DataGridColumnStyle)
SetColumnValueAtRow(CurrencyManager, Int32, Object)	Nastaví hodnotu v zadaném řádku na hodnotu ze zadaného CurrencyManager. (Zděděno od DataGridColumnStyle)
SetDataGrid(DataGrid)	DataGrid Nastaví ovládací prvek, do kterého tento sloupec patří. (Zděděno od DataGridColumnStyle)
SetDataGridInColumn(DataGrid)	Přidá ovládací prvek TextBox do DataGrid ovládacího prvku Control.ControlCollection.
ToString()	String Vrátí hodnotu obsahující název , Componentpokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)
UpdateUI(CurrencyManager, Int32, String)	Aktualizace uživatelské rozhraní.

Událost

AlignmentChanged	Vyvolá se při Alignment změně hodnoty vlastnosti. (Zděděno od DataGridColumnStyle)
Disposed	Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)
FontChanged	Vyvolá se při změně písma sloupce. (Zděděno od DataGridColumnStyle)
HeaderTextChanged	Vyvolá se při HeaderText změně hodnoty vlastnosti. (Zděděno od DataGridColumnStyle)
MappingNameChanged	Vyvolá se při MappingName změně hodnoty. (Zděděno od DataGridColumnStyle)
NullTextChanged	Vyvolá se při NullText změně hodnoty. (Zděděno od DataGridColumnStyle)
PropertyDescriptorChanged	Vyvolá se při PropertyDescriptor změně hodnoty vlastnosti. (Zděděno od DataGridColumnStyle)
ReadOnlyChanged	Vyvolá se při ReadOnly změně hodnoty vlastnosti. (Zděděno od DataGridColumnStyle)
WidthChanged	Vyvolá se při Width změně hodnoty vlastnosti. (Zděděno od DataGridColumnStyle)

Explicitní implementace rozhraní

IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control)

DataGrid Informuje ovládací prvek, že uživatel začal upravovat sloupec.

(Zděděno od DataGridColumnStyle)

Platí pro

Sdílet prostřednictvím