DataGridViewCell Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Představuje jednotlivé buňky v ovládacím DataGridView prvku.

public ref class DataGridViewCell abstract : System::Windows::Forms::DataGridViewElement, ICloneable, IDisposable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))]
public abstract class DataGridViewCell : System.Windows.Forms.DataGridViewElement, ICloneable, IDisposable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))>]
type DataGridViewCell = class
    inherit DataGridViewElement
    interface ICloneable
    interface IDisposable

Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable

Dědičnost

Object

DataGridViewElement

DataGridViewCell

Odvozené

System.Windows.Forms.DataGridViewButtonCell

System.Windows.Forms.DataGridViewCheckBoxCell

System.Windows.Forms.DataGridViewComboBoxCell

System.Windows.Forms.DataGridViewHeaderCell

System.Windows.Forms.DataGridViewImageCell

System.Windows.Forms.DataGridViewLinkCell

System.Windows.Forms.DataGridViewTextBoxCell

Atributy

TypeConverterAttribute

Implementuje

ICloneable IDisposable

Příklady

Následující příklad kódu znázorňuje použití tohoto typu. Další informace o tomto příkladu najdete v tématu Postupy: Přidání popisů do jednotlivých buněk v ovládacím prvku model Windows Forms DataGridView.

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(Object^ /*sender*/, 
    DataGridViewCellFormattingEventArgs^ e)
{
    if ( (e->ColumnIndex == this->dataGridView1->Columns["Rating"]->Index)
        && e->Value != nullptr )
    {
        DataGridViewCell^ cell = 
            this->dataGridView1->Rows[e->RowIndex]->Cells[e->ColumnIndex];
        if (e->Value->Equals("*"))
        {                
            cell->ToolTipText = "very bad";
        }
        else if (e->Value->Equals("**"))
        {
            cell->ToolTipText = "bad";
        }
        else if (e->Value->Equals("***"))
        {
            cell->ToolTipText = "good";
        }
        else if (e->Value->Equals("****"))
        {
            cell->ToolTipText = "very good";
        }
    }
}

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(object sender, 
    DataGridViewCellFormattingEventArgs e)
{
    if ( (e.ColumnIndex == this.dataGridView1.Columns["Rating"].Index)
        && e.Value != null )
    {
        DataGridViewCell cell = 
            this.dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];
        if (e.Value.Equals("*"))
        {                
            cell.ToolTipText = "very bad";
        }
        else if (e.Value.Equals("**"))
        {
            cell.ToolTipText = "bad";
        }
        else if (e.Value.Equals("***"))
        {
            cell.ToolTipText = "good";
        }
        else if (e.Value.Equals("****"))
        {
            cell.ToolTipText = "very good";
        }
    }
}

' Sets the ToolTip text for cells in the Rating column.
Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting

    If e.ColumnIndex = Me.dataGridView1.Columns("Rating").Index _
        AndAlso (e.Value IsNot Nothing) Then

        With Me.dataGridView1.Rows(e.RowIndex).Cells(e.ColumnIndex)

            If e.Value.Equals("*") Then
                .ToolTipText = "very bad"
            ElseIf e.Value.Equals("**") Then
                .ToolTipText = "bad"
            ElseIf e.Value.Equals("***") Then
                .ToolTipText = "good"
            ElseIf e.Value.Equals("****") Then
                .ToolTipText = "very good"
            End If

        End With

    End If

End Sub

Poznámky

Třída DataGridViewCell představuje jednotlivé buňky v ovládacím DataGridView prvku. Buňky můžete načíst prostřednictvím Cells kolekce objektu DataGridViewRow.

Řádek a sloupec označují DataGridViewCell umístění buňky v DataGridView. Typická buňka obsahuje data specifická pro řádek a sloupec, ve kterém je obsažena. Buňku je možné přizpůsobit mnoha způsoby nastavením jejích vlastností a zpracováním událostí s ní spojených.

Poznámky pro implementátory

Když odvozujete a DataGridViewCell 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

DataGridViewCell()

Inicializuje novou instanci DataGridViewCell třídy.

Vlastnosti

AccessibilityObject	Získá přiřazený DataGridViewCell.DataGridViewCellAccessibleObject k DataGridViewCell.
ColumnIndex	Získá index sloupce pro tuto buňku.
ContentBounds	Získá ohraničující obdélník, který obklopuje oblast obsahu buňky.
ContextMenuStrip	Získá nebo nastaví místní nabídku přidruženou k buňce.
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.
Displayed	Získá hodnotu, která označuje, zda je buňka aktuálně zobrazena na obrazovce.
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.
EditType	Získá typ hostovaného ovládacího prvku pro úpravy buňky.
ErrorIconBounds	Získá hranice ikony chyby pro buňku.
ErrorText	Získá nebo nastaví text popisující chybovou podmínku přidruženou k buňce.
FormattedValue	Získá hodnotu buňky formátované pro zobrazení.
FormattedValueType	Získá typ formátované hodnoty přidružené k buňce.
Frozen	Získá hodnotu označující, zda je buňka zmrazena.
HasStyle	Získá hodnotu označující, zda Style byla nastavena vlastnost.
InheritedState	Získá aktuální stav buňky jako zděděný ze stavu jejího řádku a sloupce.
InheritedStyle	Získá styl, který se aktuálně používá v buňce.
IsInEditMode	Získá hodnotu označující, zda je tato buňka právě upravována.
OwningColumn	Získá sloupec, který obsahuje tuto buňku.
OwningRow	Získá řádek, který obsahuje tuto buňku.
PreferredSize	Získá velikost obdélníkové oblasti v pixelech, do které se buňka vejde.
ReadOnly	Získá nebo nastaví hodnotu označující, zda lze upravit data buňky.
Resizable	Získá hodnotu označující, zda lze změnit velikost buňky.
RowIndex	Získá index nadřazeného řádku buňky.
Selected	Získá nebo nastaví hodnotu označující, zda byla buňka vybrána.
Size	Získá velikost buňky.
State	Získá stav uživatelského rozhraní (UI) elementu. (Zděděno od DataGridViewElement)
Style	Získá nebo nastaví styl buňky.
Tag	Získá nebo nastaví objekt, který obsahuje doplňující data o buňce.
ToolTipText	Získá nebo nastaví popis textu přidružené k této buňce.
Value	Získá nebo nastaví hodnotu přidruženou k této buňce.
ValueType	Získá nebo nastaví datový typ hodnot v buňce.
Visible	Získá hodnotu označující, zda je buňka v řádku nebo sloupci, který byl skrytý.

Metody

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Upraví styl ohraničení vstupní buňky podle zadaných kritérií.
BorderWidths(DataGridViewAdvancedBorderStyle)	Vrátí hodnotu Rectangle , která představuje šířku všech okrajů buňky.
ClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky po kliknutí na buňku nesdílí.
Clone()	Vytvoří přesnou kopii této buňky.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky po kliknutí na obsah buňky nesdílí.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při poklikání na obsah buňky nesdílí.
CreateAccessibilityInstance()	Vytvoří nový přístupný objekt pro DataGridViewCellobjekt .
DetachEditingControl()	Odebere ovládací prvek pro úpravy buňky z objektu DataGridView.
Dispose()	Uvolní všechny prostředky používané nástrojem DataGridViewCell.
Dispose(Boolean)	Uvolní nespravované prostředky používané DataGridViewCell nástrojem a volitelně uvolní spravované prostředky.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při poklikání na buňku nesdílí.
EnterUnsharesRow(Int32, Boolean)	Určuje, jestli se nadřazený řádek nesdílí, když se fokus přesune na buňku.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Finalize()	Uvolní nespravované prostředky a provede další operace čištění před DataGridViewCell uvolněním paměti.
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Načte formátovanou hodnotu buňky, která se má zkopírovat do Clipboard.
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.
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.
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.
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Získá hodnotu buňky formátované pro zobrazení.
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.
GetInheritedState(Int32)	Vrátí hodnotu označující aktuální stav buňky zděděné ze stavu jejího řádku a sloupce.
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Získá styl použitý na buňku.
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Vypočítá upřednostňovanou velikost buňky v pixelech.
GetSize(Int32)	Získá velikost buňky.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetValue(Int32)	Získá hodnotu buňky.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Inicializuje ovládací prvek použitý k úpravě buňky.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Určuje, zda je nadřazený řádek nesdílený, pokud uživatel stiskne klávesu, zatímco je fokus na buňce.
KeyEntersEditMode(KeyEventArgs)	Určuje, jestli má být režim úprav spuštěn na základě daného klíče.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Určuje, jestli se řádek nesdílí, pokud je stisknuta klávesa a buňka na řádku má fokus.
KeyUpUnsharesRow(KeyEventArgs, Int32)	Označuje, jestli nadřazený řádek není sdílen, když uživatel uvolní klíč, zatímco fokus je na buňce.
LeaveUnsharesRow(Int32, Boolean)	Určuje, jestli se řádek nesdílí, když fokus opustí buňku v řádku.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Získá výšku zadaného textu v pixelech vzhledem k zadaným charakteristikám.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)	Získá výšku zadaného textu v pixelech vzhledem k zadaným charakteristikám. Označuje také, zda je požadovaná šířka větší než zadaná maximální šířka.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)	Získá ideální výšku a šířku zadaného textu vzhledem k zadaným charakteristikám.
MeasureTextSize(Graphics, String, Font, TextFormatFlags)	Získá výšku a šířku zadaného textu zadanou charakteristikou.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)	Získá šířku v pixelech zadaného textu vzhledem k zadaným charakteristikám.
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.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, pokud uživatel poklikne na buňku v řádku.
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, když uživatel podrží tlačítko myši, zatímco ukazatel je na buňce v řádku.
MouseEnterUnsharesRow(Int32)	Určuje, jestli se řádek nesdílí, když se ukazatel myši přesune na buňku v řádku.
MouseLeaveUnsharesRow(Int32)	Určuje, jestli se řádek nesdílí, když ukazatel myši opustí řádek.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, když se ukazatel myši přesune na buňku v řádku.
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, když uživatel uvolní tlačítko myši, když je ukazatel myši na buňce v řádku.
OnClick(DataGridViewCellEventArgs)	Volá se při kliknutí na buňku.
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.
OnDoubleClick(DataGridViewCellEventArgs)	Volá se při poklikání na buňku.
OnEnter(Int32, Boolean)	Volá se, když se fokus přesune na buňku.
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.
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.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Volá se, když uživatel poklikne na tlačítko myši, když je ukazatel na buňce.
OnMouseDown(DataGridViewCellMouseEventArgs)	Volá se, když uživatel podrží tlačítko myši, zatímco je ukazatel na buňce.
OnMouseEnter(Int32)	Volá se, když se ukazatel myši přesune na buňku.
OnMouseLeave(Int32)	Volá se, když ukazatel myši opustí buňku.
OnMouseMove(DataGridViewCellMouseEventArgs)	Volá se, když se ukazatel myši pohybuje v buňce.
OnMouseUp(DataGridViewCellMouseEventArgs)	Volá se, když uživatel uvolní tlačítko myši, když je ukazatel na buňce.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Vykreslí aktuální DataGridViewCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Vykreslí ohraničení aktuálního DataGridViewCell.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Vykreslí ikonu chyby aktuálního DataGridViewCellsouboru .
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.
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.
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.
ToString()	Vrátí řetězec, který popisuje aktuální objekt.

Viz také

• DataGridView
• ICloneable
• IDisposable