DataGridViewCheckBoxColumn Classe

Definição

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

Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn

Herança

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewCheckBoxColumn

Atributos

ToolboxBitmapAttribute

Exemplos

O seguinte exemplo de código demonstra como usar a DataGridViewCheckBoxColumn para assinalar quais os funcionários que estão fora do escritório. Este exemplo faz parte de um exemplo mais amplo disponível no DataGridViewComboBoxColumn tópico de visão geral da aula.

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

Observações

A DataGridViewCheckBoxColumn classe é um tipo especializado da DataGridViewColumn classe usada para alojar logicamente células que indicam o estado binário. A DataGridViewCheckBoxColumn tem um associado DataGridViewCheckBoxCell em cada DataGridViewRow que o intersecta. Cada célula fornece uma interface de utilizador (UI) semelhante a um CheckBox controlo.

O modo de ordenação por defeito para este tipo de coluna é NotSortable.

Normalmente, os valores das células da caixa de seleção destinam-se ao armazenamento, como quaisquer outros dados, ou à execução de operações em massa. Se quiser responder imediatamente quando os usuários clicarem em uma célula de caixa de seleção, você poderá manipular o evento DataGridView.CellContentClick, mas esse evento ocorre antes que o valor da célula seja atualizado. Se você precisar do novo valor no momento do clique, uma opção é calcular qual será o valor esperado com base no valor atual. Outra abordagem é confirmar a alteração imediatamente e gerir o evento DataGridView.CellValueChanged para responder a ele. Para confirmar a alteração quando a célula é clicada, você deve manipular o evento DataGridView.CurrentCellDirtyStateChanged. No manipulador, se a célula atual for uma célula de caixa de seleção, chame o método DataGridView.CommitEdit e passe o valor Commit.

Notas para Herdeiros

Quando derivar e DataGridViewCheckBoxColumn adicionar novas propriedades à classe derivada, certifique-se de sobrepor o Clone() método para copiar as novas propriedades durante as operações de clonagem. Deves também chamar o método da Clone() classe base para que as propriedades da classe base sejam copiadas para a nova célula.

Ver também

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