DataGridViewCheckBoxCell Kelas

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

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.

Menampilkan antarmuka pengguna (UI) kotak centang untuk digunakan dalam DataGridView kontrol.

public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCell

public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell

type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell

Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell

Warisan: Object

DataGridViewElement

DataGridViewCell
DataGridViewCheckBoxCell

Penerapan: IDataGridViewEditingCell

Contoh

Contoh kode berikut menggunakan DataGridViewCheckBoxColumn untuk melacak karyawan mana yang berada di kantor. Kolom terdiri dari DataGridViewCheckBoxCell objek. 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 DataGridViewCheckBoxCell adalah jenis khusus yang DataGridViewCell digunakan untuk menampilkan informasi biner atau terner yang disajikan melalui UI kotak centang. Dalam mode biner default, sel dapat menyimpan nilai true atau false. Dalam mode terner, sel mengambil salah CheckState satu nilai. Properti ThreeState menentukan apakah mode biner atau ternary berlaku.

DataGridViewCheckBoxColumn adalah tipe kolom yang dikhususkan untuk menahan sel tipe ini. Secara default, diinisialisasi DataGridViewCheckBoxColumn.CellTemplate ke yang baru DataGridViewCheckBoxCell. Untuk membuat pola sel dalam kolom setelah kolom yang sudah ada DataGridViewCheckBoxCell, atur properti kolom CellTemplate ke sel untuk digunakan sebagai pola.

Properti kolom terkait sel adalah pembungkus untuk properti sel templat yang dinamai serupa. Mengubah nilai properti sel templat hanya akan memengaruhi sel berdasarkan templat yang ditambahkan setelah perubahan. Namun, mengubah nilai properti terkait sel kolom akan memperbarui sel templat dan semua sel lain dalam kolom, dan menyegarkan tampilan kolom jika perlu.

Ketika sel saat ini adalah DataGridViewCheckBoxCell, DataGridView.IsCurrentCellInEditMode properti selalu true.

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.CellClick , 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 DataGridViewCheckBoxCell 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

DataGridViewCheckBoxCell()	Menginisialisasi instans baru kelas ke DataGridViewCheckBoxCell status defaultnya.
DataGridViewCheckBoxCell(Boolean)	Menginisialisasi instans DataGridViewCheckBoxCell baru kelas, mengaktifkan status biner atau ternary.

Properti

AccessibilityObject	Mendapatkan yang DataGridViewCell.DataGridViewCellAccessibleObject ditetapkan ke DataGridViewCell. (Diperoleh dari DataGridViewCell)
ColumnIndex	Mendapatkan indeks kolom untuk sel ini. (Diperoleh dari DataGridViewCell)
ContentBounds	Mendapatkan persegi panjang pembatas yang mencakup area konten sel. (Diperoleh dari DataGridViewCell)
ContextMenuStrip	Mendapatkan atau mengatur menu pintasan yang terkait dengan sel. (Diperoleh dari DataGridViewCell)
DataGridView	Mendapatkan kontrol yang DataGridView terkait dengan elemen ini. (Diperoleh dari DataGridViewElement)
DefaultNewRowValue	Mendapatkan nilai default untuk sel dalam baris untuk rekaman baru. (Diperoleh dari DataGridViewCell)
Displayed	Mendapatkan nilai yang menunjukkan apakah sel saat ini ditampilkan di layar. (Diperoleh dari DataGridViewCell)
EditedFormattedValue	Mendapatkan nilai sel yang saat ini diformat, terlepas dari apakah sel berada dalam mode edit dan nilai belum diterapkan. (Diperoleh dari DataGridViewCell)
EditingCellFormattedValue	Mendapatkan atau mengatur nilai kontrol yang diformat yang dihosting oleh sel saat berada dalam mode edit.
EditingCellValueChanged	Mendapatkan atau mengatur bendera yang menunjukkan bahwa nilai telah diubah untuk sel ini.
EditType	Mendapatkan jenis kontrol pengeditan sel yang dihosting.
ErrorIconBounds	Mendapatkan batas ikon kesalahan untuk sel. (Diperoleh dari DataGridViewCell)
ErrorText	Mendapatkan atau mengatur teks yang menjelaskan kondisi kesalahan yang terkait dengan sel. (Diperoleh dari DataGridViewCell)
FalseValue	Mendapatkan atau mengatur nilai yang mendasar yang sesuai dengan nilai `false`sel .
FlatStyle	Mendapatkan atau mengatur tampilan gaya datar antarmuka pengguna (UI) kotak centang.
FormattedValue	Mendapatkan nilai sel seperti yang diformat untuk ditampilkan. (Diperoleh dari DataGridViewCell)
FormattedValueType	Mendapatkan tipe nilai tampilan sel.
Frozen	Mendapatkan nilai yang menunjukkan apakah sel dibekukan. (Diperoleh dari DataGridViewCell)
HasStyle	Mendapatkan nilai yang menunjukkan apakah Style properti telah ditetapkan. (Diperoleh dari DataGridViewCell)
IndeterminateValue	Mendapatkan atau mengatur nilai yang mendasar yang terkait dengan nilai sel atau `null` yang tidak ditentukan.
InheritedState	Mendapatkan status sel saat ini seperti yang diwarisi dari status baris dan kolomnya. (Diperoleh dari DataGridViewCell)
InheritedStyle	Mendapatkan gaya yang saat ini diterapkan ke sel. (Diperoleh dari DataGridViewCell)
IsInEditMode	Mendapatkan nilai yang menunjukkan apakah sel ini sedang diedit. (Diperoleh dari DataGridViewCell)
OwningColumn	Mendapatkan kolom yang berisi sel ini. (Diperoleh dari DataGridViewCell)
OwningRow	Mendapatkan baris yang berisi sel ini. (Diperoleh dari DataGridViewCell)
PreferredSize	Mendapatkan ukuran, dalam piksel, dari area persegi panjang tempat sel dapat pas. (Diperoleh dari DataGridViewCell)
ReadOnly	Mendapatkan atau mengatur nilai yang menunjukkan apakah data sel dapat diedit. (Diperoleh dari DataGridViewCell)
Resizable	Mendapatkan nilai yang menunjukkan apakah sel dapat diubah ukurannya. (Diperoleh dari DataGridViewCell)
RowIndex	Mendapatkan indeks baris induk sel. (Diperoleh dari DataGridViewCell)
Selected	Mendapatkan atau mengatur nilai yang menunjukkan apakah sel telah dipilih. (Diperoleh dari DataGridViewCell)
Size	Mendapatkan ukuran sel. (Diperoleh dari DataGridViewCell)
State	Mendapatkan status antarmuka pengguna (UI) dari elemen . (Diperoleh dari DataGridViewElement)
Style	Mendapatkan atau mengatur gaya untuk sel. (Diperoleh dari DataGridViewCell)
Tag	Mendapatkan atau mengatur objek yang berisi data tambahan tentang sel. (Diperoleh dari DataGridViewCell)
ThreeState	Mendapatkan atau menetapkan nilai yang menunjukkan apakah mode terner telah diaktifkan untuk kontrol kotak centang yang dihosting.
ToolTipText	Mendapatkan atau mengatur teks TipsAlat yang terkait dengan sel ini. (Diperoleh dari DataGridViewCell)
TrueValue	Mendapatkan atau mengatur nilai yang mendasar yang terkait dengan nilai `true`sel .
Value	Mendapatkan atau mengatur nilai yang terkait dengan sel ini. (Diperoleh dari DataGridViewCell)
ValueType	Mendapatkan tipe data nilai dalam sel.
Visible	Mendapatkan nilai yang menunjukkan apakah sel berada dalam baris atau kolom yang telah disembunyikan. (Diperoleh dari DataGridViewCell)

Metode

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Memodifikasi gaya batas sel input sesuai dengan kriteria yang ditentukan. (Diperoleh dari DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Mengembalikan Rectangle yang mewakili lebar semua margin sel. (Diperoleh dari DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Menunjukkan apakah baris sel akan tidak dibagi saat sel diklik. (Diperoleh dari DataGridViewCell)
Clone()	Membuat salinan yang tepat dari sel ini.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Menunjukkan apakah baris yang berisi sel akan tidak dibagi saat konten sel diklik.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Menunjukkan apakah baris yang berisi sel akan tidak dibagi saat konten sel diklik dua kali.
CreateAccessibilityInstance()	Membuat objek baru yang dapat diakses untuk DataGridViewCheckBoxCell.
DetachEditingControl()	Menghapus kontrol pengeditan sel dari DataGridView. (Diperoleh dari DataGridViewCell)
Dispose()	Merilis semua sumber daya yang DataGridViewCelldigunakan oleh . (Diperoleh dari DataGridViewCell)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang DataGridViewCell digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Menunjukkan apakah baris sel akan tidak dibagi saat sel diklik ganda. (Diperoleh dari DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Menunjukkan apakah baris induk akan tidak dibagi saat fokus berpindah ke sel. (Diperoleh dari DataGridViewCell)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Mengambil nilai sel yang diformat untuk disalin ke Clipboard. (Diperoleh dari DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Mengembalikan persegi panjang pembatas yang mengapit area konten sel, yang dihitung menggunakan gaya sel dan yang ditentukan Graphics .
GetContentBounds(Int32)	Mengembalikan persegi panjang pembatas yang mengapit area konten sel menggunakan gaya default Graphics dan sel yang saat ini berlaku untuk sel. (Diperoleh dari DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Mengembalikan nilai sel yang saat ini diformat, terlepas dari apakah sel berada dalam mode edit dan nilai belum diterapkan. (Diperoleh dari DataGridViewCell)
GetEditingCellFormattedValue(DataGridViewDataErrorContexts)	Mendapatkan nilai sel yang diformat saat berada dalam mode edit.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Mengembalikan persegi panjang pembatas yang mengapit ikon kesalahan sel, jika ditampilkan.
GetErrorText(Int32)	Mengembalikan string yang menunjukkan kesalahan untuk sel. (Diperoleh dari DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Mendapatkan nilai data sel yang diformat.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetInheritedContextMenuStrip(Int32)	Mendapatkan menu pintasan yang diwariskan untuk sel saat ini. (Diperoleh dari DataGridViewCell)
GetInheritedState(Int32)	Mengembalikan nilai yang menunjukkan status sel saat ini seperti yang diwarisi dari status baris dan kolomnya. (Diperoleh dari DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Mendapatkan gaya yang diterapkan ke sel. (Diperoleh dari DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Menghitung ukuran pilihan, dalam piksel, sel.
GetSize(Int32)	Mendapatkan ukuran sel. (Diperoleh dari DataGridViewCell)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetValue(Int32)	Mendapatkan nilai sel. (Diperoleh dari DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Menginisialisasi kontrol yang digunakan untuk mengedit sel. (Diperoleh dari DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Menunjukkan apakah baris yang berisi sel tidak dibagikan saat tombol ditekan saat sel memiliki fokus.
KeyEntersEditMode(KeyEventArgs)	Menentukan apakah mode edit harus dimulai berdasarkan kunci yang diberikan. (Diperoleh dari DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Menunjukkan apakah baris akan tidak dibagi jika tombol ditekan saat sel di baris memiliki fokus. (Diperoleh dari DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Menunjukkan apakah baris yang berisi sel tidak dibagikan saat kunci dilepaskan saat sel memiliki fokus.
LeaveUnsharesRow(Int32, Boolean)	Menunjukkan apakah baris akan tidak dibagi saat fokus meninggalkan sel dalam baris. (Diperoleh dari DataGridViewCell)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Menunjukkan apakah baris akan tidak dibagi jika pengguna mengklik tombol mouse saat penunjuk berada di sel dalam baris. (Diperoleh dari DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Menunjukkan apakah baris akan tidak dibagikan jika pengguna mengklik dua kali sel dalam baris. (Diperoleh dari DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Menunjukkan apakah baris yang berisi sel akan tidak dibagi saat tombol mouse ditekan saat penunjuk berada di atas sel.
MouseEnterUnsharesRow(Int32)	Menunjukkan apakah baris yang berisi sel akan tidak dibagi saat penunjuk mouse bergerak di atas sel.
MouseLeaveUnsharesRow(Int32)	Menunjukkan apakah baris yang berisi sel akan tidak dibagi saat penunjuk mouse meninggalkan sel.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Menunjukkan apakah baris akan tidak dibagi saat penunjuk mouse bergerak di atas sel dalam baris. (Diperoleh dari DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Menunjukkan apakah baris yang berisi sel akan tidak dibagi saat tombol mouse dilepaskan saat penunjuk berada di atas sel.
OnClick(DataGridViewCellEventArgs)	Dipanggil saat sel diklik. (Diperoleh dari DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Dipanggil saat konten sel diklik.
OnContentDoubleClick(DataGridViewCellEventArgs)	Dipanggil saat konten sel diklik dua kali.
OnDataGridViewChanged()	Dipanggil DataGridView saat properti sel berubah. (Diperoleh dari DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Dipanggil saat sel diklik ganda. (Diperoleh dari DataGridViewCell)
OnEnter(Int32, Boolean)	Dipanggil saat fokus berpindah ke sel. (Diperoleh dari DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Dipanggil saat tombol karakter ditekan saat fokus berada pada sel.
OnKeyPress(KeyPressEventArgs, Int32)	Dipanggil saat tombol ditekan saat fokus berada pada sel. (Diperoleh dari DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Dipanggil saat kunci karakter dilepaskan saat fokus berada pada sel.
OnLeave(Int32, Boolean)	Dipanggil saat fokus berpindah dari sel.
OnMouseClick(DataGridViewCellMouseEventArgs)	Dipanggil saat pengguna mengklik tombol mouse saat penunjuk berada di sel. (Diperoleh dari DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Dipanggil saat pengguna mengklik dua kali tombol mouse saat penunjuk berada di sel. (Diperoleh dari DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Dipanggil saat tombol mouse ditahan saat penunjuk berada di sel.
OnMouseEnter(Int32)	Dipanggil saat penunjuk mouse bergerak di atas sel. (Diperoleh dari DataGridViewCell)
OnMouseLeave(Int32)	Dipanggil saat penunjuk mouse berpindah dari sel.
OnMouseMove(DataGridViewCellMouseEventArgs)	Dipanggil saat penunjuk mouse bergerak di dalam sel.
OnMouseUp(DataGridViewCellMouseEventArgs)	Dipanggil saat tombol mouse dilepaskan saat penunjuk berada di sel.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Melukis saat ini DataGridViewCheckBoxCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Melukis batas arus DataGridViewCell. (Diperoleh dari DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Melukis ikon kesalahan saat ini DataGridViewCell. (Diperoleh dari DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Mengonversi nilai yang diformat untuk ditampilkan ke nilai sel aktual.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Mengatur lokasi dan ukuran kontrol pengeditan yang dihosting oleh sel dalam DataGridView kontrol. (Diperoleh dari DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Mengatur lokasi dan ukuran panel pengeditan yang dihosting oleh sel, dan mengembalikan batas normal kontrol pengeditan dalam panel pengeditan. (Diperoleh dari DataGridViewCell)
PrepareEditingCellForEdit(Boolean)	Metode ini tidak bermakna untuk jenis ini.
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)
SetValue(Int32, Object)	Mengatur nilai sel. (Diperoleh dari DataGridViewCell)
ToString()	Mengembalikan representasi string sel.

Berlaku untuk