DataGridViewCell Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewCell.cs

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))]
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.Interfaces | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public abstract class DataGridViewCell : System.Windows.Forms.DataGridViewElement, ICloneable, IDisposable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))>]
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.Interfaces | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
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 DynamicallyAccessedMembersAttribute

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 Pokud 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 .DataGridViewRow

Řádek a sloupec pro DataGridViewCell identifikaci umístění buňky v sadě DataGridView. Typická buňka obsahuje data specifická pro řádek a sloupec, ve kterém je obsažena. Buňku lze přizpůsobit několika způsoby nastavením jeho vlastností a zpracováním událostí přidružených k ní.

Poznámky pro implementátory

Při odvozené DataGridViewCell 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
DataGridViewCell()	Inicializuje novou instanci DataGridViewCell třídy.

Vlastnosti

Name	Description
AccessibilityObject	DataGridViewCell.DataGridViewCellAccessibleObject Získá přiřazeno DataGridViewCell.
ColumnIndex	Získá index sloupce pro tuto buňku.
ContentBounds	Získá ohraničující obdélník, který ohraničuje 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 pro buňku 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í chybový stav přidružený k buňce.
FormattedValue	Získá hodnotu buňky jako formát 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 určující, zda Style byla vlastnost nastavena.
InheritedState	Získá aktuální stav buňky zděděný ze stavu jeho řádku a sloupce.
InheritedStyle	Získá styl, který je aktuálně použit pro buňku.
IsInEditMode	Získá hodnotu označující, zda se tato buňka právě upravuje.
OwningColumn	Získá sloupec, který obsahuje tuto buňku.
OwningRow	Získá řádek, který obsahuje tuto buňku.
PreferredSize	Získá velikost vpixelch
ReadOnly	Získá nebo nastaví hodnotu určující, zda lze upravit data buňky.
Resizable	Získá hodnotu označující, zda je možné 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 je buňka vybrána.
Size	Získá velikost buňky.
State	Získá stav uživatelského rozhraní prvku. (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í text popisu 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

Name	Description
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 šířky všech okrajů buňky.
ClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při kliknutí na buňku nesdílí.
Clone()	Vytvoří přesnou kopii této buňky.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při kliknutí na obsah buňky nesdílí.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při dvojitém kliknutí na obsah buňky nesdílí.
CreateAccessibilityInstance()	Vytvoří nový přístupný objekt pro objekt DataGridViewCell.
DetachEditingControl()	Odebere ovládací prvek pro úpravy buňky z ovládacího DataGridViewprvku .
Dispose()	Uvolní všechny prostředky používané nástrojem DataGridViewCell.
Dispose(Boolean)	Uvolní nespravované prostředky používané DataGridViewCell a volitelně uvolní spravované prostředky.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Určuje, jestli se řádek buňky při dvojitém kliknutí na buňku nesdílí.
EnterUnsharesRow(Int32, Boolean)	Určuje, jestli se nadřazený řádek při přesunutí fokusu na buňku zruší.
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 Clipboardbuňky .
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.
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.
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 jako formát pro zobrazení.
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 řá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.
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, jestli je nadřazený řádek nesdílený, pokud uživatel stiskne klávesu, když je fokus na buňce.
KeyEntersEditMode(KeyEventArgs)	Určuje, jestli se má režim úprav spustit na základě daného klíče.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Určuje, jestli se řádek nesdílí, pokud je stisknutá klávesa, když je fokus na buňce v řádku.
KeyUpUnsharesRow(KeyEventArgs, Int32)	Určuje, jestli se nadřazený řádek nesdílí, když uživatel uvolní klíč, když je fokus 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, Boolean)	Získá výšku v pixelech zadaného textu vzhledem k zadaným charakteristikám. Určuje také, jestli je požadovaná šířka větší než zadaná maximální šířka.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Získá výšku v pixelech zadaného textu vzhledem k zadaným charakteristikám.
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 vzhledem k zadaným charakteristikám.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)	Získá šířku zadaného textu v pixelech vzhledem k zadaným charakteristikám.
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.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Určuje, jestli se řádek nesdílí, pokud uživatel dvakrát klikne 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 nebude sdílet, 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 nebude sdílet, 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 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, když je obsah buňky poklikaný.
OnDataGridViewChanged()	Volá se při DataGridView změně vlastnosti buňky.
OnDoubleClick(DataGridViewCellEventArgs)	Volá se při poklikání na buňku.
OnEnter(Int32, Boolean)	Volá se, když se fokus přesune do buňky.
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é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.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Volá se, když uživatel dvakrát klikne na tlačítko myši, když je ukazatel na buňce.
OnMouseDown(DataGridViewCellMouseEventArgs)	Volá se, když uživatel drží tlačítko myši, když je ukazatel na buňce.
OnMouseEnter(Int32)	Volá se, když se ukazatel myši přesune přes buňku.
OnMouseLeave(Int32)	Volá se, když ukazatel myši opustí buňku.
OnMouseMove(DataGridViewCellMouseEventArgs)	Volá se, když se ukazatel myši přesune 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)	Maluje aktuální DataGridViewCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Nakreslí okraj aktuálního DataGridViewCell.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Vykreslí ikonu chyby aktuálního 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.
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