DataGridTextBoxColumn Klasa
Definicja
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
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 DataTableDataColumn, 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, , DecimalDoubleInt32Int64Int16DateTimeUInt32UInt64UInt16Singlei .String
Uwaga
Następujące typy nie są w pełni obsługiwane przez program Visual Basic: DateTime, , UInt16UInt32, 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 |
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ą , , RectangleCurrencyManager, numerem wiersza i wyrównaniem. |
Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Maluje element DataGridColumnStyle o określonym Graphicskolorze , , RectangleCurrencyManagerwiersza, 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 , |
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 DataGridControl.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) |