DataGridViewCheckBoxCell Classe

Definição

Exibe uma UI (interface do usuário) de caixa de seleção a ser usada em um controle de DataGridView.

public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCell
public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell
type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell
Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell
Herança
DataGridViewCheckBoxCell
Implementações

Exemplos

O exemplo de código a seguir usa um DataGridViewCheckBoxColumn para rastrear quais funcionários estão no escritório. A coluna é composta de DataGridViewCheckBoxCell objetos. 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 DataGridViewCheckBoxCell classe é um tipo especializado de DataGridViewCell usado para exibir informações binárias ou ternárias apresentadas por meio de uma interface do usuário de caixa de marcar. No modo binário padrão, as células podem conter valores de true ou false. No modo ternário, as células assumem um dos CheckState valores. A ThreeState propriedade determina se o modo binário ou ternário está em vigor.

O DataGridViewCheckBoxColumn é o tipo de coluna especializado para armazenar células desse tipo. Por padrão, o DataGridViewCheckBoxColumn.CellTemplate é inicializado para um novo DataGridViewCheckBoxCell. Para padronizar as células dentro de uma coluna após um existente DataGridViewCheckBoxCell, defina a propriedade da CellTemplate coluna como a célula a ser usada como um padrão.

As propriedades relacionadas à célula da coluna são wrappers para as propriedades de nome semelhante da célula de modelo. A alteração dos valores de propriedade da célula de modelo afetará apenas as células com base no modelo adicionado após a alteração. No entanto, alterar os valores da propriedade relacionada à célula da coluna atualizará a célula de modelo e todas as outras células da coluna e atualizará a exibição da coluna, se necessário.

Quando a célula atual é uma DataGridViewCheckBoxCell, a DataGridView.IsCurrentCellInEditMode propriedade é sempre true.

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.CellClick 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 DataGridViewCheckBoxCell 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

DataGridViewCheckBoxCell()

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

DataGridViewCheckBoxCell(Boolean)

Inicializa uma nova instância da classe DataGridViewCheckBoxCell habilitando o estado binário ou ternário.

Propriedades

AccessibilityObject

Obtém o DataGridViewCell.DataGridViewCellAccessibleObject atribuído ao DataGridViewCell.

(Herdado de DataGridViewCell)
ColumnIndex

Obtém o índice da coluna para essa célula.

(Herdado de DataGridViewCell)
ContentBounds

Obtém o retângulo delimitador que circunscreve a área de conteúdo da célula.

(Herdado de DataGridViewCell)
ContextMenuStrip

Obtém ou define o menu de atalho associado à célula.

(Herdado de DataGridViewCell)
DataGridView

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

(Herdado de DataGridViewElement)
DefaultNewRowValue

Obtém o valor padrão para uma célula na linha para novos registros.

(Herdado de DataGridViewCell)
Displayed

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

(Herdado de DataGridViewCell)
EditedFormattedValue

Obtém o valor atual, formatado da célula, independentemente se a célula estiver em modo de edição e o valor não tiver sido confirmado.

(Herdado de DataGridViewCell)
EditingCellFormattedValue

Obtém ou define o valor formatado do controle hospedado pela célula quando ela estiver no modo de edição.

EditingCellValueChanged

Obtém ou define um sinalizador que indica que o valor foi alterado para essa célula.

EditType

Obtém o tipo de controle de edição hospedado da célula.

ErrorIconBounds

Obtém os limites do ícone de erro para a célula.

(Herdado de DataGridViewCell)
ErrorText

Obtém ou define o texto que descreve uma condição de erro associada à célula.

(Herdado de DataGridViewCell)
FalseValue

Obtém ou define o valor subjacente correspondente a um valor de célula de false.

FlatStyle

Obtém ou define a aparência de estilo plano da interface do usuário da caixa de seleção.

FormattedValue

Obtém o valor da célula como formatado para exibição.

(Herdado de DataGridViewCell)
FormattedValueType

Obtém o tipo do valor de exibição da célula.

Frozen

Obtém um valor que indica se a célula está congelada.

(Herdado de DataGridViewCell)
HasStyle

Obtém um valor que indica se a propriedade Style foi definida.

(Herdado de DataGridViewCell)
IndeterminateValue

Obtém ou define o valor subjacente correspondente a um valor de célula indeterminado ou null.

InheritedState

Obtém o estado atual da célula conforme herdado do estado de sua linha e coluna.

(Herdado de DataGridViewCell)
InheritedStyle

Obtém o estilo atualmente aplicado à célula.

(Herdado de DataGridViewCell)
IsInEditMode

Obtém um valor que indica se esta célula está sendo editada no momento.

(Herdado de DataGridViewCell)
OwningColumn

Obtém a coluna que contém essa célula.

(Herdado de DataGridViewCell)
OwningRow

Obtém a linha que contém essa célula.

(Herdado de DataGridViewCell)
PreferredSize

Obtém o tamanho, em pixels, de uma área retangular na qual o controle pode caber.

(Herdado de DataGridViewCell)
ReadOnly

Obtém ou define um valor que indica se os dados da célula podem ser editados.

(Herdado de DataGridViewCell)
Resizable

Obtém um valor que indica se a célula pode ser redimensionada.

(Herdado de DataGridViewCell)
RowIndex

Obtém o índice da linha pai da célula.

(Herdado de DataGridViewCell)
Selected

Obtém ou define um valor que indica se a célula foi selecionada.

(Herdado de DataGridViewCell)
Size

Obtém o tamanho da célula.

(Herdado de DataGridViewCell)
State

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

(Herdado de DataGridViewElement)
Style

Obtém ou define o estilo da célula.

(Herdado de DataGridViewCell)
Tag

Obtém ou define o objeto que contém dados complementares sobre a célula.

(Herdado de DataGridViewCell)
ThreeState

Obtém ou define um valor que indica se o modo ternário foi habilitado para o controle de caixa de seleção hospedada.

ToolTipText

Obtém ou define o texto de ToolTip associado à célula.

(Herdado de DataGridViewCell)
TrueValue

Obtém ou define o valor subjacente correspondente a um valor de célula de true.

Value

Obtém ou define o valor associado a esta célula.

(Herdado de DataGridViewCell)
ValueType

Obtém o tipo de dados dos valores na célula.

Visible

Obtém um valor que indica se a célula está em uma linha ou coluna ocultada.

(Herdado de DataGridViewCell)

Métodos

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

Modifica o estilo de borda da célula de entrada de acordo com os critérios especificados.

(Herdado de DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)

Retorna um Rectangle que representa a largura de todas as margens da célula.

(Herdado de DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)

Indica se linha da célula será descompartilhada quando a célula é clicada.

(Herdado de DataGridViewCell)
Clone()

Cria uma cópia exata desta célula.

ContentClickUnsharesRow(DataGridViewCellEventArgs)

Indica se a linha que contém a célula será descompartilhada quando o conteúdo da célula é clicado.

ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indica se a linha que contém a célula será descompartilhada quando o conteúdo da célula for clicado duas vezes.

CreateAccessibilityInstance()

Cria um novo objeto acessível para o DataGridViewCheckBoxCell.

DetachEditingControl()

Remove o controle de edição da célula do DataGridView.

(Herdado de DataGridViewCell)
Dispose()

Libera todos os recursos usados pelo DataGridViewCell.

(Herdado de DataGridViewCell)
Dispose(Boolean)

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

(Herdado de DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)

Indica se linha da célula será descompartilhada quando a célula é clicada duas vezes.

(Herdado de DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)

Indica se a linha pai será descompartilhada quando o foto se move para a célula.

(Herdado de DataGridViewCell)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

Recupera o valor formatado da célula a ser copiado para o Clipboard.

(Herdado de DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)

Retorna o retângulo delimitador que inclui a área de conteúdo da célula, que é calculada usando o Graphics e o estilo da célula especificados.

GetContentBounds(Int32)

Retorna o retângulo delimitador que circunscreve a área de conteúdo da célula usando um estilo de Graphics e célula padrão em vigor atualmente para a célula.

(Herdado de DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)

Retorna o valor atual formatado da célula, independentemente de se a célula está em modo de edição e o valor não foi confirmado.

(Herdado de DataGridViewCell)
GetEditingCellFormattedValue(DataGridViewDataErrorContexts)

Obtém o valor formatado da célula enquanto ela está no modo de edição.

GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)

Retorna o retângulo delimitador que inclui o ícone de erro da célula, se exibido.

GetErrorText(Int32)

Retorna uma cadeia de caracteres que representa o erro da célula.

(Herdado de DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)

Obtém o valor formatado dos dados da célula.

GetHashCode()

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

(Herdado de Object)
GetInheritedContextMenuStrip(Int32)

Obtém o menu de atalho herdado para a célula atual.

(Herdado de DataGridViewCell)
GetInheritedState(Int32)

Retorna um valor que indica o estado atual da célula conforme herdado do estado da própria linha e coluna.

(Herdado de DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

Obtém o estilo aplicado à célula.

(Herdado de DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

Calcula o tamanho preferido da célula em pixels.

GetSize(Int32)

Obtém o tamanho da célula.

(Herdado de DataGridViewCell)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetValue(Int32)

Obtém o valor da célula.

(Herdado de DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)

Inicializa o controle usado para editar a célula.

(Herdado de DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)

Indica se a linha que contém a célula é descompartilhada quando uma tecla é pressionada enquanto a célula tem o foco.

KeyEntersEditMode(KeyEventArgs)

Determina se o modo de edição deve ser iniciado com base na chave especificada.

(Herdado de DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)

Indica se uma linha será descompartilhada se uma tecla for pressionada enquanto uma célula na linha tem o foco.

(Herdado de DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)

Indica se a linha que contém a célula é descompartilhada quando uma tecla é liberada enquanto a célula tem o foco.

LeaveUnsharesRow(Int32, Boolean)

Indica se uma linha será descompartilhada quando o foco sair de uma célula na linha.

(Herdado de DataGridViewCell)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será descompartilhada se o usuário clicar em um botão do mouse enquanto o ponteiro está em uma célula na linha.

(Herdado de DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será descompartilhada se o usuário clicar duas vezes em uma célula na linha.

(Herdado de DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha que contém a célula será descompartilhada quando o botão do mouse for pressionado enquanto o ponteiro está sobre a célula.

MouseEnterUnsharesRow(Int32)

Indica se uma linha que contém a célula será descompartilhada quando o ponteiro do mouse se mover sobre a célula.

MouseLeaveUnsharesRow(Int32)

Indica se uma linha que contém a célula será descompartilhada quando o ponteiro do mouse sair da célula.

MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha será descompartilhada quando o ponteiro do mouse passar sobre uma célula na linha.

(Herdado de DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)

Indica se uma linha que contém a célula será descompartilhada quando o botão do mouse for liberado enquanto o ponteiro está sobre a célula.

OnClick(DataGridViewCellEventArgs)

Chamado quando se clica na célula.

(Herdado de DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)

Chamado quando ocorre um clique no conteúdo da célula.

OnContentDoubleClick(DataGridViewCellEventArgs)

Chamado quando ocorre um clique duplo no conteúdo da célula.

OnDataGridViewChanged()

Chamado quando a propriedade DataGridView da célula é alterada.

(Herdado de DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)

Chamado quando ocorre um clique duplo na célula.

(Herdado de DataGridViewCell)
OnEnter(Int32, Boolean)

Chamado quando o foco chega a uma célula.

(Herdado de DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)

Chamado quando uma tecla de caractere é pressionada enquanto o foco está em uma célula.

OnKeyPress(KeyPressEventArgs, Int32)

Chamado quando uma tecla é pressionada enquanto o foco está em uma célula.

(Herdado de DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)

Chamado quando uma tecla de caractere é liberada enquanto o foco está em uma célula.

OnLeave(Int32, Boolean)

Chamado quando o foco sai de uma célula.

OnMouseClick(DataGridViewCellMouseEventArgs)

Chamado quando o usuário clica em um botão do mouse enquanto o ponteiro está em uma célula.

(Herdado de DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)

Chamado quando o usuário clica duas vezes em um botão do mouse enquanto o ponteiro está em uma célula.

(Herdado de DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)

Chamado quando o botão do mouse é pressionado enquanto o ponteiro está em uma célula.

OnMouseEnter(Int32)

Chamado quando o ponteiro do mouse se move sobre uma célula.

(Herdado de DataGridViewCell)
OnMouseLeave(Int32)

Chamado quando o ponteiro do mouse sai de uma célula.

OnMouseMove(DataGridViewCellMouseEventArgs)

Chamado quando o ponteiro do mouse se move dentro de uma célula.

OnMouseUp(DataGridViewCellMouseEventArgs)

Chamado quando o botão do mouse é liberado enquanto o ponteiro está em uma célula.

Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)

Pinta o DataGridViewCheckBoxCell atual.

PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)

Pinta a borda do DataGridViewCell atual.

(Herdado de DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

Pinta o ícone de erro do DataGridViewCell atual.

(Herdado de DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

Converte um valor formatado para exibição no valor real da célula.

PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

Define o local e o tamanho do controle de edição hospedado por uma célula no controle DataGridView.

(Herdado de DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

Define o local e o tamanho do painel de edição hospedado pela célula e retorna os limites normais do controle de edição dentro do painel de edição.

(Herdado de DataGridViewCell)
PrepareEditingCellForEdit(Boolean)

Esse método não é significativo para esse tipo.

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)
SetValue(Int32, Object)

Define o valor da célula.

(Herdado de DataGridViewCell)
ToString()

Retorna a representação de cadeia de caracteres da célula.

Aplica-se a

Confira também