DataGridViewCell Klasse

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine einzelne Zelle in einem DataGridView Steuerelement dar.

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

Vererbung: Object

DataGridViewElement
DataGridViewCell

Abgeleitet: System.Windows.Forms.DataGridViewButtonCell

System.Windows.Forms.DataGridViewCheckBoxCell

System.Windows.Forms.DataGridViewComboBoxCell

System.Windows.Forms.DataGridViewHeaderCell

System.Windows.Forms.DataGridViewImageCell

Mehr …

Attribute: TypeConverterAttribute

Implementiert: ICloneable IDisposable

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht. Weitere Informationen zu diesem Beispiel finden Sie unter How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control.

// 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

Hinweise

Die DataGridViewCell Klasse stellt eine einzelne Zelle in einem DataGridView Steuerelement dar. Sie können Zellen über die Cells Sammlung einer .DataGridViewRow

Die Zeile und Spalte für eine DataGridViewCell Identifizierung der Position der Zelle in der DataGridView. Eine typische Zelle enthält datenspezifisch für die Zeile und Spalte, in der sie enthalten ist. Die Zelle kann auf verschiedene Arten angepasst werden, indem sie ihre Eigenschaften festlegen und die damit verbundenen Ereignisse behandeln.

Hinweise für Ausführende

Wenn Sie von der abgeleiteten Klasse abgeleitete Eigenschaften ableiten DataGridViewCell und neue Eigenschaften hinzufügen, müssen Sie die Clone() Methode überschreiben, um die neuen Eigenschaften während Klonvorgängen zu kopieren. Sie sollten auch die Methode der Basisklasse Clone() aufrufen, damit die Eigenschaften der Basisklasse in die neue Zelle kopiert werden.

Konstruktoren

Name	Beschreibung
DataGridViewCell()	Initialisiert eine neue Instanz der DataGridViewCell-Klasse.

Eigenschaften

Name	Beschreibung
AccessibilityObject	Ruft die DataGridViewCell.DataGridViewCellAccessibleObject zugewiesene der DataGridViewCell.
ColumnIndex	Ruft den Spaltenindex für diese Zelle ab.
ContentBounds	Ruft das umgebende Rechteck ab, das den Inhaltsbereich der Zelle einschließt.
ContextMenuStrip	Dient zum Abrufen oder Festlegen des Kontextmenüs, das der Zelle zugeordnet ist.
DataGridView	Ruft das DataGridView diesem Element zugeordnete Steuerelement ab. (Geerbt von DataGridViewElement)
DefaultNewRowValue	Ruft den Standardwert für eine Zelle in der Zeile für neue Datensätze ab.
Displayed	Ruft einen Wert ab, der angibt, ob die Zelle derzeit auf dem Bildschirm angezeigt wird.
EditedFormattedValue	Ruft den aktuellen, formatierten Wert der Zelle ab, unabhängig davon, ob sich die Zelle im Bearbeitungsmodus befindet und der Wert nicht zugesichert wurde.
EditType	Ruft den Typ des gehosteten Bearbeitungssteuerelements der Zelle ab.
ErrorIconBounds	Ruft die Grenzen des Fehlersymbols für die Zelle ab.
ErrorText	Ruft den Text ab, der eine Fehlerbedingung beschreibt, die der Zelle zugeordnet ist, oder legt den Text fest.
FormattedValue	Ruft den Wert der Zelle ab, die für die Anzeige formatiert ist.
FormattedValueType	Ruft den Typ des formatierten Werts ab, der der Zelle zugeordnet ist.
Frozen	Ruft einen Wert ab, der angibt, ob die Zelle fixiert ist.
HasStyle	Ruft einen Wert ab, der angibt, ob die Style Eigenschaft festgelegt wurde.
InheritedState	Ruft den aktuellen Zustand der Zelle ab, die vom Status der Zeile und Spalte geerbt wird.
InheritedStyle	Ruft die aktuell auf die Zelle angewendete Formatvorlage ab.
IsInEditMode	Ruft einen Wert ab, der angibt, ob diese Zelle derzeit bearbeitet wird.
OwningColumn	Ruft die Spalte ab, die diese Zelle enthält.
OwningRow	Ruft die Zeile ab, die diese Zelle enthält.
PreferredSize	Ruft die Größe eines rechteckigen Bereichs in Pixel ab, in den die Zelle passen kann.
ReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Daten der Zelle bearbeitet werden können.
Resizable	Ruft einen Wert ab, der angibt, ob die Größe der Zelle geändert werden kann.
RowIndex	Ruft den Index der übergeordneten Zeile der Zelle ab.
Selected	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zelle ausgewählt wurde.
Size	Ruft die Größe der Zelle ab.
State	Ruft den Benutzeroberflächenstatus des Elements ab. (Geerbt von DataGridViewElement)
Style	Ruft die Formatvorlage für die Zelle ab oder legt diese fest.
Tag	Dient zum Abrufen oder Festlegen des Objekts, das zusätzliche Daten zu der Zelle enthält.
ToolTipText	Dient zum Abrufen oder Festlegen des QuickInfo-Texts, der dieser Zelle zugeordnet ist.
Value	Dient zum Abrufen oder Festlegen des Werts, der dieser Zelle zugeordnet ist.
ValueType	Dient zum Abrufen oder Festlegen des Datentyps der Werte in der Zelle.
Visible	Ruft einen Wert ab, der angibt, ob sich die Zelle in einer Zeile oder Spalte befindet, die ausgeblendet wurde.

Methoden

Name	Beschreibung
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Ändert die Rahmenart der Eingabezelle entsprechend den angegebenen Kriterien.
BorderWidths(DataGridViewAdvancedBorderStyle)	Gibt einen Rectangle Wert zurück, der die Breite aller Zellränder darstellt.
ClickUnsharesRow(DataGridViewCellEventArgs)	Gibt an, ob die Zeile der Zelle aufgehoben wird, wenn auf die Zelle geklickt wird.
Clone()	Erstellt eine genaue Kopie dieser Zelle.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Gibt an, ob die Zeile der Zelle aufgehoben wird, wenn auf den Inhalt der Zelle geklickt wird.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Gibt an, ob die Zeile der Zelle aufgehoben wird, wenn auf den Inhalt der Zelle doppelklicken wird.
CreateAccessibilityInstance()	Erstellt ein neues barrierefreies Objekt für das DataGridViewCell.
DetachEditingControl()	Entfernt das Bearbeitungssteuerelement der Zelle aus dem DataGridView.
Dispose()	Veröffentlicht alle ressourcen, die von der DataGridViewCell.
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den DataGridViewCell verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Gibt an, ob die Zeile der Zelle nicht angehalten wird, wenn auf die Zelle doppelklicken.
EnterUnsharesRow(Int32, Boolean)	Gibt an, ob die übergeordnete Zeile aufgehoben wird, wenn der Fokus auf die Zelle verschoben wird.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Finalize()	Gibt die nicht verwalteten Ressourcen frei und führt weitere Bereinigungsvorgänge aus, bevor die DataGridViewCell Garbage Collection erneut beansprucht wird.
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Ruft den formatierten Wert der Zelle ab, die in die ClipboardZelle kopiert werden soll.
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Gibt das umgebende Rechteck zurück, das den Inhaltsbereich der Zelle einschließt, das mit der angegebenen Graphics Und Zellenformatvorlage berechnet wird.
GetContentBounds(Int32)	Gibt das umgebende Rechteck zurück, das den Inhaltsbereich der Zelle mit einer Standard Graphics - und Zellenformatvorlage einschließt, die derzeit für die Zelle wirksam ist.
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Gibt den aktuellen, formatierten Wert der Zelle zurück, unabhängig davon, ob sich die Zelle im Bearbeitungsmodus befindet und der Wert nicht zugesichert wurde.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Gibt das umgebende Rechteck zurück, das das Fehlersymbol der Zelle einschließt, wenn eins angezeigt wird.
GetErrorText(Int32)	Gibt eine Zeichenfolge zurück, die den Fehler für die Zelle darstellt.
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Ruft den Wert der Zelle ab, die für die Anzeige formatiert ist.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetInheritedContextMenuStrip(Int32)	Ruft das geerbte Kontextmenü für die aktuelle Zelle ab.
GetInheritedState(Int32)	Gibt einen Wert zurück, der den aktuellen Zustand der Zelle angibt, wie sie vom Zustand der Zeile und Spalte geerbt wurde.
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Ruft die Formatvorlage ab, die auf die Zelle angewendet wird.
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Berechnet die bevorzugte Größe in Pixeln der Zelle.
GetSize(Int32)	Ruft die Größe der Zelle ab.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(Int32)	Ruft den Wert der Zelle ab.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Initialisiert das Steuerelement, das zum Bearbeiten der Zelle verwendet wird.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Gibt an, ob die übergeordnete Zeile nicht freigegeben ist, wenn der Benutzer eine Taste drückt, während sich der Fokus auf der Zelle befindet.
KeyEntersEditMode(KeyEventArgs)	Bestimmt, ob der Bearbeitungsmodus basierend auf dem angegebenen Schlüssel gestartet werden soll.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Gibt an, ob eine Zeile nicht freigegeben wird, wenn eine Taste gedrückt wird, während eine Zelle in der Zeile den Fokus hat.
KeyUpUnsharesRow(KeyEventArgs, Int32)	Gibt an, ob die übergeordnete Zeile nicht freigegeben wird, wenn der Benutzer eine Taste loslässt, während sich der Fokus auf der Zelle befindet.
LeaveUnsharesRow(Int32, Boolean)	Gibt an, ob eine Zeile nicht freigegeben wird, wenn der Fokus eine Zelle in der Zeile verlässt.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)	Ruft die Höhe des angegebenen Texts in Pixeln ab, wenn die angegebenen Merkmale angegeben sind. Gibt auch an, ob die erforderliche Breite größer als die angegebene maximale Breite ist.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Ruft die Höhe des angegebenen Texts in Pixeln ab, wenn die angegebenen Merkmale angegeben sind.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)	Ruft die ideale Höhe und Breite des angegebenen Texts mit den angegebenen Merkmalen ab.
MeasureTextSize(Graphics, String, Font, TextFormatFlags)	Ruft die Höhe und Breite des angegebenen Texts mit den angegebenen Merkmalen ab.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)	Ruft die Breite des angegebenen Texts in Pixeln ab, der den angegebenen Merkmalen entspricht.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob eine Zeile nicht freigegeben wird, wenn der Benutzer auf eine Maustaste klickt, während sich der Mauszeiger auf einer Zelle in der Zeile befindet.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob eine Zeile nicht angehalten wird, wenn der Benutzer auf eine Zelle in der Zeile doppelklicken soll.
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob eine Zeile nicht freigegeben wird, wenn der Benutzer eine Maustaste gedrückt hält, während sich der Mauszeiger auf einer Zelle in der Zeile befindet.
MouseEnterUnsharesRow(Int32)	Gibt an, ob eine Zeile aufgehoben wird, wenn der Mauszeiger über eine Zelle in der Zeile bewegt wird.
MouseLeaveUnsharesRow(Int32)	Gibt an, ob eine Zeile nicht angehalten wird, wenn der Mauszeiger die Zeile verlässt.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob eine Zeile aufgehoben wird, wenn der Mauszeiger über eine Zelle in der Zeile bewegt wird.
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob eine Zeile nicht freigegeben wird, wenn der Benutzer eine Maustaste loslässt, während sich der Mauszeiger auf einer Zelle in der Zeile befindet.
OnClick(DataGridViewCellEventArgs)	Wird aufgerufen, wenn auf die Zelle geklickt wird.
OnContentClick(DataGridViewCellEventArgs)	Wird aufgerufen, wenn auf den Inhalt der Zelle geklickt wird.
OnContentDoubleClick(DataGridViewCellEventArgs)	Wird aufgerufen, wenn der Inhalt der Zelle durch Doppelklicken geklickt wird.
OnDataGridViewChanged()	Wird aufgerufen, wenn sich die DataGridView Eigenschaft der Zelle ändert.
OnDoubleClick(DataGridViewCellEventArgs)	Wird aufgerufen, wenn auf die Zelle doppelt geklickt wird.
OnEnter(Int32, Boolean)	Wird aufgerufen, wenn der Fokus auf eine Zelle verschoben wird.
OnKeyDown(KeyEventArgs, Int32)	Wird aufgerufen, wenn eine Zeichentaste gedrückt wird, während sich der Fokus auf einer Zelle befindet.
OnKeyPress(KeyPressEventArgs, Int32)	Wird aufgerufen, wenn eine Taste gedrückt wird, während sich der Fokus auf einer Zelle befindet.
OnKeyUp(KeyEventArgs, Int32)	Wird aufgerufen, wenn eine Zeichentaste losgelassen wird, während sich der Fokus auf einer Zelle befindet.
OnLeave(Int32, Boolean)	Wird aufgerufen, wenn der Fokus von einer Zelle verschoben wird.
OnMouseClick(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer auf eine Maustaste klickt, während sich der Mauszeiger auf einer Zelle befindet.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer auf eine Maustaste doppelklippelt, während sich der Mauszeiger auf einer Zelle befindet.
OnMouseDown(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer eine Maustaste gedrückt hält, während sich der Zeiger auf einer Zelle befindet.
OnMouseEnter(Int32)	Wird aufgerufen, wenn der Mauszeiger über eine Zelle bewegt wird.
OnMouseLeave(Int32)	Wird aufgerufen, wenn der Mauszeiger die Zelle verlässt.
OnMouseMove(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Mauszeiger innerhalb einer Zelle bewegt wird.
OnMouseUp(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer eine Maustaste loslässt, während sich der Mauszeiger auf einer Zelle befindet.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Zeichnet den aktuellen DataGridViewCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Zeichnet den Rahmen des aktuellen DataGridViewCell.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Zeichnet das Fehlersymbol des aktuellen DataGridViewCell.
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Wandelt einen Wert, der für die Anzeige formatiert ist, in einen tatsächlichen Zellwert um.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Legt die Position und Größe des Bearbeitungssteuerelements fest, das von einer Zelle im DataGridView Steuerelement gehostet wird.
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Legt die Position und Größe des Bearbeitungsbereichs fest, der von der Zelle gehostet wird, und gibt die normalen Grenzen des Bearbeitungssteuerelements innerhalb des Bearbeitungsbereichs zurück.
RaiseCellClick(DataGridViewCellEventArgs)	Löst das CellClick-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Löst das CellContentClick-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Löst das CellContentDoubleClick-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Löst das CellValueChanged-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Löst das DataError-Ereignis aus. (Geerbt von DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Löst das MouseWheel-Ereignis aus. (Geerbt von DataGridViewElement)
SetValue(Int32, Object)	Legt den Wert der Zelle fest.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt beschreibt.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?