Partilhar via


DataGridViewCheckBoxColumn Classe

Definição

Hospeda uma coleção de objetos DataGridViewCheckBoxCell.

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
Herança
Atributos

Exemplos

O exemplo de código a seguir demonstra como usar um DataGridViewCheckBoxColumn para marcar quais funcionários estão fora do escritório. Este exemplo faz parte de um exemplo maior disponível no tópico de visão geral da DataGridViewComboBoxColumn classe.

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

Comentários

A DataGridViewCheckBoxColumn classe é um tipo especializado da DataGridViewColumn classe usada para hospedar logicamente células que indicam estado binário. Um DataGridViewCheckBoxColumn tem um associado DataGridViewCheckBoxCell em cada DataGridViewRow que o cruza. Cada célula fornece uma interface do usuário semelhante a um CheckBox controle .

O modo de classificação padrão para esse tipo de coluna é NotSortable.

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

Notas aos Herdeiros

Ao derivar de DataGridViewCheckBoxColumn e adicionar novas propriedades à classe derivada, substitua o Clone() método para copiar as novas propriedades durante as operações de clonagem. Você também deve chamar o método da Clone() classe base para que as propriedades da classe base sejam copiadas para a nova célula.

Construtores

DataGridViewCheckBoxColumn()

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

DataGridViewCheckBoxColumn(Boolean)

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

Propriedades

AutoSizeMode

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

(Herdado de DataGridViewColumn)
CellTemplate

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

CellType

Obtém o tipo de tempo de execução do modelo de célula.

(Herdado de DataGridViewColumn)
ContextMenuStrip

Obtém ou define o menu de atalho da coluna.

(Herdado de DataGridViewColumn)
DataGridView

Obtém o controle de DataGridView associado a esse elemento.

(Herdado de DataGridViewElement)
DataPropertyName

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

(Herdado de DataGridViewColumn)
DefaultCellStyle

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

DefaultHeaderCellType

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

(Herdado de DataGridViewBand)
Displayed

Obtém um valor que indica se a banda é exibida na tela no momento.

(Herdado de DataGridViewBand)
DisplayIndex

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

(Herdado de DataGridViewColumn)
DividerWidth

Obtém ou define a largura mínima, em pixels, do divisor de coluna.

(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 desmarcada.

FillWeight

Obtém ou define um valor que representa a largura da coluna quando ela está no modo de preenchimento em relação à largura das outras colunas de modo de preenchimento no controle.

(Herdado de DataGridViewColumn)
FlatStyle

Obtém ou define a aparência de estilo plano das células da caixa de seleção.

Frozen

Obtém ou define um valor que indica se uma coluna será movida quando um usuário rolar o controle DataGridView horizontalmente.

(Herdado de DataGridViewColumn)
HasDefaultCellStyle

Obtém um valor que indica se a propriedade DefaultCellStyle 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

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

(Herdado de DataGridViewColumn)
IndeterminateValue

Obtém ou define o valor subjacente correspondente a um valor de célula indeterminado ou null, exibido como uma caixa de seleção desabilitada.

Index

Obtém a posição relativa da faixa dentro do controle DataGridView.

(Herdado de DataGridViewBand)
InheritedAutoSizeMode

Obtém o modo de redimensionamento em vigor para a coluna.

(Herdado de DataGridViewColumn)
InheritedStyle

Obtém o estilo aplicado atualmente à coluna.

(Herdado de DataGridViewColumn)
IsDataBound

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

(Herdado de DataGridViewColumn)
IsRow

Obtém 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

Obtém ou define o nome da coluna.

(Herdado de DataGridViewColumn)
ReadOnly

Obtém ou define um valor que indica se o usuário pode editar as células da coluna.

(Herdado de DataGridViewColumn)
Resizable

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

(Herdado de DataGridViewColumn)
Selected

Obtém ou define um valor que indica se a banda está em um estado de interface do usuário selecionado.

(Herdado de DataGridViewBand)
Site

Obtém ou define o site da coluna.

(Herdado de DataGridViewColumn)
SortMode

Obtém ou define o modo de classificação da coluna.

(Herdado de DataGridViewColumn)
State

Obtém o estado da UI (interface do usuário) do elemento.

(Herdado de DataGridViewElement)
Tag

Obtém ou define o objeto que contém os dados associados à banda.

(Herdado de DataGridViewBand)
ThreeState

Obtém ou define um valor que indica se as células da caixa de seleção hospedada permitirão três estados de verificação em vez de dois.

ToolTipText

Obtém ou define o texto usado para Dicas de Ferramentas.

(Herdado de DataGridViewColumn)
TrueValue

Obtém ou define o valor subjacente correspondente a um valor de célula de true, exibido como uma caixa de seleção marcada.

ValueType

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

(Herdado de DataGridViewColumn)
Visible

Obtém ou define um valor que indica se a coluna está visível.

(Herdado de DataGridViewColumn)
Width

Obtém ou define a largura atual da coluna.

(Herdado de DataGridViewColumn)

Métodos

Clone()

Cria uma cópia exata dessa faixa.

(Herdado de DataGridViewColumn)
Dispose()

Libera todos os recursos usados pelo DataGridViewBand.

(Herdado de DataGridViewBand)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo DataGridViewBand e opcionalmente libera os recursos gerenciados.

(Herdado de DataGridViewColumn)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(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 Object atual.

(Herdado de Object)
OnDataGridViewChanged()

Chamado quando a faixa está associada a um DataGridView diferente.

(Herdado de DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)

Aciona o evento CellClick.

(Herdado de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Aciona o evento CellContentClick.

(Herdado de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Aciona o evento CellContentDoubleClick.

(Herdado de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Aciona o evento CellValueChanged.

(Herdado de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Aciona o evento DataError.

(Herdado de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Aciona o evento MouseWheel.

(Herdado de DataGridViewElement)
ToString()

Obtém uma cadeia de caracteres que descreve a coluna.

Eventos

Disposed

Ocorre quando o DataGridViewColumn é descartado.

(Herdado de DataGridViewColumn)

Aplica-se a

Confira também