DataGridViewCheckBoxColumn 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.
Menghosting DataGridViewCheckBoxCell kumpulan objek.
public ref class DataGridViewCheckBoxColumn : System::Windows::Forms::DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn.bmp")]
public class DataGridViewCheckBoxColumn : System.Windows.Forms.DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")]
public class DataGridViewCheckBoxColumn : System.Windows.Forms.DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn.bmp")>]
type DataGridViewCheckBoxColumn = class
inherit DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")>]
type DataGridViewCheckBoxColumn = class
inherit DataGridViewColumn
Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn
- Warisan
- Atribut
Contoh
Contoh kode berikut menunjukkan cara menggunakan DataGridViewCheckBoxColumn untuk menandai karyawan mana yang berada di luar kantor. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia dalam DataGridViewComboBoxColumn topik gambaran umum kelas.
private:
void AddOutOfOfficeColumn()
{
DataGridViewCheckBoxColumn^ column = gcnew DataGridViewCheckBoxColumn();
{
column->HeaderText = ColumnName::OutOfOffice.ToString();
column->Name = ColumnName::OutOfOffice.ToString();
column->AutoSizeMode =
DataGridViewAutoSizeColumnMode::DisplayedCells;
column->FlatStyle = FlatStyle::Standard;
column->ThreeState = true;
column->CellTemplate = gcnew DataGridViewCheckBoxCell();
column->CellTemplate->Style->BackColor = Color::Beige;
}
DataGridView1->Columns->Insert(0, column);
}
private void AddOutOfOfficeColumn()
{
DataGridViewCheckBoxColumn column = new DataGridViewCheckBoxColumn();
{
column.HeaderText = ColumnName.OutOfOffice.ToString();
column.Name = ColumnName.OutOfOffice.ToString();
column.AutoSizeMode =
DataGridViewAutoSizeColumnMode.DisplayedCells;
column.FlatStyle = FlatStyle.Standard;
column.ThreeState = true;
column.CellTemplate = new DataGridViewCheckBoxCell();
column.CellTemplate.Style.BackColor = Color.Beige;
}
DataGridView1.Columns.Insert(0, column);
}
Private Sub AddOutOfOfficeColumn()
Dim column As New DataGridViewCheckBoxColumn()
With column
.HeaderText = ColumnName.OutOfOffice.ToString()
.Name = ColumnName.OutOfOffice.ToString()
.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
.FlatStyle = FlatStyle.Standard
.CellTemplate = New DataGridViewCheckBoxCell()
.CellTemplate.Style.BackColor = Color.Beige
End With
DataGridView1.Columns.Insert(0, column)
End Sub
Keterangan
Kelas DataGridViewCheckBoxColumn adalah jenis kelas khusus yang DataGridViewColumn digunakan untuk menghosting sel secara logis yang menunjukkan status biner. DataGridViewCheckBoxColumn A memiliki yang terkait DataGridViewCheckBoxCell dalam setiap DataGridViewRow yang bersinggungan dengannya. Setiap sel memasok antarmuka pengguna (UI) yang mirip CheckBox dengan kontrol.
Mode pengurutan default untuk jenis kolom ini adalah NotSortable.
Biasanya, nilai sel kotak centang ditujukan untuk penyimpanan, seperti data lainnya, atau untuk melakukan operasi massal. Jika Anda ingin segera merespons saat pengguna mengklik sel kotak centang, Anda bisa menangani peristiwa tersebut DataGridView.CellContentClick , tetapi peristiwa ini terjadi sebelum nilai sel diperbarui. Jika Anda memerlukan nilai baru pada saat klik, salah satu opsinya adalah menghitung nilai yang diharapkan berdasarkan nilai saat ini. Pendekatan lain adalah segera menerapkan perubahan, dan menangani DataGridView.CellValueChanged peristiwa untuk meresponsnya. Untuk menerapkan perubahan saat sel diklik, Anda harus menangani peristiwa.DataGridView.CurrentCellDirtyStateChanged Di handler, jika sel saat ini adalah sel kotak centang, panggil DataGridView.CommitEdit metode dan berikan nilai.Commit
Catatan Bagi Inheritor
Ketika Anda berasal dari DataGridViewCheckBoxColumn dan menambahkan properti baru ke kelas turunan, pastikan untuk mengambil Clone() alih metode untuk menyalin properti baru selama operasi kloning. Anda juga harus memanggil metode kelas Clone() dasar sehingga properti kelas dasar disalin ke sel baru.
Konstruktor
DataGridViewCheckBoxColumn() |
Menginisialisasi instans DataGridViewCheckBoxColumn baru kelas ke status default. |
DataGridViewCheckBoxColumn(Boolean) |
Menginisialisasi instans DataGridViewCheckBoxColumn baru dan mengonfigurasinya untuk menampilkan kotak centang dengan dua atau tiga status. |
Properti
AutoSizeMode |
Mendapatkan atau mengatur mode di mana kolom secara otomatis menyesuaikan lebarnya. (Diperoleh dari DataGridViewColumn) |
CellTemplate |
Mendapatkan atau mengatur templat yang digunakan untuk membuat sel baru. |
CellType |
Mendapatkan jenis run-time templat sel. (Diperoleh dari DataGridViewColumn) |
ContextMenuStrip |
Mendapatkan atau mengatur menu pintasan untuk kolom. (Diperoleh dari DataGridViewColumn) |
DataGridView |
Mendapatkan kontrol yang DataGridView terkait dengan elemen ini. (Diperoleh dari DataGridViewElement) |
DataPropertyName |
Mendapatkan atau mengatur nama properti sumber data atau kolom database yang DataGridViewColumn terikat. (Diperoleh dari DataGridViewColumn) |
DefaultCellStyle |
Mendapatkan atau mengatur gaya sel default kolom. |
DefaultHeaderCellType |
Mendapatkan atau mengatur jenis run-time dari sel header default. (Diperoleh dari DataGridViewBand) |
Displayed |
Mendapatkan nilai yang menunjukkan apakah pita saat ini ditampilkan di layar. (Diperoleh dari DataGridViewBand) |
DisplayIndex |
Mendapatkan atau mengatur urutan tampilan kolom relatif terhadap kolom yang saat ini ditampilkan. (Diperoleh dari DataGridViewColumn) |
DividerWidth |
Mendapatkan atau mengatur lebar, dalam piksel, pembagi kolom. (Diperoleh dari DataGridViewColumn) |
FalseValue |
Mendapatkan atau mengatur nilai yang mendasar yang terkait dengan nilai |
FillWeight |
Mendapatkan atau mengatur nilai yang mewakili lebar kolom saat berada dalam mode isian relatif terhadap lebar kolom mode isian lainnya dalam kontrol. (Diperoleh dari DataGridViewColumn) |
FlatStyle |
Mendapatkan atau mengatur tampilan gaya datar dari sel kotak centang. |
Frozen |
Mendapatkan atau mengatur nilai yang menunjukkan apakah kolom akan bergerak saat pengguna menggulir DataGridView kontrol secara horizontal. (Diperoleh dari DataGridViewColumn) |
HasDefaultCellStyle |
Mendapatkan nilai yang menunjukkan apakah DefaultCellStyle properti telah ditetapkan. (Diperoleh dari DataGridViewBand) |
HeaderCell |
Mendapatkan atau mengatur DataGridViewColumnHeaderCell yang mewakili header kolom. (Diperoleh dari DataGridViewColumn) |
HeaderCellCore |
Mendapatkan atau mengatur sel header dari DataGridViewBand. (Diperoleh dari DataGridViewBand) |
HeaderText |
Mendapatkan atau mengatur teks caption pada sel header kolom. (Diperoleh dari DataGridViewColumn) |
IndeterminateValue |
Mendapatkan atau mengatur nilai dasar yang terkait dengan nilai sel atau |
Index |
Mendapatkan posisi relatif band dalam DataGridView kontrol. (Diperoleh dari DataGridViewBand) |
InheritedAutoSizeMode |
Mendapatkan mode ukuran yang berlaku untuk kolom. (Diperoleh dari DataGridViewColumn) |
InheritedStyle |
Mendapatkan gaya sel yang saat ini diterapkan ke kolom. (Diperoleh dari DataGridViewColumn) |
IsDataBound |
Mendapatkan nilai yang menunjukkan apakah kolom terikat ke sumber data. (Diperoleh dari DataGridViewColumn) |
IsRow |
Mendapatkan nilai yang menunjukkan apakah pita mewakili baris. (Diperoleh dari DataGridViewBand) |
MinimumWidth |
Mendapatkan atau mengatur lebar minimum, dalam piksel, dari kolom. (Diperoleh dari DataGridViewColumn) |
Name |
Mendapatkan atau mengatur nama kolom. (Diperoleh dari DataGridViewColumn) |
ReadOnly |
Mendapatkan atau mengatur nilai yang menunjukkan apakah pengguna dapat mengedit sel kolom. (Diperoleh dari DataGridViewColumn) |
Resizable |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kolom dapat diubah bentuknya. (Diperoleh dari DataGridViewColumn) |
Selected |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah pita berada dalam status antarmuka pengguna (UI) yang dipilih. (Diperoleh dari DataGridViewBand) |
Site |
Mendapatkan atau mengatur situs kolom. (Diperoleh dari DataGridViewColumn) |
SortMode |
Mendapatkan atau mengatur mode pengurutan untuk kolom. (Diperoleh dari DataGridViewColumn) |
State |
Mendapatkan status antarmuka pengguna (UI) dari elemen . (Diperoleh dari DataGridViewElement) |
Tag |
Mendapatkan atau mengatur objek yang berisi data untuk dikaitkan dengan pita. (Diperoleh dari DataGridViewBand) |
ThreeState |
Mendapatkan atau mengatur nilai yang menunjukkan apakah sel kotak centang yang dihosting akan memperbolehkan tiga status centang daripada dua. |
ToolTipText |
Mendapatkan atau mengatur teks yang digunakan untuk TipsAlat. (Diperoleh dari DataGridViewColumn) |
TrueValue |
Mendapatkan atau mengatur nilai yang mendasar yang terkait dengan nilai |
ValueType |
Mendapatkan atau mengatur tipe data nilai dalam sel kolom. (Diperoleh dari DataGridViewColumn) |
Visible |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kolom terlihat. (Diperoleh dari DataGridViewColumn) |
Width |
Mendapatkan atau mengatur lebar kolom saat ini. (Diperoleh dari DataGridViewColumn) |
Metode
Clone() |
Membuat salinan yang tepat dari band ini. (Diperoleh dari DataGridViewColumn) |
Dispose() |
Merilis semua sumber daya yang DataGridViewBanddigunakan oleh . (Diperoleh dari DataGridViewBand) |
Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang digunakan oleh DataGridViewBand dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DataGridViewColumn) |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) |
Menghitung lebar kolom yang ideal berdasarkan kriteria yang ditentukan. (Diperoleh dari DataGridViewColumn) |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
OnDataGridViewChanged() |
Dipanggil ketika band dikaitkan dengan yang berbeda DataGridView. (Diperoleh dari DataGridViewBand) |
RaiseCellClick(DataGridViewCellEventArgs) |
Memunculkan kejadian CellClick. (Diperoleh dari DataGridViewElement) |
RaiseCellContentClick(DataGridViewCellEventArgs) |
Memunculkan kejadian CellContentClick. (Diperoleh dari DataGridViewElement) |
RaiseCellContentDoubleClick(DataGridViewCellEventArgs) |
Memunculkan kejadian CellContentDoubleClick. (Diperoleh dari DataGridViewElement) |
RaiseCellValueChanged(DataGridViewCellEventArgs) |
Memunculkan kejadian CellValueChanged. (Diperoleh dari DataGridViewElement) |
RaiseDataError(DataGridViewDataErrorEventArgs) |
Memunculkan kejadian DataError. (Diperoleh dari DataGridViewElement) |
RaiseMouseWheel(MouseEventArgs) |
Memunculkan kejadian MouseWheel. (Diperoleh dari DataGridViewElement) |
ToString() |
Mendapatkan string yang menjelaskan kolom . |
Acara
Disposed |
Terjadi ketika dibuang DataGridViewColumn . (Diperoleh dari DataGridViewColumn) |