DataGridViewCheckBoxColumn Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menghosting DataGridViewCheckBoxCell kumpulan objek.

public ref 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")>]
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn

Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn

Warisan

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewCheckBoxColumn

Atribut

ToolboxBitmapAttribute

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 falsesel , yang muncul sebagai kotak centang yang tidak dicentang.
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 null yang tidak ditentukan, yang muncul sebagai kotak centang yang dinonaktifkan.
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 truesel , yang muncul sebagai kotak centang.
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)

Lihat juga

• DataGridView
• DataGridViewColumn
• DataGridViewRow
• DataGridViewCheckBoxCell
• CheckBox
• SortMode
• CellClick
• CellValueChanged
• CurrentCellDirtyStateChanged
• CommitEdit(DataGridViewDataErrorContexts)