DataGridViewCheckBoxCell Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Visualizza un'interfaccia utente di tipo casella di controllo da utilizzare in un controllo DataGridView.
public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCellpublic class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCelltype DataGridViewCheckBoxCell = class
inherit DataGridViewCell
interface IDataGridViewEditingCellPublic Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell- Ereditarietà
- Implementazioni
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 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 vengono eseguite su uno dei CheckState valori. La ThreeState proprietà determina se la modalità binaria o ternaria è effettiva.
Il DataGridViewCheckBoxColumn tipo di colonna è specializzato per contenere celle di questo tipo. Per impostazione predefinita, l'oggetto DataGridViewCheckBoxColumn.CellTemplate viene inizializzato in un nuovo DataGridViewCheckBoxCelloggetto . Per patternare le celle all'interno di una colonna dopo un oggetto , DataGridViewCheckBoxCellimpostare la proprietà della CellTemplate colonna sulla cella da usare come modello.
Le proprietà correlate alla cella della colonna sono wrapper per le proprietà denominate in modo analogo della cella modello. La modifica dei valori delle proprietà della cella modello influisce solo sulle celle basate sul modello aggiunto dopo la modifica. La modifica dei valori delle proprietà correlate alle celle della colonna, tuttavia, aggiornerà la cella del modello e tutte le altre celle nella colonna e aggiornerà la colonna se necessario.
Quando la cella corrente è un DataGridViewCheckBoxCelloggetto , 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 vuole 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 il commit immediato della modifica e gestire l'evento DataGridView.CellValueChanged per rispondere. Per eseguire il commit della modifica quando viene fatto clic sulla cella, è necessario gestire l'evento DataGridView.CurrentCellDirtyStateChanged . Nel gestore, se la cella corrente è una cella della casella di controllo, chiamare il metodo e passare il DataGridView.CommitEditCommit 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 Clone() classe base in modo che le proprietà della classe di base vengano copiate nella nuova cella.
Costruttori
| DataGridViewCheckBoxCell() |
Inizializza una nuova istanza della classe DataGridViewCheckBoxCell sul relativo stato predefinito. |
| DataGridViewCheckBoxCell(Boolean) |
Inizializza una nuova istanza della classe DataGridViewCheckBoxCell, abilitando lo stato binario o ternario. |
Proprietà
| AccessibilityObject |
Ottiene l'oggetto DataGridViewCell.DataGridViewCellAccessibleObject assegnato a DataGridViewCell. (Ereditato da DataGridViewCell) |
| ColumnIndex |
Ottiene l'indice della colonna per la 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 controllo DataGridView 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 su schermo. (Ereditato da DataGridViewCell) |
| EditedFormattedValue |
Ottiene il valore formattato corrente della cella, indipendentemente dal fatto che la cella sia in modalità di modifica e che non sia stato eseguito il commit del valore. (Ereditato da DataGridViewCell) |
| EditingCellFormattedValue |
Ottiene o imposta il valore formattato del controllo contenuto dalla cella quando si trova in modalità di modifica. |
| EditingCellValueChanged |
Ottiene o imposta un flag indicante che il valore di questa cella è stato modificato. |
| EditType |
Ottiene il tipo del controllo di modifica contenuto della cella. |
| ErrorIconBounds |
Ottiene i limiti dell'icona di errore per la cella. (Ereditato da DataGridViewCell) |
| ErrorText |
Ottiene o imposta il testo che descrive la condizione di errore associata alla cella. (Ereditato da DataGridViewCell) |
| FalseValue |
Ottiene o imposta il valore sottostante corrispondente al valore |
| FlatStyle |
Ottiene o imposta l'aspetto bidimensionale dell'interfaccia utente di tipo casella di controllo. |
| FormattedValue |
Ottiene il valore della cella 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 proprietà Style è stata impostata. (Ereditato da DataGridViewCell) |
| IndeterminateValue |
Ottiene o imposta il valore sottostante corrispondente a un valore indeterminato o |
| InheritedState |
Ottiene lo stato corrente della cella, ereditato dallo stato della relativa riga e 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 contenente questa cella. (Ereditato da DataGridViewCell) |
| OwningRow |
Ottiene la riga contenente questa cella. (Ereditato da DataGridViewCell) |
| PreferredSize |
Ottiene le dimensioni in pixel di un'area rettangolare in cui è possibile inserire la cella. (Ereditato da DataGridViewCell) |
| ReadOnly |
Ottiene o imposta un valore che indica se è possibile modificare i dati della cella. (Ereditato da DataGridViewCell) |
| Resizable |
Ottiene un valore che indica se è possibile ridimensionare la cella. (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 della cella. (Ereditato da DataGridViewCell) |
| Tag |
Ottiene o imposta l'oggetto contenente dati aggiuntivi relativi alla cella. (Ereditato da DataGridViewCell) |
| ThreeState |
Ottiene o imposta o un valore che indica se la modalità ternaria è stata abilitata per il controllo casella di controllo contenuto. |
| ToolTipText |
Ottiene o imposta il testo della descrizione comandi associato a questa cella. (Ereditato da DataGridViewCell) |
| TrueValue |
Ottiene o imposta il valore sottostante corrispondente al valore |
| Value |
Ottiene o imposta il valore associato a questa cella. (Ereditato da DataGridViewCell) |
| ValueType |
Ottiene il tipo di dati dei valori della cella. |
| Visible |
Ottiene un valore che indica se la cella si trova in una riga o colonna nascosta. (Ereditato da DataGridViewCell) |
Metodi
| 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 una struttura Rectangle che rappresenta le larghezze di tutti i margini delle celle. (Ereditato da DataGridViewCell) |
| ClickUnsharesRow(DataGridViewCellEventArgs) |
Indica se verrà annullata la condivisione della riga contenente la cella quando viene fatto clic sulla cella. (Ereditato da DataGridViewCell) |
| Clone() |
Crea una copia esatta della cella. |
| ContentClickUnsharesRow(DataGridViewCellEventArgs) |
Indica se la condivisione della riga contenente la cella verrà annullata quando viene fatto clic sul contenuto della cella. |
| ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs) |
Indica se la condivisione della riga contenente la cella verrà annullata quando viene fatto 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, le risorse gestite. (Ereditato da DataGridViewCell) |
| DoubleClickUnsharesRow(DataGridViewCellEventArgs) |
Indica se verrà annullata la condivisione della riga contenente la cella quando viene fatto doppio clic sulla cella. (Ereditato da DataGridViewCell) |
| EnterUnsharesRow(Int32, Boolean) |
Indica se verrà annullata la condivisione della riga padre quando lo stato attivo si sposta sulla cella. (Ereditato da DataGridViewCell) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| 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 delimitatore che racchiude l'area di contenuto della cella, calcolato usando l'oggetto Graphics e lo stile della cella specificati. |
| GetContentBounds(Int32) |
Restituisce il rettangolo di delimitazione che racchiude l'area del contenuto della cella mediante una classe Graphics predefinita e lo stile della cella attualmente utilizzato. (Ereditato da DataGridViewCell) |
| GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts) |
Restituisce il valore formattato corrente della cella, indipendentemente dal fatto che la cella sia in modalità di modifica e che non sia stato eseguito il commit del valore. (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. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| 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 relativa riga e 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 preferenziali, in pixel, della cella. |
| GetSize(Int32) |
Ottiene le dimensioni della cella. (Ereditato da DataGridViewCell) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| GetValue(Int32) |
Ottiene il valore della cella. (Ereditato da DataGridViewCell) |
| InitializeEditingControl(Int32, Object, DataGridViewCellStyle) |
Inizializza il controllo usato per la modifica della cella. (Ereditato da DataGridViewCell) |
| KeyDownUnsharesRow(KeyEventArgs, Int32) |
Indica se la condivisione della riga contenente la cella verrà 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 al tasto premuto. (Ereditato da DataGridViewCell) |
| KeyPressUnsharesRow(KeyPressEventArgs, Int32) |
Indica se verrà annullata la condivisione della riga quando viene premuto un tasto mentre è attiva una cella nella riga. (Ereditato da DataGridViewCell) |
| KeyUpUnsharesRow(KeyEventArgs, Int32) |
Indica se la condivisione della riga contenente la cella verrà annullata quando viene rilasciato un tasto mentre la cella ha lo stato attivo. |
| LeaveUnsharesRow(Int32, Boolean) |
Indica se verrà annullata la condivisione di una riga quando la cella nella riga perde lo stato attivo. (Ereditato da DataGridViewCell) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| MouseClickUnsharesRow(DataGridViewCellMouseEventArgs) |
Indica se verrà annullata la condivisione di una riga quando l'utente fa clic su un pulsante del mouse con il puntatore posizionato in una cella della riga. (Ereditato da DataGridViewCell) |
| MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs) |
Indica se verrà annullata la condivisione di una riga quando l'utente fa doppio clic su una cella della riga. (Ereditato da DataGridViewCell) |
| MouseDownUnsharesRow(DataGridViewCellMouseEventArgs) |
Indica se la condivisione della riga contenente la cella verrà annullata quando il pulsante del mouse viene premuto mentre il puntatore è posizionato sulla cella. |
| MouseEnterUnsharesRow(Int32) |
Indica se la condivisione della riga contenente la cella verrà annullata quando il puntatore del mouse viene spostato sulla cella. |
| MouseLeaveUnsharesRow(Int32) |
Indica se la condivisione della riga contenente la cella verrà annullata quando il puntatore del mouse esce dalla cella. |
| MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs) |
Indica se verrà annullata la condivisione di una riga quando il puntatore del mouse viene spostato su una cella della riga. (Ereditato da DataGridViewCell) |
| MouseUpUnsharesRow(DataGridViewCellMouseEventArgs) |
Indica se la condivisione della riga contenente la cella verrà annullata quando il pulsante del mouse viene rilasciato mentre il puntatore è posizionato sulla cella. |
| OnClick(DataGridViewCellEventArgs) |
Chiamato quando si fa clic sulla cella. (Ereditato da DataGridViewCell) |
| OnContentClick(DataGridViewCellEventArgs) |
Chiamato quando si fa clic sul contenuto della cella. |
| OnContentDoubleClick(DataGridViewCellEventArgs) |
Chiamato quando si fa doppio clic sul contenuto della cella. |
| OnDataGridViewChanged() |
Viene chiamato quando cambia la proprietà DataGridView 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 si sposta su una cella. (Ereditato da DataGridViewCell) |
| OnKeyDown(KeyEventArgs, Int32) |
Chiamato quando viene premuto il tasto di una carattere mentre è attiva una cella. |
| OnKeyPress(KeyPressEventArgs, Int32) |
Chiamato quando viene premuto un tasto mentre è attiva una cella. (Ereditato da DataGridViewCell) |
| OnKeyUp(KeyEventArgs, Int32) |
Chiamato quando viene rilasciato il tasto di un carattere mentre è attiva una cella. |
| OnLeave(Int32, Boolean) |
Chiamato quando lo stato attivo viene spostato da una cella. |
| OnMouseClick(DataGridViewCellMouseEventArgs) |
Chiamato quando un utente fa clic con un pulsante del mouse con il puntatore posizionato in una cella. (Ereditato da DataGridViewCell) |
| OnMouseDoubleClick(DataGridViewCellMouseEventArgs) |
Chiamato quando un utente fa doppio clic con un pulsante del mouse con il puntatore posizionato in una cella. (Ereditato da DataGridViewCell) |
| OnMouseDown(DataGridViewCellMouseEventArgs) |
Viene chiamato quando si tiene premuto il pulsante del mouse mentre il puntatore è posizionato in una cella. |
| OnMouseEnter(Int32) |
Chiamato quando il puntatore del mouse viene spostato su una cella. (Ereditato da DataGridViewCell) |
| OnMouseLeave(Int32) |
Viene chiamato quando il puntatore del mouse viene spostato da una cella. |
| OnMouseMove(DataGridViewCellMouseEventArgs) |
Chiamato quando il puntatore del mouse viene spostato all'interno di una cella. |
| OnMouseUp(DataGridViewCellMouseEventArgs) |
Viene chiamato quando il pulsante del mouse viene rilasciato mentre il puntatore è posizionato in una cella. |
| Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts) |
Disegna l'oggetto DataGridViewCheckBoxCell corrente. |
| PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle) |
Disegna il bordo dell'oggetto DataGridViewCell corrente. (Ereditato da DataGridViewCell) |
| PaintErrorIcon(Graphics, Rectangle, Rectangle, String) |
Disegna l'icona di errore della classe DataGridViewCell corrente. (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 contenuto da una cella nel controllo DataGridView. (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 stringa della cella. |
