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 DataGridViewCheckBoxColumn k označení zaměstnanců mimo kancelář. Tento příklad je součástí většího příkladu dostupného 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á přidruženou každouDataGridViewCheckBoxCell, DataGridViewRow která ji protíná. Každá buňka poskytuje uživatelské rozhraní, které je podobné ovládacímu CheckBox prvku.

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

Hodnoty buněk zaškrtávacího políčka jsou obvykle určeny buď pro úložiště, podobně jako jiná data, nebo pro provádění hromadných operací. Pokud chcete reagovat okamžitě, když uživatelé kliknou na buňku zaškrtávacího políčka, můžete zpracovat událost DataGridView.CellContentClick, ale k této události dochází 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žena na aktuální hodnotě. Dalším přístupem je okamžitě potvrdit změnu a zpracovat událost DataGridView.CellValueChanged, aby na ni bylo možné reagovat. Musíte zpracovat událost DataGridView.CurrentCellDirtyStateChanged, chcete-li potvrdit změnu po kliknutí na buňku. V obslužné rutině, pokud je aktuální buňka buňkou zaškrtávacího políčka, zavolejte metodu DataGridView.CommitEdit a předejte hodnotu Commit.

Poznámky pro dědice

Při odvozené DataGridViewCheckBoxColumn třídě a přidání nových vlastností do odvozené třídy nezapomeňte přepsat metodu Clone() kopírování nových vlastností během operací klonování. Měli byste také volat metodu základní třídy Clone() tak, aby vlastnosti základní třídy byly zkopírovány do nové buňky.

Konstruktory

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

Vlastnosti

Name	Description
AutoSizeMode	Získá nebo nastaví režim, podle kterého sloupec automaticky upraví jeho šíř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 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	Získá ovládací prvek DataGridView přidružený k tomuto prvku. (Zděděno od DataGridViewElement)
DataPropertyName	Získá nebo nastaví název vlastnosti zdroje dat nebo databázového sloupce, 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 běhu výchozí buňky záhlaví. (Zděděno od DataGridViewBand)
Displayed	Získá hodnotu určující, zda je pásma aktuálně zobrazena na obrazovce. (Zděděno od DataGridViewBand)
DisplayIndex	Získá nebo nastaví pořadí zobrazení sloupce vzhledem k aktuálně zobrazeným sloupcům. (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, když je v režimu výplně vzhledem k šířce jiných sloupců režimu výplně v ovládacím prvku. (Zděděno od DataGridViewColumn)
FlatStyle	Získá nebo nastaví vzhled plochého stylu buněk zaškrtávacího políčka.
Frozen	Získá nebo nastaví hodnotu určující, zda sloupec se přesune, když uživatel posune DataGridView ovládací prvek vodorovně. (Zděděno od DataGridViewColumn)
HasDefaultCellStyle	Získá hodnotu určující, zda DefaultCellStyle byla vlastnost nastavena. (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 DataGridViewBandzáhlaví . (Zděděno od DataGridViewBand)
HeaderText	Získá nebo nastaví text titulku v buňce záhlaví sloupce. (Zděděno od DataGridViewColumn)
IndeterminateValue	Získá nebo nastaví podkladovou hodnotu odpovídající neurčité hodnotě nebo null buňce, která se zobrazí jako zakázané zaškrtávací políčko.
Index	Získá relativní pozici pásma uvnitř DataGridView ovládacího prvku. (Zděděno od DataGridViewBand)
InheritedAutoSizeMode	Získá režim nastavení velikosti pro sloupec. (Zděděno od DataGridViewColumn)
InheritedStyle	Získá styl buňky aktuálně použitý pro sloupec. (Zděděno od DataGridViewColumn)
IsDataBound	Získá hodnotu určující, zda sloupec je vázán na zdroj dat. (Zděděno od DataGridViewColumn)
IsRow	Získá hodnotu určující, zda pruh 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 urč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 možné měnit velikost. (Zděděno od DataGridViewColumn)
Selected	Získá nebo nastaví hodnotu určující, zda pásmo je ve vybraném stavu uživatelského rozhraní (UI). (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á stav uživatelského rozhraní prvku. (Zděděno od DataGridViewElement)
Tag	Získá nebo nastaví objekt, který obsahuje data pro přidružení k pásmu. (Zděděno od DataGridViewBand)
ThreeState	Získá nebo nastaví hodnotu určující, zda hostované buňky zaškrtávacího políčka budou umožňovat tři stavy zaškrtnutí namísto dvou.
ToolTipText	Získá nebo nastaví text použitý pro popisy. (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

Name	Description
Clone()	Vytvoří přesnou kopii této skupiny. (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é DataGridViewBand a volitelně uvolní spravované prostředky. (Zděděno od DataGridViewColumn)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Vypočítá ideální šířku sloupce na základě zadaných kritérií. (Zděděno od DataGridViewColumn)
OnDataGridViewChanged()	Volá se, když je skupina přidružena 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

Name	Description
Disposed	Nastane, když je DataGridViewColumn uvolněna. (Zděděno od DataGridViewColumn)

Viz také

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