DataGridViewCheckBoxColumn Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewCheckBoxColumn.cs

Hostuje kolekci DataGridViewCheckBoxCell objektů.

public ref 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")>]
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn

Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn

Dědičnost

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewCheckBoxColumn

Atributy

ToolboxBitmapAttribute

Příklady

Následující příklad kódu ukazuje, jak použít k DataGridViewCheckBoxColumn označení, kteří zaměstnanci jsou mimo kancelář. Tento příklad je součástí většího příkladu, který je k dispozici v tématu přehledu DataGridViewComboBoxColumn třídy.

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

Poznámky

Třída DataGridViewCheckBoxColumn je specializovaný typ DataGridViewColumn třídy sloužící k logickému hostování buněk, které označují binární stav. A DataGridViewCheckBoxColumn má v každém DataGridViewRow přidruženéhoDataGridViewCheckBoxCell, který ho protíná. Každá buňka poskytuje uživatelské rozhraní podobné ovládacímu CheckBox prvku.

Výchozí režim řazení pro tento typ sloupce je NotSortable.

Hodnoty buněk zaškrtávacích políček jsou obvykle určeny buď pro úložiště, stejně jako jakákoli jiná data, nebo pro provádění hromadných operací. Pokud chcete reagovat okamžitě, když uživatel klikne na buňku zaškrtávacího políčka, můžete událost zpracovat DataGridView.CellContentClick , ale k této události dojde před aktualizací hodnoty buňky. Pokud potřebujete novou hodnotu v okamžiku kliknutí, jednou z možností je vypočítat, jaká očekávaná hodnota bude založená na aktuální hodnotě. Dalším přístupem je okamžité potvrzení změny a zpracování DataGridView.CellValueChanged události, aby na ni reagovala. Chcete-li potvrdit změnu po kliknutí na buňku DataGridView.CurrentCellDirtyStateChanged , je nutné zpracovat událost. Pokud je aktuální buňka zaškrtávací políčko v obslužné rutině, zavolejte metodu DataGridView.CommitEdit a předejte Commit hodnotu.

Poznámky pro dědice

Když odvozujete a DataGridViewCheckBoxColumn přidáte nové vlastnosti do odvozené třídy, nezapomeňte přepsat metodu Clone() pro zkopírování nových vlastností během operací klonování. Měli byste také volat metodu základní třídy Clone() , aby se vlastnosti základní třídy zkopírovaly do nové buňky.

Konstruktory

DataGridViewCheckBoxColumn()	Inicializuje novou instanci DataGridViewCheckBoxColumn třídy do výchozího stavu.
DataGridViewCheckBoxColumn(Boolean)	Inicializuje novou instanci objektu DataGridViewCheckBoxColumn a nakonfiguruje ji tak, aby zobrazovala zaškrtávací políčka se dvěma nebo třemi stavy.

Vlastnosti

AutoSizeMode	Získá nebo nastaví režim, podle kterého sloupec automaticky upraví šířku. (Zděděno od DataGridViewColumn)
CellTemplate	Získá nebo nastaví šablonu použitou k vytvoření nových buněk.
CellType	Získá typ za běhu šablony buňky. (Zděděno od DataGridViewColumn)
ContextMenuStrip	Získá nebo nastaví místní nabídku pro sloupec. (Zděděno od DataGridViewColumn)
DataGridView	DataGridView Získá ovládací prvek přidružený k tomuto prvku. (Zděděno od DataGridViewElement)
DataPropertyName	Získá nebo nastaví název vlastnosti zdroje dat nebo sloupec databáze, ke kterému DataGridViewColumn je vázán. (Zděděno od DataGridViewColumn)
DefaultCellStyle	Získá nebo nastaví výchozí styl buňky sloupce.
DefaultHeaderCellType	Získá nebo nastaví typ za běhu výchozí buňky záhlaví. (Zděděno od DataGridViewBand)
Displayed	Získá hodnotu označující, zda pás je aktuálně zobrazen na obrazovce. (Zděděno od DataGridViewBand)
DisplayIndex	Získá nebo nastaví pořadí zobrazení sloupce vzhledem k aktuálně zobrazené sloupce. (Zděděno od DataGridViewColumn)
DividerWidth	Získá nebo nastaví šířku oddělovače sloupců v pixelech. (Zděděno od DataGridViewColumn)
FalseValue	Získá nebo nastaví podkladovou hodnotu odpovídající hodnotě falsebuňky , která se zobrazí jako nezaškrtnuté pole.
FillWeight	Získá nebo nastaví hodnotu, která představuje šířku sloupce, pokud je v režimu vyplnění vzhledem k šířce jiných sloupců v režimu vyplnění v ovládacím prvku. (Zděděno od DataGridViewColumn)
FlatStyle	Získá nebo nastaví vzhled plochého stylu buněk zaškrtávacích políček.
Frozen	Získá nebo nastaví hodnotu označující, zda se sloupec přesune, když uživatel posune DataGridView ovládací prvek vodorovně. (Zděděno od DataGridViewColumn)
HasDefaultCellStyle	Získá hodnotu označující, zda DefaultCellStyle byla nastavena vlastnost. (Zděděno od DataGridViewBand)
HeaderCell	Získá nebo nastaví , DataGridViewColumnHeaderCell který představuje záhlaví sloupce. (Zděděno od DataGridViewColumn)
HeaderCellCore	Získá nebo nastaví buňku záhlaví objektu DataGridViewBand. (Zděděno od DataGridViewBand)
HeaderText	Získá nebo nastaví popis text v buňce záhlaví sloupce. (Zděděno od DataGridViewColumn)
IndeterminateValue	Získá nebo nastaví podkladovou hodnotu odpovídající neurčité hodnotě buňky null , která se zobrazí jako zakázané zaškrtávací políčko.
Index	Získá relativní pozici pásma v rámci DataGridView ovládacího prvku. (Zděděno od DataGridViewBand)
InheritedAutoSizeMode	Získá režim změny velikosti v účinku pro sloupec. (Zděděno od DataGridViewColumn)
InheritedStyle	Získá styl buňky aktuálně použitý ve sloupci. (Zděděno od DataGridViewColumn)
IsDataBound	Získá hodnotu označující, zda je sloupec vázán na zdroj dat. (Zděděno od DataGridViewColumn)
IsRow	Získá hodnotu označující, zda pásmo představuje řádek. (Zděděno od DataGridViewBand)
MinimumWidth	Získá nebo nastaví minimální šířku sloupce v pixelech. (Zděděno od DataGridViewColumn)
Name	Získá nebo nastaví název sloupce. (Zděděno od DataGridViewColumn)
ReadOnly	Získá nebo nastaví hodnotu označující, zda uživatel může upravit buňky sloupce. (Zděděno od DataGridViewColumn)
Resizable	Získá nebo nastaví hodnotu označující, zda je sloupec měnit velikost. (Zděděno od DataGridViewColumn)
Selected	Získá nebo nastaví hodnotu označující, zda je pásmo ve vybraném uživatelském rozhraní (UI) stavu. (Zděděno od DataGridViewBand)
Site	Získá nebo nastaví web sloupce. (Zděděno od DataGridViewColumn)
SortMode	Získá nebo nastaví režim řazení pro sloupec. (Zděděno od DataGridViewColumn)
State	Získá uživatelské rozhraní (UI) stav elementu. (Zděděno od DataGridViewElement)
Tag	Získá nebo nastaví objekt, který obsahuje data, která chcete přidružit k pásu. (Zděděno od DataGridViewBand)
ThreeState	Získá nebo nastaví hodnotu označující, zda hostované buňky zaškrtávacího políčka umožní tři stavy zaškrtnutí místo dvou.
ToolTipText	Získá nebo nastaví text použitý pro popisy tlačítek. (Zděděno od DataGridViewColumn)
TrueValue	Získá nebo nastaví podkladovou hodnotu odpovídající hodnotě truebuňky , která se zobrazí jako zaškrtávací políčko.
ValueType	Získá nebo nastaví datový typ hodnot v buňkách sloupce. (Zděděno od DataGridViewColumn)
Visible	Získá nebo nastaví hodnotu označující, zda je sloupec viditelný. (Zděděno od DataGridViewColumn)
Width	Získá nebo nastaví aktuální šířku sloupce. (Zděděno od DataGridViewColumn)

Metody

Clone()	Vytvoří přesnou kopii tohoto pásma. (Zděděno od DataGridViewColumn)
Dispose()	Uvolní všechny prostředky používané nástrojem DataGridViewBand. (Zděděno od DataGridViewBand)
Dispose(Boolean)	Uvolní nespravované prostředky používané nástrojem DataGridViewBand a volitelně uvolní spravované prostředky. (Zděděno od DataGridViewColumn)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Vypočítá ideální šířku sloupce na základě zadaných kritérií. (Zděděno od DataGridViewColumn)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnDataGridViewChanged()	Volá se, když je skupina přidružená k jinému DataGridView. (Zděděno od DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)	CellClick Vyvolá událost. (Zděděno od DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	CellContentClick Vyvolá událost. (Zděděno od DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	CellContentDoubleClick Vyvolá událost. (Zděděno od DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	CellValueChanged Vyvolá událost. (Zděděno od DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	DataError Vyvolá událost. (Zděděno od DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	MouseWheel Vyvolá událost. (Zděděno od DataGridViewElement)
ToString()	Získá řetězec, který popisuje sloupec.

Událost

Disposed

Vyvolá se při DataGridViewColumn odstranění. (Zděděno od DataGridViewColumn)

Viz také

• DataGridView
• DataGridViewColumn
• DataGridViewRow
• DataGridViewCheckBoxCell
• CheckBox
• SortMode
• CellClick
• CellValueChanged
• CurrentCellDirtyStateChanged
• CommitEdit(DataGridViewDataErrorContexts)