DataGridViewCheckBoxCell Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewCheckBoxCell.cs

Zobrazí uživatelské rozhraní (UI) 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

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell

Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell

Dědičnost

Object

DataGridViewElement

DataGridViewCell

DataGridViewCheckBoxCell

Atributy

DynamicallyAccessedMembersAttribute

Implementuje

IDataGridViewEditingCell

Příklady

Následující příklad kódu používá DataGridViewCheckBoxColumn ke sledování zaměstnanců v kanceláři. Sloupec se skládá z DataGridViewCheckBoxCell objektů. 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 DataGridViewCheckBoxCell je specializovaný typ, který slouží k zobrazení binárních nebo ternárních DataGridViewCell 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 mohou buňky obsahovat hodnoty true nebo false. V ternárním režimu přebírají buňky jednu z CheckState hodnot. Vlastnost ThreeState určuje, zda binární nebo ternární režim je 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 vytěsnit buňky ve sloupci za existujícím DataGridViewCheckBoxCellsloupcem, nastavte vlastnost sloupce CellTemplate na buňku tak, aby se používala 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 na základě šablony přidané po změně. Změna hodnot vlastností souvisejících s buňkou ve sloupci však aktualizuje buňku šablony a všechny ostatní buňky ve sloupci a v případě potřeby sloupec aktualizuje.

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

Hodnoty buněk zaškrtávacího políčka jsou obvykle určeny buď pro ukládání, jako jsou 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 zpracovat DataGridView.CellClick událost, 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žena na aktuální hodnotě. Dalším přístupem je okamžité potvrzení změny a zpracování DataGridView.CellValueChanged události, která na ni reaguje. Chcete-li změnu potvrdit po kliknutí na buňku DataGridView.CurrentCellDirtyStateChanged , musíte zpracovat událost. Pokud je aktuální buňka v obslužné rutině buňka zaškrtávacího políčka, zavolejte metodu DataGridView.CommitEdit a předejte Commit hodnotu.

Poznámky pro dědice

Při odvozené DataGridViewCheckBoxCell 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
DataGridViewCheckBoxCell()	Inicializuje novou instanci DataGridViewCheckBoxCell třídy do výchozího stavu.
DataGridViewCheckBoxCell(Boolean)	Inicializuje novou instanci DataGridViewCheckBoxCell třídy, která povoluje binární nebo ternární stav.

Vlastnosti

Name	Description
AccessibilityObject	DataGridViewCell.DataGridViewCellAccessibleObject Získá přiřazeno 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ý ohraničuje 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 pro buňku 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í chybový stav přidružený k buňce. (Zděděno od DataGridViewCell)
FalseValue	Získá nebo nastaví podkladovou hodnotu odpovídající hodnotě falsebuňky .
FlatStyle	Získá nebo nastaví vzhled plochého stylu uživatelského rozhraní (UI).
FormattedValue	Získá hodnotu buňky jako formát pro zobrazení. (Zděděno od DataGridViewCell)
FormattedValueType	Získá typ zobrazované hodnoty buňky.
Frozen	Získá hodnotu označující, zda je buňka zmrazena. (Zděděno od DataGridViewCell)
HasStyle	Získá hodnotu určující, zda Style byla vlastnost nastavena. (Zděděno od DataGridViewCell)
IndeterminateValue	Získá nebo nastaví podkladovou hodnotu odpovídající neurčité hodnotě nebo null buňce.
InheritedState	Získá aktuální stav buňky zděděný ze stavu jeho řádku a sloupce. (Zděděno od DataGridViewCell)
InheritedStyle	Získá styl, který je aktuálně použit pro buňku. (Zděděno od DataGridViewCell)
IsInEditMode	Získá hodnotu označující, zda se tato buňka právě upravuje. (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 vpixelch (Zděděno od DataGridViewCell)
ReadOnly	Získá nebo nastaví hodnotu určující, zda lze upravit data buňky. (Zděděno od DataGridViewCell)
Resizable	Získá hodnotu označující, zda je možné 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 je 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í prvku. (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 určující, zda ternární režim byl povolen pro hostovaný ovládací prvek zaškrtávací políčko.
ToolTipText	Získá nebo nastaví text popisu přidružený k této buňce. (Zděděno od DataGridViewCell)
TrueValue	Získá nebo nastaví podkladovou hodnotu odpovídající hodnotě truebuňky .
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

Name	Description
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 šířky všech okrajů buňky. (Zděděno od DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při 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 bude řádek obsahující buňku poklikání na obsah buňky nesdílený.
CreateAccessibilityInstance()	Vytvoří nový přístupný objekt pro objekt DataGridViewCheckBoxCell.
DetachEditingControl()	Odebere ovládací prvek pro úpravy buňky z ovládacího DataGridViewprvku . (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 a volitelně uvolní spravované prostředky. (Zděděno od DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při dvojitém kliknutí na buňku nesdílí. (Zděděno od DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Určuje, jestli se nadřazený řádek při přesunutí fokusu na buňku zruší. (Zděděno od DataGridViewCell)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Načte formátovanou hodnotu buňky, která se má zkopírovat do Clipboardbuňky . (Zděděno od DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Vrátí ohraničující obdélník, který ohraničuje oblast obsahu buňky, která se vypočítá pomocí zadaného Graphics stylu a stylu buňky.
GetContentBounds(Int32)	Vrátí ohraničující obdélník ohraničující oblast obsahu buňky pomocí výchozího Graphics stylu buňky, který je aktuálně pro buňku v platnosti. (Zděděno od DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Vrátí aktuální formátovanou hodnotu buňky bez ohledu na to, jestli 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 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.
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 řá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)
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 stisknutá klávesa, když je fokus na buňce.
KeyEntersEditMode(KeyEventArgs)	Určuje, jestli se má režim úprav spustit na základě daného klíče. (Zděděno od DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Určuje, jestli se řádek nesdílí, pokud je stisknutá klávesa, když je fokus na buňce v řádku. (Zděděno od DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Určuje, jestli se řádek obsahující buňku nesdílí, když se uvolní klíč, když je buňka fokus.
LeaveUnsharesRow(Int32, Boolean)	Určuje, jestli se řádek nesdílí, když fokus opustí buňku v řádku. (Zděděno od DataGridViewCell)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, pokud uživatel klikne na tlačítko myši, zatímco ukazatel je na buňce v řádku. (Zděděno od DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, pokud uživatel dvakrát klikne na buňku v řádku. (Zděděno od DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek obsahující buňku při stisknutí tlačítka myši zruší, když je ukazatel myši nad buňkou.
MouseEnterUnsharesRow(Int32)	Určuje, jestli se řádek obsahující buňku při přesunutí ukazatele myši přes buňku zruší.
MouseLeaveUnsharesRow(Int32)	Určuje, jestli se řádek obsahující buňku nesdílí, když ukazatel myši opustí buňku.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nebude sdílet, když se ukazatel myši přesune na buňku v řádku. (Zděděno od DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek obsahující buňku při uvolnění tlačítka myši zruší, když je ukazatel nad buňkou.
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, když je obsah buňky poklikaný.
OnDataGridViewChanged()	Volá se při DataGridView změně vlastnosti 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 do buňky. (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ého klíče, 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 na buňce. (Zděděno od DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Volá se, když uživatel dvakrát klikne 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ží, když je ukazatel na buňce.
OnMouseEnter(Int32)	Volá se, když se ukazatel myši přesune přes 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 přesune v buňce.
OnMouseUp(DataGridViewCellMouseEventArgs)	Volá se, když je tlačítko myši uvolněno, když je ukazatel na buňce.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Maluje aktuální DataGridViewCheckBoxCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Nakreslí okraj aktuálního DataGridViewCell. (Zděděno od DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Vykreslí ikonu chyby aktuálního DataGridViewCell. (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é 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