Sdílet prostřednictvím


DataGridViewCheckBoxColumn Třída

Definice

Hostuje kolekci DataGridViewCheckBoxCell objektů.

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
Dědičnost
Atributy

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)

Platí pro

Viz také