DataGridViewCheckBoxCell Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DataGridViewCheckBoxCell.cs

Visualizza una casella di controllo interfaccia utente da usare in un DataGridView controllo .

public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCell

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell

Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell

Ereditarietà

Object

DataGridViewElement

DataGridViewCell

DataGridViewCheckBoxCell

Attributi

DynamicallyAccessedMembersAttribute

Implementazioni

IDataGridViewEditingCell

Esempio

Nell'esempio di codice seguente viene usato un DataGridViewCheckBoxColumn oggetto per tenere traccia dei dipendenti presenti nell'ufficio. La colonna è costituita da DataGridViewCheckBoxCell oggetti . Questo esempio fa parte di un esempio più ampio disponibile nell'argomento di panoramica della 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

Commenti

La DataGridViewCheckBoxCell classe è un tipo specializzato di usato per visualizzare informazioni binarie o ternarie presentate tramite un'interfaccia utente della casella di DataGridViewCell controllo. Nella modalità binaria predefinita le celle possono contenere valori di true o false. In modalità ternaria, le celle assumono uno dei CheckState valori. La ThreeState proprietà determina se la modalità binaria o ternaria è attiva.

DataGridViewCheckBoxColumn è il tipo di colonna specializzato per contenere le celle di questo tipo. Per impostazione predefinita, l'oggetto DataGridViewCheckBoxColumn.CellTemplate viene inizializzato in un nuovo DataGridViewCheckBoxCelloggetto . Per creare un pattern per le celle all'interno di una colonna dopo un oggetto esistente DataGridViewCheckBoxCell, impostare la proprietà della CellTemplate colonna sulla cella da utilizzare come criterio.

Le proprietà correlate alla cella della colonna sono wrapper per le proprietà denominate in modo analogo della cella del modello. La modifica dei valori delle proprietà della cella modello influirà solo sulle celle in base al modello aggiunto dopo la modifica. Se necessario, la modifica dei valori delle proprietà correlate alla cella della colonna aggiornerà la cella del modello e tutte le altre celle della colonna e aggiornerà la visualizzazione della colonna, se necessario.

Quando la cella corrente è un oggetto DataGridViewCheckBoxCell, la DataGridView.IsCurrentCellInEditMode proprietà è sempre true.

In genere, i valori delle celle della casella di controllo sono destinati all'archiviazione, come qualsiasi altro dato o per l'esecuzione di operazioni bulk. Se si desidera rispondere immediatamente quando gli utenti fa clic su una cella della casella di controllo, è possibile gestire l'evento, ma questo evento si verifica prima dell'aggiornamento DataGridView.CellClick del valore della cella. Se è necessario il nuovo valore al momento del clic, un'opzione consiste nel calcolare il valore previsto in base al valore corrente. Un altro approccio consiste nel eseguire immediatamente il commit della modifica e gestire l'evento DataGridView.CellValueChanged per rispondere. Per eseguire il commit della modifica quando si fa clic sulla cella, è necessario gestire l'evento DataGridView.CurrentCellDirtyStateChanged . Nel gestore, se la cella corrente è una cella della casella di controllo, chiamare il DataGridView.CommitEdit metodo e passare il Commit valore.

Note per gli eredi

Quando si deriva da DataGridViewCheckBoxCell e si aggiungono nuove proprietà alla classe derivata, assicurarsi di eseguire l'override del Clone() metodo per copiare le nuove proprietà durante le operazioni di clonazione. È anche necessario chiamare il metodo della classe base Clone() in modo che le proprietà della classe di base vengano copiate nella nuova cella.

Costruttori

Nome	Descrizione
DataGridViewCheckBoxCell()	Inizializza una nuova istanza della DataGridViewCheckBoxCell classe sullo stato predefinito.
DataGridViewCheckBoxCell(Boolean)	Inizializza una nuova istanza della DataGridViewCheckBoxCell classe , abilitando lo stato binario o ternario.

Proprietà

Nome	Descrizione
AccessibilityObject	Ottiene l'oggetto DataGridViewCell.DataGridViewCellAccessibleObject assegnato all'oggetto DataGridViewCell. (Ereditato da DataGridViewCell)
ColumnIndex	Ottiene l'indice di colonna per questa cella. (Ereditato da DataGridViewCell)
ContentBounds	Ottiene il rettangolo di delimitazione che racchiude l'area del contenuto della cella. (Ereditato da DataGridViewCell)
ContextMenuStrip	Ottiene o imposta il menu di scelta rapida associato alla cella. (Ereditato da DataGridViewCell)
DataGridView	Ottiene il DataGridView controllo associato a questo elemento. (Ereditato da DataGridViewElement)
DefaultNewRowValue	Ottiene il valore predefinito per una cella nella riga per i nuovi record. (Ereditato da DataGridViewCell)
Displayed	Ottiene un valore che indica se la cella è attualmente visualizzata sullo schermo. (Ereditato da DataGridViewCell)
EditedFormattedValue	Ottiene il valore corrente formattato della cella, indipendentemente dal fatto che la cella sia in modalità di modifica e il valore non sia stato eseguito il commit. (Ereditato da DataGridViewCell)
EditingCellFormattedValue	Ottiene o imposta il valore formattato del controllo ospitato dalla cella quando è in modalità di modifica.
EditingCellValueChanged	Ottiene o imposta un flag che indica che il valore è stato modificato per questa cella.
EditType	Ottiene il tipo del controllo di modifica ospitato della cella.
ErrorIconBounds	Ottiene i limiti dell'icona di errore per la cella. (Ereditato da DataGridViewCell)
ErrorText	Ottiene o imposta il testo che descrive una condizione di errore associata alla cella. (Ereditato da DataGridViewCell)
FalseValue	Ottiene o imposta il valore sottostante corrispondente a un valore di cella di false.
FlatStyle	Ottiene o imposta l'aspetto dello stile piatto dell'interfaccia utente della casella di controllo.
FormattedValue	Ottiene il valore della cella come formattato per la visualizzazione. (Ereditato da DataGridViewCell)
FormattedValueType	Ottiene il tipo del valore di visualizzazione della cella.
Frozen	Ottiene un valore che indica se la cella è bloccata. (Ereditato da DataGridViewCell)
HasStyle	Ottiene un valore che indica se la Style proprietà è stata impostata. (Ereditato da DataGridViewCell)
IndeterminateValue	Ottiene o imposta il valore sottostante corrispondente a un valore di cella o null indeterminato.
InheritedState	Ottiene lo stato corrente della cella ereditato dallo stato della riga e della colonna. (Ereditato da DataGridViewCell)
InheritedStyle	Ottiene lo stile attualmente applicato alla cella. (Ereditato da DataGridViewCell)
IsInEditMode	Ottiene un valore che indica se la cella è attualmente in fase di modifica. (Ereditato da DataGridViewCell)
OwningColumn	Ottiene la colonna che contiene questa cella. (Ereditato da DataGridViewCell)
OwningRow	Ottiene la riga contenente la cella. (Ereditato da DataGridViewCell)
PreferredSize	Ottiene le dimensioni, in pixel, di un'area rettangolare in cui è possibile adattare la cella. (Ereditato da DataGridViewCell)
ReadOnly	Ottiene o imposta un valore che indica se i dati della cella possono essere modificati. (Ereditato da DataGridViewCell)
Resizable	Ottiene un valore che indica se la cella può essere ridimensionata. (Ereditato da DataGridViewCell)
RowIndex	Ottiene l'indice della riga padre della cella. (Ereditato da DataGridViewCell)
Selected	Ottiene o imposta un valore che indica se la cella è stata selezionata. (Ereditato da DataGridViewCell)
Size	Ottiene le dimensioni della cella. (Ereditato da DataGridViewCell)
State	Ottiene lo stato dell'interfaccia utente dell'elemento. (Ereditato da DataGridViewElement)
Style	Ottiene o imposta lo stile per la cella. (Ereditato da DataGridViewCell)
Tag	Ottiene o imposta l'oggetto che contiene dati supplementari sulla cella. (Ereditato da DataGridViewCell)
ThreeState	Ottiene o imposta un valore che indica se la modalità ternaria è stata abilitata per il controllo casella di controllo ospitato.
ToolTipText	Ottiene o imposta il testo della descrizione comando associato a questa cella. (Ereditato da DataGridViewCell)
TrueValue	Ottiene o imposta il valore sottostante corrispondente a un valore di cella di true.
Value	Ottiene o imposta il valore associato a questa cella. (Ereditato da DataGridViewCell)
ValueType	Ottiene il tipo di dati dei valori nella cella.
Visible	Ottiene un valore che indica se la cella si trova in una riga o in una colonna nascosta. (Ereditato da DataGridViewCell)

Metodi

Nome	Descrizione
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifica lo stile del bordo della cella di input in base ai criteri specificati. (Ereditato da DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Restituisce un oggetto Rectangle che rappresenta la larghezza di tutti i margini della cella. (Ereditato da DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Indica se la riga della cella verrà annullata quando si fa clic sulla cella. (Ereditato da DataGridViewCell)
Clone()	Crea una copia esatta di questa cella.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Indica se la riga contenente la cella verrà annullata quando si fa clic sul contenuto della cella.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se la riga contenente la cella verrà annullata quando si fa doppio clic sul contenuto della cella.
CreateAccessibilityInstance()	Crea un nuovo oggetto accessibile per .DataGridViewCheckBoxCell
DetachEditingControl()	Rimuove il controllo di modifica della cella da DataGridView. (Ereditato da DataGridViewCell)
Dispose()	Rilascia tutte le risorse usate da DataGridViewCell. (Ereditato da DataGridViewCell)
Dispose(Boolean)	Rilascia le risorse non gestite usate da DataGridViewCell e, facoltativamente, rilascia le risorse gestite. (Ereditato da DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se la riga della cella verrà annullata quando si fa doppio clic sulla cella. (Ereditato da DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Indica se la riga padre verrà annullata quando lo stato attivo passa alla cella. (Ereditato da DataGridViewCell)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Recupera il valore formattato della cella da copiare nell'oggetto Clipboard. (Ereditato da DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Restituisce il rettangolo di delimitazione che racchiude l'area di contenuto della cella, calcolata utilizzando lo stile specificato Graphics e della cella.
GetContentBounds(Int32)	Restituisce il rettangolo di delimitazione che racchiude l'area di contenuto della cella utilizzando uno stile predefinito Graphics e di cella attualmente attivo per la cella. (Ereditato da DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Restituisce il valore corrente formattato della cella, indipendentemente dal fatto che la cella sia in modalità di modifica e che il valore non sia stato eseguito. (Ereditato da DataGridViewCell)
GetEditingCellFormattedValue(DataGridViewDataErrorContexts)	Ottiene il valore formattato della cella mentre è in modalità di modifica.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Restituisce il rettangolo di delimitazione che racchiude l'icona di errore della cella, se visualizzata.
GetErrorText(Int32)	Restituisce una stringa che rappresenta l'errore per la cella. (Ereditato da DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Ottiene il valore formattato dei dati della cella.
GetInheritedContextMenuStrip(Int32)	Ottiene il menu di scelta rapida ereditato per la cella corrente. (Ereditato da DataGridViewCell)
GetInheritedState(Int32)	Restituisce un valore che indica lo stato corrente della cella ereditato dallo stato della riga e della colonna. (Ereditato da DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Ottiene lo stile applicato alla cella. (Ereditato da DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Calcola le dimensioni preferite, in pixel, della cella.
GetSize(Int32)	Ottiene le dimensioni della cella. (Ereditato da DataGridViewCell)
GetValue(Int32)	Ottiene il valore della cella. (Ereditato da DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Inizializza il controllo utilizzato per modificare la cella. (Ereditato da DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Indica se la riga contenente la cella viene annullata quando viene premuto un tasto mentre la cella ha lo stato attivo.
KeyEntersEditMode(KeyEventArgs)	Determina se la modalità di modifica deve essere avviata in base alla chiave specificata. (Ereditato da DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Indica se una riga verrà annullata se viene premuto un tasto mentre una cella della riga ha lo stato attivo. (Ereditato da DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indica se la riga contenente la cella viene annullata quando viene rilasciata una chiave mentre la cella ha lo stato attivo.
LeaveUnsharesRow(Int32, Boolean)	Indica se una riga verrà annullata quando lo stato attivo lascia una cella nella riga. (Ereditato da DataGridViewCell)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se una riga verrà annullata se l'utente fa clic su un pulsante del mouse mentre il puntatore si trova in una cella della riga. (Ereditato da DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se una riga verrà annullata se l'utente fa doppio clic su una cella nella riga. (Ereditato da DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se la riga contenente la cella verrà annullata quando viene premuto il pulsante del mouse mentre il puntatore si trova sulla cella.
MouseEnterUnsharesRow(Int32)	Indica se la riga contenente la cella verrà annullata quando il puntatore del mouse si sposta sulla cella.
MouseLeaveUnsharesRow(Int32)	Indica se la riga contenente la cella verrà annullata quando il puntatore del mouse lascia la cella.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se una riga verrà annullata quando il puntatore del mouse si sposta su una cella della riga. (Ereditato da DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se la riga contenente la cella verrà annullata quando il pulsante del mouse viene rilasciato mentre il puntatore si trova sulla cella.
OnClick(DataGridViewCellEventArgs)	Chiamato quando si fa clic sulla cella. (Ereditato da DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Viene chiamato quando si fa clic sul contenuto della cella.
OnContentDoubleClick(DataGridViewCellEventArgs)	Chiamato quando si fa doppio clic sul contenuto della cella.
OnDataGridViewChanged()	Chiamato quando viene modificata la DataGridView proprietà della cella. (Ereditato da DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Chiamato quando si fa doppio clic sulla cella. (Ereditato da DataGridViewCell)
OnEnter(Int32, Boolean)	Chiamato quando lo stato attivo passa a una cella. (Ereditato da DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Chiamato quando viene premuto un tasto carattere mentre lo stato attivo si trova su una cella.
OnKeyPress(KeyPressEventArgs, Int32)	Chiamato quando viene premuto un tasto mentre lo stato attivo si trova su una cella. (Ereditato da DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Chiamato quando viene rilasciato un tasto carattere mentre lo stato attivo si trova su una cella.
OnLeave(Int32, Boolean)	Chiamato quando lo stato attivo si sposta da una cella.
OnMouseClick(DataGridViewCellMouseEventArgs)	Chiamato quando l'utente fa clic su un pulsante del mouse mentre il puntatore si trova in una cella. (Ereditato da DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Chiamato quando l'utente fa doppio clic su un pulsante del mouse mentre il puntatore si trova in una cella. (Ereditato da DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Viene chiamato quando si tiene premuto il pulsante del mouse mentre il puntatore si trova in una cella.
OnMouseEnter(Int32)	Chiamato quando il puntatore del mouse si sposta su una cella. (Ereditato da DataGridViewCell)
OnMouseLeave(Int32)	Chiamato quando il puntatore del mouse si sposta da una cella.
OnMouseMove(DataGridViewCellMouseEventArgs)	Chiamato quando il puntatore del mouse si sposta all'interno di una cella.
OnMouseUp(DataGridViewCellMouseEventArgs)	Viene chiamato quando il pulsante del mouse viene rilasciato mentre il puntatore si trova in una cella.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Disegna l'oggetto corrente DataGridViewCheckBoxCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Disegna il bordo dell'oggetto corrente DataGridViewCell. (Ereditato da DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Disegna l'icona di errore dell'oggetto corrente DataGridViewCell. (Ereditato da DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Converte un valore formattato per la visualizzazione in un valore di cella effettivo.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Imposta la posizione e le dimensioni del controllo di modifica ospitato da una cella nel DataGridView controllo . (Ereditato da DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Imposta la posizione e le dimensioni del pannello di modifica ospitato dalla cella e restituisce i limiti normali del controllo di modifica all'interno del pannello di modifica. (Ereditato da DataGridViewCell)
PrepareEditingCellForEdit(Boolean)	Questo metodo non è significativo per questo tipo.
RaiseCellClick(DataGridViewCellEventArgs)	Genera l'evento CellClick. (Ereditato da DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Genera l'evento CellContentClick. (Ereditato da DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Genera l'evento CellContentDoubleClick. (Ereditato da DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Genera l'evento CellValueChanged. (Ereditato da DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Genera l'evento DataError. (Ereditato da DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Genera l'evento MouseWheel. (Ereditato da DataGridViewElement)
SetValue(Int32, Object)	Imposta il valore della cella. (Ereditato da DataGridViewCell)
ToString()	Restituisce la rappresentazione di stringa della cella.

Vedi anche

• DataGridView
• DataGridViewCell
• DataGridViewCheckBoxColumn
• CellTemplate