DataGridViewCheckBoxCell Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zobrazí uživatelské rozhraní zaškrtávacího políčka, které se má použít v ovládacím DataGridView prvku.

public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCell

public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell

type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell

Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell

Dědičnost

Object

DataGridViewElement

DataGridViewCell

DataGridViewCheckBoxCell

Implementuje

IDataGridViewEditingCell

Příklady

Následující příklad kódu používá ke DataGridViewCheckBoxColumn sledování, kteří zaměstnanci jsou v kanceláři. Sloupec se skládá z DataGridViewCheckBoxCell objektů. Tento příklad je součástí většího příkladu, který je k dispozici v tématu s přehledem 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 DataGridViewCheckBoxCell je specializovaný typ, který DataGridViewCell se používá k zobrazení binárních nebo ternárních informací prezentovaných prostřednictvím uživatelského rozhraní zaškrtávacího políčka. Ve výchozím binárním režimu můžou buňky obsahovat hodnoty nebo truefalse. V ternárním režimu buňky přebírají jednu z CheckState hodnot. Vlastnost ThreeState určuje, zda je binární nebo ternární režim v platnosti.

Jedná se DataGridViewCheckBoxColumn o typ sloupce, který se specializuje na uložení buněk tohoto typu. Ve výchozím nastavení DataGridViewCheckBoxColumn.CellTemplate se inicializuje na nový DataGridViewCheckBoxCell. Pokud chcete vytvořit vzor buněk ve sloupci za existujícím DataGridViewCheckBoxCellobjektem , nastavte vlastnost sloupce CellTemplate na buňku tak, aby se použila jako vzor.

Vlastnosti sloupce související s buňkou jsou obálky pro podobně pojmenované vlastnosti buňky šablony. Změna hodnot vlastností buňky šablony ovlivní pouze buňky založené na šabloně, které jsou přidány po změně. Změna hodnot vlastností souvisejících s buňkami sloupce však aktualizuje buňku šablony a všechny ostatní buňky ve sloupci a v případě potřeby aktualizuje zobrazení sloupce.

Pokud je DataGridViewCheckBoxCellaktuální buňka , DataGridView.IsCurrentCellInEditMode vlastnost je vždy true.

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 odpovědět okamžitě, když uživatelé kliknou na buňku zaškrtávacího políčka, můžete událost zpracovat DataGridView.CellClick , ale tato událost nastane 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ě potvrdit změnu a zpracovat DataGridView.CellValueChanged událost, 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 v obslužné rutině buňkou zaškrtávacího políčka, zavolejte metodu DataGridView.CommitEdit a předejte Commit hodnotu.

Poznámky pro dědice

Když odvozujete a DataGridViewCheckBoxCell přidáte nové vlastnosti 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() , aby vlastnosti základní třídy byly zkopírovány do nové buňky.

Konstruktory

DataGridViewCheckBoxCell()	Inicializuje novou instanci třídy do výchozího DataGridViewCheckBoxCell stavu.
DataGridViewCheckBoxCell(Boolean)	Inicializuje novou instanci třídy povolení binárního DataGridViewCheckBoxCell nebo ternárního stavu.

Vlastnosti

AccessibilityObject	Získá přiřazený DataGridViewCell.DataGridViewCellAccessibleObject k DataGridViewCell. (Zděděno od DataGridViewCell)
ColumnIndex	Získá index sloupce pro tuto buňku. (Zděděno od DataGridViewCell)
ContentBounds	Získá ohraničující obdélník, který obklopuje oblast obsahu buňky. (Zděděno od DataGridViewCell)
ContextMenuStrip	Získá nebo nastaví místní nabídku přidruženou k buňce. (Zděděno od DataGridViewCell)
DataGridView	Získá ovládací prvek DataGridView přidružený k tomuto prvku. (Zděděno od DataGridViewElement)
DefaultNewRowValue	Získá výchozí hodnotu buňky v řádku pro nové záznamy. (Zděděno od DataGridViewCell)
Displayed	Získá hodnotu, která označuje, zda je buňka aktuálně zobrazena na obrazovce. (Zděděno od DataGridViewCell)
EditedFormattedValue	Získá aktuální formátovanou hodnotu buňky bez ohledu na to, zda je buňka v režimu úprav a hodnota nebyla potvrzena. (Zděděno od DataGridViewCell)
EditingCellFormattedValue	Získá nebo nastaví formátovanou hodnotu ovládacího prvku hostovaného buňkou, když je v režimu úprav.
EditingCellValueChanged	Získá nebo nastaví příznak označující, že hodnota byla změněna pro tuto buňku.
EditType	Získá typ hostovaného ovládacího prvku pro úpravy buňky.
ErrorIconBounds	Získá hranice ikony chyby pro buňku. (Zděděno od DataGridViewCell)
ErrorText	Získá nebo nastaví text popisující chybovou podmínku přidruženou k buňce. (Zděděno od DataGridViewCell)
FalseValue	Získá nebo nastaví podkladovou hodnotu odpovídající hodnotě buňky .false
FlatStyle	Získá nebo nastaví vzhled plochého stylu zaškrtávacího políčka uživatelské rozhraní (UI).
FormattedValue	Získá hodnotu buňky formátované pro zobrazení. (Zděděno od DataGridViewCell)
FormattedValueType	Získá typ hodnoty zobrazení buňky.
Frozen	Získá hodnotu označující, zda je buňka zmrazena. (Zděděno od DataGridViewCell)
HasStyle	Získá hodnotu označující, zda Style byla nastavena vlastnost. (Zděděno od DataGridViewCell)
IndeterminateValue	Získá nebo nastaví základní hodnotu odpovídající neurčité nebo null hodnotě buňky.
InheritedState	Získá aktuální stav buňky jako zděděný ze stavu jejího řádku a sloupce. (Zděděno od DataGridViewCell)
InheritedStyle	Získá styl, který se aktuálně používá v buňce. (Zděděno od DataGridViewCell)
IsInEditMode	Získá hodnotu označující, zda je tato buňka právě upravována. (Zděděno od DataGridViewCell)
OwningColumn	Získá sloupec, který obsahuje tuto buňku. (Zděděno od DataGridViewCell)
OwningRow	Získá řádek, který obsahuje tuto buňku. (Zděděno od DataGridViewCell)
PreferredSize	Získá velikost obdélníkové oblasti v pixelech, do které se buňka vejde. (Zděděno od DataGridViewCell)
ReadOnly	Získá nebo nastaví hodnotu označující, zda lze upravit data buňky. (Zděděno od DataGridViewCell)
Resizable	Získá hodnotu označující, zda lze změnit velikost buňky. (Zděděno od DataGridViewCell)
RowIndex	Získá index nadřazeného řádku buňky. (Zděděno od DataGridViewCell)
Selected	Získá nebo nastaví hodnotu označující, zda byla buňka vybrána. (Zděděno od DataGridViewCell)
Size	Získá velikost buňky. (Zděděno od DataGridViewCell)
State	Získá stav uživatelského rozhraní (UI) elementu. (Zděděno od DataGridViewElement)
Style	Získá nebo nastaví styl buňky. (Zděděno od DataGridViewCell)
Tag	Získá nebo nastaví objekt, který obsahuje doplňující data o buňce. (Zděděno od DataGridViewCell)
ThreeState	Získá nebo nastaví hodnotu označující, zda byl povolen ternární režim pro ovládací prvek hostovaného zaškrtávacího políčka.
ToolTipText	Získá nebo nastaví popis textu přidružené k této buňce. (Zděděno od DataGridViewCell)
TrueValue	Získá nebo nastaví podkladovou hodnotu odpovídající hodnotě buňky .true
Value	Získá nebo nastaví hodnotu přidruženou k této buňce. (Zděděno od DataGridViewCell)
ValueType	Získá datový typ hodnot v buňce.
Visible	Získá hodnotu označující, zda je buňka v řádku nebo sloupci, který byl skrytý. (Zděděno od DataGridViewCell)

Metody

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Upraví styl ohraničení vstupní buňky podle zadaných kritérií. (Zděděno od DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Vrátí hodnotu Rectangle , která představuje šířku všech okrajů buňky. (Zděděno od DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky po kliknutí na buňku nesdílí. (Zděděno od DataGridViewCell)
Clone()	Vytvoří přesnou kopii této buňky.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek obsahující buňku při kliknutí na obsah buňky nesdílí.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, zda řádek obsahující buňku bude po poklikání na obsah buňky zrušen.
CreateAccessibilityInstance()	Vytvoří nový přístupný objekt pro DataGridViewCheckBoxCellobjekt .
DetachEditingControl()	Odebere ovládací prvek pro úpravy buňky z objektu DataGridView. (Zděděno od DataGridViewCell)
Dispose()	Uvolní všechny prostředky používané nástrojem DataGridViewCell. (Zděděno od DataGridViewCell)
Dispose(Boolean)	Uvolní nespravované prostředky používané DataGridViewCell nástrojem a volitelně uvolní spravované prostředky. (Zděděno od DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při poklikání na buňku nesdílí. (Zděděno od DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Určuje, jestli se nadřazený řádek nesdílí, když se fokus přesune na buňku. (Zděděno od DataGridViewCell)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Načte formátovanou hodnotu buňky, která se má zkopírovat do Clipboard. (Zděděno od DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Vrátí ohraničující obdélník, který obklopuje oblast obsahu buňky, která se vypočítá pomocí zadaného Graphics stylu a buňky.
GetContentBounds(Int32)	Vrátí ohraničující obdélník, který ohraničuje oblast obsahu buňky pomocí výchozího Graphics stylu a stylu buňky, který je aktuálně platný pro buňku. (Zděděno od DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Vrátí aktuální formátovanou hodnotu buňky bez ohledu na to, zda je buňka v režimu úprav a hodnota nebyla potvrzena. (Zděděno od DataGridViewCell)
GetEditingCellFormattedValue(DataGridViewDataErrorContexts)	Získá formátovanou hodnotu buňky, když je v režimu úprav.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Vrátí ohraničující obdélník, který ohraničuje ikonu chyby buňky, pokud se zobrazí.
GetErrorText(Int32)	Vrátí řetězec, který představuje chybu buňky. (Zděděno od DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Získá formátovanou hodnotu dat buňky.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetInheritedContextMenuStrip(Int32)	Získá zděděnou místní nabídku pro aktuální buňku. (Zděděno od DataGridViewCell)
GetInheritedState(Int32)	Vrátí hodnotu označující aktuální stav buňky zděděné ze stavu jejího řádku a sloupce. (Zděděno od DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Získá styl použitý na buňku. (Zděděno od DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Vypočítá upřednostňovanou velikost buňky v pixelech.
GetSize(Int32)	Získá velikost buňky. (Zděděno od DataGridViewCell)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetValue(Int32)	Získá hodnotu buňky. (Zděděno od DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Inicializuje ovládací prvek použitý k úpravě buňky. (Zděděno od DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Určuje, jestli se řádek obsahující buňku nesdílí, když je stisknuta klávesa, zatímco je buňka fokus.
KeyEntersEditMode(KeyEventArgs)	Určuje, jestli má být režim úprav spuštěn na základě daného klíče. (Zděděno od DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Určuje, jestli se řádek nesdílí, pokud je stisknuta klávesa a buňka na řádku má fokus. (Zděděno od DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Určuje, zda řádek obsahující buňku není sdílen při uvolnění klíče, zatímco buňka má fokus.
LeaveUnsharesRow(Int32, Boolean)	Určuje, jestli se řádek nesdílí, když fokus opustí buňku v řádku. (Zděděno od DataGridViewCell)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, když uživatel klikne na tlačítko myši, zatímco je ukazatel na buňce v řádku. (Zděděno od DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, pokud uživatel poklikne na buňku v řádku. (Zděděno od DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, zda řádek obsahující buňku bude po stisknutí tlačítka myši, když je ukazatel nad buňkou, nesdílený.
MouseEnterUnsharesRow(Int32)	Určuje, jestli řádek obsahující buňku nebude sdílen, když se ukazatel myši přesune na buňku.
MouseLeaveUnsharesRow(Int32)	Určuje, jestli řádek obsahující buňku nebude sdílen, když ukazatel myši opustí buňku.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, když se ukazatel myši přesune na buňku v řádku. (Zděděno od DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, zda řádek obsahující buňku bude po uvolnění tlačítka myši, když je ukazatel nad buňkou, nesdílet.
OnClick(DataGridViewCellEventArgs)	Volá se při kliknutí na buňku. (Zděděno od DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Volá se při kliknutí na obsah buňky.
OnContentDoubleClick(DataGridViewCellEventArgs)	Volá se při poklikání na obsah buňky.
OnDataGridViewChanged()	Volá se, když se DataGridView změní vlastnost buňky. (Zděděno od DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Volá se při poklikání na buňku. (Zděděno od DataGridViewCell)
OnEnter(Int32, Boolean)	Volá se, když se fokus přesune na buňku. (Zděděno od DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Volá se při stisknutí znakové klávesy, když je fokus na buňce.
OnKeyPress(KeyPressEventArgs, Int32)	Volá se při stisknutí klávesy, když je fokus na buňce. (Zděděno od DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Volá se při uvolnění znakové klávesy, když je fokus na buňce.
OnLeave(Int32, Boolean)	Volá se, když se fokus přesune z buňky.
OnMouseClick(DataGridViewCellMouseEventArgs)	Volá se, když uživatel klikne na tlačítko myši, když je ukazatel myši na buňce. (Zděděno od DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Volá se, když uživatel poklikne na tlačítko myši, když je ukazatel na buňce. (Zděděno od DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Volá se, když je tlačítko myši podržené, když je ukazatel myši na buňce.
OnMouseEnter(Int32)	Volá se, když se ukazatel myši přesune na buňku. (Zděděno od DataGridViewCell)
OnMouseLeave(Int32)	Volá se, když se ukazatel myši přesune z buňky.
OnMouseMove(DataGridViewCellMouseEventArgs)	Volá se, když se ukazatel myši pohybuje v buňce.
OnMouseUp(DataGridViewCellMouseEventArgs)	Volá se při uvolnění tlačítka myši, když je ukazatel myši na buňce.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Vykreslí aktuální DataGridViewCheckBoxCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Vykreslí ohraničení aktuálního DataGridViewCell. (Zděděno od DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Vykreslí ikonu chyby aktuálního DataGridViewCellsouboru . (Zděděno od DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Převede hodnotu formátovanou pro zobrazení na skutečnou hodnotu buňky.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Nastaví umístění a velikost ovládacího prvku pro úpravy hostovaného buňkou v ovládacím DataGridView prvku. (Zděděno od DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Nastaví umístění a velikost panelu pro úpravy hostovaného buňkou a vrátí normální hranice ovládacího prvku pro úpravy v panelu pro úpravy. (Zděděno od DataGridViewCell)
PrepareEditingCellForEdit(Boolean)	Tato metoda není pro tento typ smysluplná.
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)
SetValue(Int32, Object)	Nastaví hodnotu buňky. (Zděděno od DataGridViewCell)
ToString()	Vrátí řetězcovou reprezentaci buňky.

Viz také

• DataGridView
• DataGridViewCell
• DataGridViewCheckBoxColumn
• CellTemplate