DataGridViewCheckBoxColumn Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

DataGridViewCheckBoxColumn.cs

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. A DataGridViewCheckBoxColumn memiliki yang terkait DataGridViewCheckBoxCell dalam setiap DataGridViewRow yang bersinggungan. Setiap sel menyediakan antarmuka pengguna (UI) yang mirip CheckBox dengan kontrol.

Mode pengurutan default untuk jenis kolom ini adalah NotSortable.

Biasanya, nilai sel kotak centang ditujukan baik untuk penyimpanan, seperti data lainnya, atau untuk melakukan operasi massal. Jika Anda ingin segera merespons saat pengguna mengklik sel kotak centang, Anda dapat 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 tersebut, dan menangani peristiwa DataGridView.CellValueChanged untuk meresponsnya. Untuk menerapkan perubahan saat sel diklik, Anda harus menangani event DataGridView.CurrentCellDirtyStateChanged. Di dalam handler, jika sel saat ini adalah sel kotak centang, panggil metode DataGridView.CommitEdit dan serahkan nilai Commit.

Catatan Bagi Inheritor

Ketika Anda berasal dari DataGridViewCheckBoxColumn dan menambahkan properti baru ke kelas turunan, pastikan untuk mengambil alih Clone() 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

Nama	Deskripsi
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

Nama	Deskripsi
AutoSizeMode	Mendapatkan atau mengatur mode tempat 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, dari pembagi kolom. (Diperoleh dari DataGridViewColumn)
FalseValue	Mendapatkan atau mengatur nilai yang mendasar yang terkait dengan nilai falsesel , yang muncul sebagai kotak 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 menetapkan 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 keterangan pada sel header kolom. (Diperoleh dari DataGridViewColumn)
IndeterminateValue	Mendapatkan atau mengatur nilai yang mendasar yang sesuai dengan nilai sel atau null yang tidak ditentukan, yang muncul sebagai kotak centang yang dinonaktifkan.
Index	Mendapatkan posisi relatif pita 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 menetapkan 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) 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 memungkinkan 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

Nama	Deskripsi
Clone()	Membuat salinan yang tepat dari band ini. (Diperoleh dari DataGridViewColumn)
Dispose()	Merilis semua sumber daya yang digunakan oleh DataGridViewBand. (Diperoleh dari DataGridViewBand)
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang DataGridViewBand digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DataGridViewColumn)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Menghitung lebar ideal kolom berdasarkan kriteria yang ditentukan. (Diperoleh dari DataGridViewColumn)
OnDataGridViewChanged()	Dipanggil ketika band dikaitkan dengan yang berbeda DataGridView. (Diperoleh dari DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)	Menaikkan peristiwa CellClick. (Diperoleh dari DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Menaikkan peristiwa CellContentClick. (Diperoleh dari DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Menaikkan peristiwa CellContentDoubleClick. (Diperoleh dari DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Menaikkan peristiwa CellValueChanged. (Diperoleh dari DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Menaikkan peristiwa DataError. (Diperoleh dari DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Menaikkan peristiwa MouseWheel. (Diperoleh dari DataGridViewElement)
ToString()	Mendapatkan string yang menjelaskan kolom .

Acara

Nama	Deskripsi
Disposed	Terjadi ketika dibuang DataGridViewColumn . (Diperoleh dari DataGridViewColumn)

Lihat juga

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