DataGridViewCheckBoxColumn Classe

Definição

Aloja uma coleção de DataGridViewCheckBoxCell objetos.

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
Atributos

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.

Construtores

Name Description
DataGridViewCheckBoxColumn()

Inicializa uma nova instância da DataGridViewCheckBoxColumn classe para o estado padrão.

DataGridViewCheckBoxColumn(Boolean)

Inicializa uma nova instância do DataGridViewCheckBoxColumn e configura-a para mostrar caixas de verificação com dois ou três estados.

Propriedades

Name Description
AutoSizeMode

Obtém ou define o modo pelo qual a coluna ajusta automaticamente a sua largura.

(Herdado de DataGridViewColumn)
CellTemplate

Obtém ou define o modelo usado para criar novas células.

CellType

Obtém o tipo de execução do template da célula.

(Herdado de DataGridViewColumn)
ContextMenuStrip

Recebe ou define o menu de atalhos para a coluna.

(Herdado de DataGridViewColumn)
DataGridView

Obtém o DataGridView controlo associado a este elemento.

(Herdado de DataGridViewElement)
DataPropertyName

Obtém ou define o nome da propriedade da fonte de dados ou da coluna da base de dados à qual está vinculado DataGridViewColumn .

(Herdado de DataGridViewColumn)
DefaultCellStyle

Obtém ou define o estilo de célula padrão da coluna.

DefaultHeaderCellType

Obtém ou define o tipo de execução da célula de cabeçalho padrão.

(Herdado de DataGridViewBand)
Displayed

Recebe um valor que indica se a banda está atualmente exibida no ecrã.

(Herdado de DataGridViewBand)
DisplayIndex

Obtém ou define a ordem de exibição da coluna em relação às colunas atualmente apresentadas.

(Herdado de DataGridViewColumn)
DividerWidth

Obtém ou define a largura, em píxeis, do divisor de colunas.

(Herdado de DataGridViewColumn)
FalseValue

Obtém ou define o valor subjacente correspondente a um valor de célula de false, que aparece como uma caixa não assinalada.

FillWeight

Obtém ou define um valor que representa a largura da coluna quando esta está em modo de preenchimento relativamente às larguras de outras colunas em modo de preenchimento no controlo.

(Herdado de DataGridViewColumn)
FlatStyle

Obtém ou define o aspeto plano das células de caixa de seleção.

Frozen

Recebe ou define um valor que indica se uma coluna se move quando o utilizador desliza o DataGridView controlo horizontalmente.

(Herdado de DataGridViewColumn)
HasDefaultCellStyle

Recebe um valor que indica se a DefaultCellStyle propriedade foi definida.

(Herdado de DataGridViewBand)
HeaderCell

Obtém ou define o DataGridViewColumnHeaderCell que representa o cabeçalho da coluna.

(Herdado de DataGridViewColumn)
HeaderCellCore

Obtém ou define a célula de cabeçalho do DataGridViewBand.

(Herdado de DataGridViewBand)
HeaderText

Recebe ou define o texto da legenda na célula do cabeçalho da coluna.

(Herdado de DataGridViewColumn)
IndeterminateValue

Recebe ou define o valor subjacente correspondente a um valor indeterminado ou null de célula, que aparece como uma caixa de seleção desativada.

Index

Obtém a posição relativa da banda dentro do DataGridView controlo.

(Herdado de DataGridViewBand)
InheritedAutoSizeMode

Assim entra em funcionamento o modo de dimensionamento para a coluna.

(Herdado de DataGridViewColumn)
InheritedStyle

Recebe o estilo de célula atualmente aplicado à coluna.

(Herdado de DataGridViewColumn)
IsDataBound

Obtém um valor que indica se a coluna está ligada a uma fonte de dados.

(Herdado de DataGridViewColumn)
IsRow

Recebe um valor que indica se a banda representa uma linha.

(Herdado de DataGridViewBand)
MinimumWidth

Obtém ou define a largura mínima, em pixels, da coluna.

(Herdado de DataGridViewColumn)
Name

Recebe ou define o nome da coluna.

(Herdado de DataGridViewColumn)
ReadOnly

Recebe ou define um valor que indica se o utilizador pode editar as células da coluna.

(Herdado de DataGridViewColumn)
Resizable

Recebe ou define um valor que indica se a coluna é redimensionável.

(Herdado de DataGridViewColumn)
Selected

Recebe ou define um valor que indica se a banda está num estado selecionado de interface de utilizador (UI).

(Herdado de DataGridViewBand)
Site

Obtém ou define o local da coluna.

(Herdado de DataGridViewColumn)
SortMode

Obtém ou define o modo de ordenação para a coluna.

(Herdado de DataGridViewColumn)
State

Obtém o estado da interface de utilizador (UI) do elemento.

(Herdado de DataGridViewElement)
Tag

Obtém ou define o objeto que contém dados para associar à banda.

(Herdado de DataGridViewBand)
ThreeState

Recebe ou define um valor que indica se as células da caixa de seleção alojadas permitem três estados de verificação em vez de dois.

ToolTipText

Obtém ou define o texto usado para as dicas de ferramenta.

(Herdado de DataGridViewColumn)
TrueValue

Recebe ou define o valor subjacente correspondente a um valor de célula de true, que aparece como uma caixa assinalada.

ValueType

Obtém ou define o tipo de dados dos valores nas células da coluna.

(Herdado de DataGridViewColumn)
Visible

Recebe ou define um valor que indica se a coluna é visível.

(Herdado de DataGridViewColumn)
Width

Obtém ou define a largura atual da coluna.

(Herdado de DataGridViewColumn)

Métodos

Name Description
Clone()

Cria uma cópia exata desta banda.

(Herdado de DataGridViewColumn)
Dispose()

Liberta todos os recursos utilizados pelo DataGridViewBand.

(Herdado de DataGridViewBand)
Dispose(Boolean)

Liberta os recursos não geridos usados pelo DataGridViewBand e opcionalmente liberta os recursos geridos.

(Herdado de DataGridViewColumn)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

Calcula a largura ideal da coluna com base nos critérios especificados.

(Herdado de DataGridViewColumn)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnDataGridViewChanged()

Chamado quando a banda está associada a um .DataGridView

(Herdado de DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)

Eleva o CellClick evento.

(Herdado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Eleva o CellContentClick evento.

(Herdado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Eleva o CellContentDoubleClick evento.

(Herdado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Eleva o CellValueChanged evento.

(Herdado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Eleva o DataError evento.

(Herdado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Eleva o MouseWheel evento.

(Herdado de DataGridViewElement)
ToString()

Recebe uma cadeia que descreve a coluna.

evento

Name Description
Disposed

Ocorre quando é DataGridViewColumn descartado.

(Herdado de DataGridViewColumn)

Aplica-se a

Ver também