DataGridViewCheckBoxColumn Klass

Definition

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

Arv

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewCheckBoxColumn

Attribut

ToolboxBitmapAttribute

Exempel

I följande kodexempel visas hur du använder en DataGridViewCheckBoxColumn för att markera vilka anställda som inte är på kontoret. Det här exemplet är en del av ett större exempel som är tillgängligt i DataGridViewComboBoxColumn avsnittet klassöversikt.

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

Kommentarer

Klassen DataGridViewCheckBoxColumn är en specialiserad typ av klassen DataGridViewColumn som används för att logiskt vara värd för celler som indikerar binärt tillstånd. A DataGridViewCheckBoxColumn har en associerad DataGridViewCheckBoxCell i varje DataGridViewRow som korsar den. Varje cell tillhandahåller ett användargränssnitt (UI) som liknar en CheckBox kontroll.

Standardsorteringsläget för den här kolumntypen är NotSortable.

Normalt är kryssrutan cellvärden avsedda för lagring, som andra data, eller för att utföra massåtgärder. Om du vill svara direkt när användare klickar på en kryssruta kan du hantera händelsen DataGridView.CellContentClick, men den här händelsen inträffar innan cellvärdet uppdateras. Om du behöver det nya värdet vid tidpunkten för klickningen är ett alternativ att beräkna vad det förväntade värdet ska baseras på det aktuella värdet. En annan metod är att genomföra ändringen omedelbart och hantera DataGridView.CellValueChanged-händelsen för att svara på den. Om du vill genomföra ändringen när du klickar på cellen måste du hantera händelsen DataGridView.CurrentCellDirtyStateChanged. Om den aktuella cellen är en kryssruta i hanteraren anropar du metoden DataGridView.CommitEdit och skickar in värdet Commit.

Anteckningar till arvingar

När du härleder från DataGridViewCheckBoxColumn och lägger till nya egenskaper i den härledda klassen måste du åsidosätta Clone() metoden för att kopiera de nya egenskaperna under kloningsåtgärderna. Du bör också anropa basklassens Clone() metod så att egenskaperna för basklassen kopieras till den nya cellen.

Se även

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