Condividi tramite


DataGridViewCheckBoxColumn Classe

Definizione

Contiene un insieme di oggetti 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
Ereditarietà
Attributi

Esempio

Nell'esempio di codice seguente viene illustrato come usare un DataGridViewCheckBoxColumn oggetto per contrassegnare i dipendenti che si trovano all'esterno dell'ufficio. 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 DataGridViewCheckBoxColumn classe è un tipo specializzato della DataGridViewColumn classe usata per ospitare logicamente le celle che indicano lo stato binario. Un oggetto DataGridViewCheckBoxColumn ha un oggetto associato DataGridViewCheckBoxCell in ogni DataGridViewRow oggetto che lo interseca. Ogni cella fornisce un'interfaccia utente simile a un CheckBox controllo.

La modalità di ordinamento predefinita per questo tipo di colonna è NotSortable.

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.CellContentClick 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 DataGridViewCheckBoxColumn 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

DataGridViewCheckBoxColumn()

Inizializza una nuova istanza della classe DataGridViewCheckBoxColumn in base allo stato predefinito.

DataGridViewCheckBoxColumn(Boolean)

Inizializza una nuova istanza della classe DataGridViewCheckBoxColumn e la configura per la visualizzazione delle caselle di controllo con due o tre stati.

Proprietà

AutoSizeMode

Ottiene o imposta la modalità usata per la regolazione automatica della larghezza della colonna.

(Ereditato da DataGridViewColumn)
CellTemplate

Ottiene o imposta il modello usato per la creazione di nuove celle.

CellType

Ottiene il tipo di runtime del modello di cella.

(Ereditato da DataGridViewColumn)
ContextMenuStrip

Ottiene o imposta il menu di scelta rapida per la colonna.

(Ereditato da DataGridViewColumn)
DataGridView

Ottiene il controllo DataGridView associato a questo elemento.

(Ereditato da DataGridViewElement)
DataPropertyName

Ottiene o imposta il nome della proprietà dell'origine dati o della colonna del database a cui è associato l'oggetto DataGridViewColumn.

(Ereditato da DataGridViewColumn)
DefaultCellStyle

Ottiene o imposta lo stile predefinito per le celle della colonna.

DefaultHeaderCellType

Ottiene o imposta il tipo in fase di esecuzione della cella di intestazione predefinita.

(Ereditato da DataGridViewBand)
Displayed

Ottiene un valore che indica se la banda è attualmente visualizzata sullo schermo.

(Ereditato da DataGridViewBand)
DisplayIndex

Ottiene o imposta l'ordine di visualizzazione della colonna relativa alle colonne attualmente visualizzate.

(Ereditato da DataGridViewColumn)
DividerWidth

Ottiene o imposta la larghezza, in pixel, del divisore di colonne.

(Ereditato da DataGridViewColumn)
FalseValue

Ottiene o imposta il valore sottostante corrispondente al valore false, che viene indicato con una casella di controllo non selezionata.

FillWeight

Ottiene o imposta un valore che rappresenta la larghezza della colonna in modalità di riempimento relativamente alle larghezze di altre colonne in modalità di riempimento presenti nel controllo.

(Ereditato da DataGridViewColumn)
FlatStyle

Ottiene o imposta l'aspetto bidimensionale delle celle con caselle di controllo.

Frozen

Ottiene o imposta un valore che indica se una colonna si sposterà quando l'utente scorre orizzontalmente il controllo DataGridView.

(Ereditato da DataGridViewColumn)
HasDefaultCellStyle

Ottiene un valore che indica se la proprietà DefaultCellStyle è stata impostata.

(Ereditato da DataGridViewBand)
HeaderCell

Ottiene o imposta l'oggetto DataGridViewColumnHeaderCell che rappresenta l'intestazione della colonna.

(Ereditato da DataGridViewColumn)
HeaderCellCore

Ottiene o imposta la cella di intestazione dell'oggetto DataGridViewBand.

(Ereditato da DataGridViewBand)
HeaderText

Ottiene o imposta il testo del titolo sulla cella di intestazione della colonna.

(Ereditato da DataGridViewColumn)
IndeterminateValue

Ottiene o imposta il valore sottostante corrispondente a un valore indeterminato o null, che viene indicato con una casella di controllo disabilitata.

Index

Ottiene la posizione relativa della banda all'interno del controllo DataGridView.

(Ereditato da DataGridViewBand)
InheritedAutoSizeMode

Ottiene la modalità di dimensionamento attiva per la riga.

(Ereditato da DataGridViewColumn)
InheritedStyle

Ottiene lo stile della cella attualmente applicato alla colonna.

(Ereditato da DataGridViewColumn)
IsDataBound

Ottiene un valore che indica se la colonna è associata a un'origine dati.

(Ereditato da DataGridViewColumn)
IsRow

Ottiene un valore che indica se la banda rappresenta una riga.

(Ereditato da DataGridViewBand)
MinimumWidth

Ottiene o imposta la larghezza minima, in pixel, della colonna.

(Ereditato da DataGridViewColumn)
Name

Ottiene o imposta il nome della colonna.

(Ereditato da DataGridViewColumn)
ReadOnly

Ottiene o imposta un valore che indica se l'utente può modificare le celle della colonna.

(Ereditato da DataGridViewColumn)
Resizable

Ottiene o imposta un valore che indica se la colonna è ridimensionabile.

(Ereditato da DataGridViewColumn)
Selected

Ottiene o imposta un valore che indica se la banda è correntemente selezionata nell'interfaccia utente.

(Ereditato da DataGridViewBand)
Site

Ottiene o imposta il sito della colonna.

(Ereditato da DataGridViewColumn)
SortMode

Ottiene o imposta la modalità di ordinamento della colonna.

(Ereditato da DataGridViewColumn)
State

Ottiene lo stato dell'interfaccia utente dell'elemento.

(Ereditato da DataGridViewElement)
Tag

Ottiene o imposta l'oggetto contenente i dati da associare alla banda.

(Ereditato da DataGridViewBand)
ThreeState

Ottiene o imposta un valore che indica se le celle con caselle di controllo contenute consentiranno tre stati di selezione anziché due.

ToolTipText

Ottiene o imposta il testo usato per la descrizione comandi.

(Ereditato da DataGridViewColumn)
TrueValue

Ottiene o imposta il valore sottostante corrispondente al valore true, che viene indicato con una casella di controllo selezionata.

ValueType

Ottiene o imposta il tipo di dati dei valori delle celle della colonna.

(Ereditato da DataGridViewColumn)
Visible

Ottiene o imposta un valore che indica se la colonna è visibile.

(Ereditato da DataGridViewColumn)
Width

Ottiene o imposta la larghezza corrente della colonna.

(Ereditato da DataGridViewColumn)

Metodi

Clone()

Crea una copia esatta della banda.

(Ereditato da DataGridViewColumn)
Dispose()

Rilascia tutte le risorse usate da DataGridViewBand.

(Ereditato da DataGridViewBand)
Dispose(Boolean)

Rilascia le risorse non gestite usate da DataGridViewBand e, facoltativamente, le risorse gestite.

(Ereditato da DataGridViewColumn)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

Calcola la larghezza ideale della colonna in base ai criteri specificati.

(Ereditato da DataGridViewColumn)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
OnDataGridViewChanged()

Viene chiamato quando la banda è associata a un oggetto DataGridView differente.

(Ereditato da DataGridViewBand)
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)
ToString()

Ottiene una stringa che descrive la colonna.

Eventi

Disposed

Si verifica quando viene eliminato l'oggetto DataGridViewColumn.

(Ereditato da DataGridViewColumn)

Si applica a

Vedi anche