DataGridTextBoxColumn Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Perhatian
DataGrid is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use DataGridView instead.
Menghosting TextBox kontrol di sel DataGridColumnStyle untuk mengedit string.
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
- Warisan
- Atribut
Contoh
Contoh berikut membuat DataGridTextBoxColumn dan menambahkannya ke GridColumnStylesCollection dari DataGrid. Untuk menjalankan contoh kode ini, tempelkan ke dalam formulir yang memiliki DataGrid nama dataGrid1 dan sebut saja dari konstruktor 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
Keterangan
Kelas DataGridTextBoxColumn berasal dari abstract kelas DataGridColumnStyle. Pada waktu proses, DataGridTextBoxColumn menghosting DataGridTextBox kontrol yang memungkinkan pengguna mengedit teks.
Properti khusus yang ditambahkan ke kelas meliputi Format, dan HideEditBox. Properti ini memungkinkan Anda mengakses kontrol yang dihosting DataGridTextBox dan atributnya, dan mengatur format untuk menampilkan nilai.
Jika sumber data adalah objek yang DataTable berisi DataColumn , DataType properti DataColumn harus diatur ke jenis data yang dapat diedit secara logis dalam kontrol kotak teks. Jenis data berikut secara otomatis dikaitkan dengan DataGridTextBoxColumn : Byte, , DateTime, Decimal, Double, Int32Int16, Int64, UInt16, UInt32, UInt64, , Singledan String.
Nota
Jenis berikut ini tidak sepenuhnya didukung oleh Visual Basic: DateTime, , UInt16, UInt32UInt64, dan TimeSpan. (Operator tidak diperbolehkan.)
Konstruktor
| Nama | Deskripsi |
|---|---|
| DataGridTextBoxColumn() |
Kedaluwarsa.
Menginisialisasi instans baru dari kelas DataGridTextBoxColumn. |
| DataGridTextBoxColumn(PropertyDescriptor, Boolean) |
Kedaluwarsa.
Menginisialisasi instans DataGridTextBoxColumn baru kelas menggunakan PropertyDescriptor. Menentukan apakah adalah DataGridTextBoxColumn kolom default. |
| DataGridTextBoxColumn(PropertyDescriptor, String, Boolean) |
Kedaluwarsa.
Menginisialisasi instans DataGridTextBoxColumn baru kelas dengan format dan yang ditentukan PropertyDescriptor . Menentukan apakah kolom adalah kolom default. |
| DataGridTextBoxColumn(PropertyDescriptor, String) |
Kedaluwarsa.
Menginisialisasi instans DataGridTextBoxColumn baru kelas dengan format dan yang ditentukan PropertyDescriptor . |
| DataGridTextBoxColumn(PropertyDescriptor) |
Kedaluwarsa.
Menginisialisasi instans DataGridTextBoxColumn baru kelas dengan PropertyDescriptor. |
Properti
| Nama | Deskripsi |
|---|---|
| Alignment |
Kedaluwarsa.
Mendapatkan atau mengatur perataan teks dalam kolom. (Diperoleh dari DataGridColumnStyle) |
| CanRaiseEvents |
Kedaluwarsa.
Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component) |
| Container |
Kedaluwarsa.
IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component) |
| DataGridTableStyle |
Kedaluwarsa.
DataGridTableStyle Mendapatkan untuk kolom. (Diperoleh dari DataGridColumnStyle) |
| DesignMode |
Kedaluwarsa.
Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component) |
| Events |
Kedaluwarsa.
Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component) |
| FontHeight |
Kedaluwarsa.
Mendapatkan tinggi font kolom. (Diperoleh dari DataGridColumnStyle) |
| Format |
Kedaluwarsa.
Mendapatkan atau mengatur karakter yang menentukan bagaimana teks diformat. |
| FormatInfo |
Kedaluwarsa.
Mendapatkan atau mengatur informasi spesifik budaya yang digunakan untuk menentukan bagaimana nilai diformat. |
| HeaderAccessibleObject |
Kedaluwarsa.
AccessibleObject Mendapatkan untuk kolom. (Diperoleh dari DataGridColumnStyle) |
| HeaderText |
Kedaluwarsa.
Mendapatkan atau mengatur teks header kolom. (Diperoleh dari DataGridColumnStyle) |
| MappingName |
Kedaluwarsa.
Mendapatkan atau mengatur nama anggota data untuk memetakan gaya kolom. (Diperoleh dari DataGridColumnStyle) |
| NullText |
Kedaluwarsa.
Mendapatkan atau mengatur teks yang ditampilkan saat kolom berisi |
| PropertyDescriptor |
Kedaluwarsa.
Mendapatkan atau mengatur PropertyDescriptor untuk DataGridTextBoxColumn. |
| ReadOnly |
Kedaluwarsa.
Mengatur nilai yang menunjukkan apakah kolom kotak teks bersifat baca-saja. |
| ReadOnly |
Kedaluwarsa.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah data dalam kolom dapat diedit. (Diperoleh dari DataGridColumnStyle) |
| Site |
Kedaluwarsa.
Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component) |
| TextBox |
Kedaluwarsa.
Mendapatkan kontrol yang dihosting TextBox . |
| Width |
Kedaluwarsa.
Mendapatkan atau mengatur lebar kolom. (Diperoleh dari DataGridColumnStyle) |
Metode
| Nama | Deskripsi |
|---|---|
| Abort(Int32) |
Kedaluwarsa.
Memulai permintaan untuk mengganggu prosedur edit. |
| BeginUpdate() |
Kedaluwarsa.
Menangguhkan lukisan kolom sampai metode dipanggil EndUpdate() . (Diperoleh dari DataGridColumnStyle) |
| CheckValidDataSource(CurrencyManager) |
Kedaluwarsa.
Memberikan pengecualian jika DataGrid tidak memiliki sumber data yang valid, atau jika kolom ini tidak dipetakan ke properti yang valid di sumber data. (Diperoleh dari DataGridColumnStyle) |
| ColumnStartedEditing(Control) |
Kedaluwarsa.
DataGrid Menginformasikan bahwa pengguna telah mulai mengedit kolom. (Diperoleh dari DataGridColumnStyle) |
| Commit(CurrencyManager, Int32) |
Kedaluwarsa.
Memulai permintaan untuk menyelesaikan prosedur pengeditan. |
| ConcedeFocus() |
Kedaluwarsa.
Menginformasikan kolom bahwa fokus sedang digabungkan. |
| ConcedeFocus() |
Kedaluwarsa.
Memberi tahu kolom bahwa kolom harus melepaskan fokus ke kontrol yang dihostingnya. (Diperoleh dari DataGridColumnStyle) |
| CreateHeaderAccessibleObject() |
Kedaluwarsa.
AccessibleObject Mendapatkan untuk kolom. (Diperoleh dari DataGridColumnStyle) |
| CreateObjRef(Type) |
Kedaluwarsa.
Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject) |
| Dispose() |
Kedaluwarsa.
Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component) |
| Dispose(Boolean) |
Kedaluwarsa.
Merilis sumber daya yang tidak dikelola yang Component digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Component) |
| Edit(CurrencyManager, Int32, Rectangle, Boolean, String, Boolean) |
Kedaluwarsa.
Menyiapkan sel untuk pengeditan. |
| Edit(CurrencyManager, Int32, Rectangle, Boolean, String) |
Kedaluwarsa.
Menyiapkan sel untuk pengeditan menggunakan parameter , nomor baris, dan Rectangle yang ditentukanCurrencyManager. (Diperoleh dari DataGridColumnStyle) |
| Edit(CurrencyManager, Int32, Rectangle, Boolean) |
Kedaluwarsa.
Menyiapkan sel untuk pengeditan. (Diperoleh dari DataGridColumnStyle) |
| EndEdit() |
Kedaluwarsa.
Mengakhiri operasi edit pada DataGridColumnStyle. |
| EndUpdate() |
Kedaluwarsa.
Melanjutkan lukisan kolom yang ditangguhkan dengan memanggil BeginUpdate() metode . (Diperoleh dari DataGridColumnStyle) |
| EnterNullValue() |
Kedaluwarsa.
Value Memasukkan dalam kolom. |
| EnterNullValue() |
Kedaluwarsa.
Memasukkan Value ke dalam kolom. (Diperoleh dari DataGridColumnStyle) |
| Equals(Object) |
Kedaluwarsa.
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| GetColumnValueAtRow(CurrencyManager, Int32) |
Kedaluwarsa.
Mendapatkan nilai dalam baris yang ditentukan dari yang ditentukan CurrencyManager. (Diperoleh dari DataGridColumnStyle) |
| GetHashCode() |
Kedaluwarsa.
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetLifetimeService() |
Kedaluwarsa.
Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject) |
| GetMinimumHeight() |
Kedaluwarsa.
Mendapatkan tinggi sel dalam .DataGridColumnStyle |
| GetPreferredHeight(Graphics, Object) |
Kedaluwarsa.
Mendapatkan tinggi yang akan digunakan untuk mengubah ukuran kolom secara otomatis. |
| GetPreferredSize(Graphics, Object) |
Kedaluwarsa.
Mengembalikan lebar dan tinggi sel yang optimal dalam baris tertentu relatif terhadap nilai yang ditentukan. |
| GetService(Type) |
Kedaluwarsa.
Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component) |
| GetType() |
Kedaluwarsa.
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| HideEditBox() |
Kedaluwarsa.
DataGridTextBox Menyembunyikan kontrol dan memindahkan fokus ke DataGrid kontrol. |
| InitializeLifetimeService() |
Kedaluwarsa.
Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject) |
| Invalidate() |
Kedaluwarsa.
Mengurai ulang kolom dan menyebabkan pesan cat dikirim ke kontrol. (Diperoleh dari DataGridColumnStyle) |
| MemberwiseClone() |
Kedaluwarsa.
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| MemberwiseClone(Boolean) |
Kedaluwarsa.
Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject) |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Boolean) |
Kedaluwarsa.
DataGridColumnStyle Mengecat dengan , , Rectangle, CurrencyManagernomor baris, dan perataan yang ditentukanGraphics. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Kedaluwarsa.
DataGridColumnStyle Mengecat dengan , , Rectangle, CurrencyManagernomor baris, Brush, dan warna latar depan yang ditentukanGraphics. |
| Paint(Graphics, Rectangle, CurrencyManager, Int32, Brush, Brush, Boolean) |
Kedaluwarsa.
DataGridColumnStyle Mengecat dengan , , Rectangle, CurrencyManagernomor baris, warna latar belakang, warna latar depan, dan perataan yang ditentukanGraphics. (Diperoleh dari DataGridColumnStyle) |
| Paint(Graphics, Rectangle, CurrencyManager, Int32) |
Kedaluwarsa.
DataGridColumnStyle Mengecat dengan nomor baris , , RectangleCurrencyManager, dan yang ditentukanGraphics. |
| PaintText(Graphics, Rectangle, String, Boolean) |
Kedaluwarsa.
Menggambar teks dan persegi panjang di lokasi tertentu dengan perataan yang ditentukan. |
| PaintText(Graphics, Rectangle, String, Brush, Brush, Boolean) |
Kedaluwarsa.
Menggambar teks dan persegi panjang di lokasi yang ditentukan dengan warna dan perataan yang ditentukan. |
| ReleaseHostedControl() |
Kedaluwarsa.
Menghapus referensi yang ditangguhkan DataGrid ke kontrol yang digunakan untuk mengedit data. |
| ReleaseHostedControl() |
Kedaluwarsa.
Memungkinkan kolom untuk membebaskan sumber daya ketika kontrol yang dihosting tidak diperlukan. (Diperoleh dari DataGridColumnStyle) |
| ResetHeaderText() |
Kedaluwarsa.
Mereset ke HeaderText nilai defaultnya, |
| SetColumnValueAtRow(CurrencyManager, Int32, Object) |
Kedaluwarsa.
Mengatur nilai dalam baris tertentu dengan nilai dari CurrencyManager. (Diperoleh dari DataGridColumnStyle) |
| SetDataGrid(DataGrid) |
Kedaluwarsa.
DataGrid Mengatur kontrol tempat kolom ini berada. (Diperoleh dari DataGridColumnStyle) |
| SetDataGridInColumn(DataGrid) |
Kedaluwarsa.
TextBox Menambahkan kontrol ke DataGrid kontrol Control.ControlCollection. |
| SetDataGridInColumn(DataGrid) |
Kedaluwarsa.
DataGrid Mengatur untuk kolom. (Diperoleh dari DataGridColumnStyle) |
| ToString() |
Kedaluwarsa.
Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component) |
| UpdateUI(CurrencyManager, Int32, String) |
Kedaluwarsa.
Memperbarui antarmuka pengguna. |
| UpdateUI(CurrencyManager, Int32, String) |
Kedaluwarsa.
Memperbarui nilai baris tertentu dengan teks tertentu. (Diperoleh dari DataGridColumnStyle) |
Acara
| Nama | Deskripsi |
|---|---|
| AlignmentChanged |
Kedaluwarsa.
Terjadi ketika Alignment nilai properti berubah. (Diperoleh dari DataGridColumnStyle) |
| Disposed |
Kedaluwarsa.
Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component) |
| FontChanged |
Kedaluwarsa.
Terjadi ketika font kolom berubah. (Diperoleh dari DataGridColumnStyle) |
| HeaderTextChanged |
Kedaluwarsa.
Terjadi ketika HeaderText nilai properti berubah. (Diperoleh dari DataGridColumnStyle) |
| MappingNameChanged |
Kedaluwarsa.
Terjadi ketika MappingName nilai berubah. (Diperoleh dari DataGridColumnStyle) |
| NullTextChanged |
Kedaluwarsa.
Terjadi ketika NullText nilai berubah. (Diperoleh dari DataGridColumnStyle) |
| PropertyDescriptorChanged |
Kedaluwarsa.
Terjadi ketika PropertyDescriptor nilai properti berubah. (Diperoleh dari DataGridColumnStyle) |
| ReadOnlyChanged |
Kedaluwarsa.
Terjadi ketika ReadOnly nilai properti berubah. (Diperoleh dari DataGridColumnStyle) |
| WidthChanged |
Kedaluwarsa.
Terjadi ketika Width nilai properti berubah. (Diperoleh dari DataGridColumnStyle) |
Implementasi Antarmuka Eksplisit
| Nama | Deskripsi |
|---|---|
| IDataGridColumnStyleEditingNotificationService.ColumnStartedEditing(Control) |
Kedaluwarsa.
DataGrid Menginformasikan kontrol bahwa pengguna telah mulai mengedit kolom. (Diperoleh dari DataGridColumnStyle) |