DataGridViewCheckBoxColumn Sınıf

Tanım

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

Devralma

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewCheckBoxColumn

Öznitelikler

ToolboxBitmapAttribute

Örnekler

Aşağıdaki kod örneği, hangi çalışanların iş yeri dışında olduğunu işaretlemek için nasıl DataGridViewCheckBoxColumn kullanılacağını gösterir. Bu örnek, sınıfa genel bakış konusunda bulunan DataGridViewComboBoxColumn daha büyük bir örneğin bir parçasıdır.

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

Açıklamalar

DataGridViewCheckBoxColumn sınıfı, ikili durumu gösteren hücreleri mantıksal olarak barındırmak için kullanılan sınıfın özelleştirilmiş bir türüdürDataGridViewColumn. A DataGridViewCheckBoxColumn ile kesişen her DataGridViewRow ile ilişkilendirilmiş DataGridViewCheckBoxCell bir vardır. Her hücre, denetime CheckBox benzer bir kullanıcı arabirimi (UI) sağlar.

Bu sütun türü için varsayılan sıralama modu şeklindedir NotSortable.

Genellikle, onay kutusu hücre değerleri diğer veriler gibi depolamaya veya toplu işlemler gerçekleştirmeye yöneliktir. Kullanıcılar bir onay kutusu hücresine tıkladığında hemen yanıt vermek istiyorsanız, olayı işleyebilirsiniz DataGridView.CellContentClick , ancak bu olay hücre değeri güncelleştirilmeden önce gerçekleşir. Tıklama sırasında yeni değere ihtiyacınız varsa, bir seçenek beklenen değerin geçerli değere göre hesaplanmasıdır. Bir diğer yaklaşım da değişikliği hemen işlemek ve buna yanıt vermek için olayı işlemektir DataGridView.CellValueChanged . Hücreye tıklandığında değişikliği işlemek için olayı işlemeniz DataGridView.CurrentCellDirtyStateChanged gerekir. İşleyicide, geçerli hücre bir onay kutusu hücresiyse yöntemini çağırın DataGridView.CommitEdit ve değerini geçirin Commit .

Devralanlara Notlar

öğesinden DataGridViewCheckBoxColumn türetdiğinizde ve türetilmiş sınıfa yeni özellikler eklediğinizde, kopyalama işlemleri sırasında yeni özellikleri kopyalamak için yöntemini geçersiz kıldığınızdan Clone() emin olun. Temel sınıfın Clone() özelliklerinin yeni hücreye kopyalanmaları için temel sınıfın yöntemini de çağırmalısınız.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

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