DataGridViewCell Klasse

Referenz

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 Vorgehensweise: Hinzufügen von QuickInfos zu einzelnen Zellen in einem Windows Forms DataGridView-Steuerelement.

// 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 Steuerelement dar DataGridView . Sie können Zellen über die Cells Auflistung eines DataGridViewRowabrufen.

Die Zeile und Spalte für einen DataGridViewCell identifizieren die Position der Zelle im DataGridView. Eine typische Zelle enthält Daten, die für die Zeile und Spalte spezifisch sind, in der sie enthalten ist. Die Zelle kann auf verschiedene Arten angepasst werden, indem sie ihre Eigenschaften festlegt und die ihr zugeordneten Ereignisse behandelt.

Hinweise für Ausführende

Wenn Sie von DataGridViewCell der abgeleiteten Klasse abgeleitet und der abgeleiteten Klasse 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

DataGridViewCell()

Initialisiert eine neue Instanz der DataGridViewCell-Klasse.

Eigenschaften

AccessibilityObject	Ruft das der DataGridViewCell.DataGridViewCellAccessibleObject zugewiesene DataGridViewCell ab.
ColumnIndex	Ruft den Spaltenindex für diese Zelle ab.
ContentBounds	Ruft das den Inhaltsbereich der Zelle umschließende Rechteck ab.
ContextMenuStrip	Ruft das der Zelle zugeordnete Kontextmenü ab oder legt dieses fest.
DataGridView	Ruft das diesem Element zugeordnete DataGridView-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 momentan 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 dass kein Commit für den Wert ausgeführt wurde.
EditType	Ruft den Typ des gehosteten Bearbeitungssteuerelements der Zelle ab.
ErrorIconBounds	Ruft die Begrenzungen des Fehlersymbols für die Zelle ab.
ErrorText	Ruft den Text ab, mit dem ein der Zelle zugeordneter Fehlerzustand beschrieben wird, oder legt diesen Text fest.
FormattedValue	Ruft den zum Anzeigen formatierten Wert der Zelle ab.
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, der vom Zustand ihrer Zeile und Spalte geerbt wurde.
InheritedStyle	Ruft den gegenwärtig auf die Zelle angewendeten Stil ab.
IsInEditMode	Ruft einen Wert ab, der angibt, ob diese Zelle derzeit bearbeitet wird.
OwningColumn	Ruft die diese Zelle enthaltende Spalte ab.
OwningRow	Ruft die diese Zelle enthaltende Zeile ab.
PreferredSize	Ruft die Größe eines rechteckigen Bereichs in Pixel ab, in den die Zelle eingepasst werden kann.
ReadOnly	Ruft einen Wert ab, der angibt, ob die Zelldaten bearbeitet werden können, oder legt diesen Wert fest.
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	Ruft einen Wert ab, der angibt, ob die Zelle ausgewählt wurde, oder legt diesen fest.
Size	Ruft die Größe der Zelle ab.
State	Ruft den Benutzeroberflächenzustand des Elements ab. (Geerbt von DataGridViewElement)
Style	Ruft den Stil für die Zelle ab oder legt ihn fest.
Tag	Ruft das Objekt ab, das zusätzliche Daten zur Zelle enthält, oder legt dieses fest.
ToolTipText	Ruft den dieser Zelle zugeordneten QuickInfo-Text ab oder legt diesen fest.
Value	Ruft den dieser Zelle zugeordneten Wert ab oder legt ihn fest.
ValueType	Ruft den Datentyp der Werte in der Zelle ab oder legt ihn fest.
Visible	Ruft einen Wert ab, der angibt, ob sich die Zelle in einer Zeile oder Spalte befindet, die ausgeblendet wurde.

Methoden

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Ändert die Rahmenart der Eingabezelle entsprechend den angegebenen Kriterien.
BorderWidths(DataGridViewAdvancedBorderStyle)	Gibt ein Rectangle zurück, das die Breite aller Zellränder darstellt.
ClickUnsharesRow(DataGridViewCellEventArgs)	Gibt an, ob die Freigabe für 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 Freigabe für die Zeile der Zelle aufgehoben wird, wenn auf den Inhalt der Zelle geklickt wird.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Gibt an, ob die Freigabe für die Zeile der Zelle aufgehoben wird, wenn auf den Inhalt der Zelle doppelgeklickt wird.
CreateAccessibilityInstance()	Erstellt ein neues barrierefreies Objekt für die DataGridViewCell.
DetachEditingControl()	Entfernt das Bearbeitungssteuerelement der Zelle aus der DataGridView.
Dispose()	Gibt alle vom DataGridViewCell verwendeten Ressourcen frei.
Dispose(Boolean)	Gibt die von DataGridViewCell verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Gibt an, ob die Freigabe für die Zeile der Zelle aufgehoben wird, wenn auf die Zelle doppelgeklickt wird.
EnterUnsharesRow(Int32, Boolean)	Gibt an, ob die Freigabe der übergeordneten Zeile aufgehoben wird, wenn die Zelle den Fokus erhält.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Finalize()	Gibt nicht verwaltete Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor der DataGridViewCell durch die Garbage Collection wieder zugänglich gemacht wird.
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Ruft den formatierten Wert der Zelle ab, der nach Clipboard kopiert werden soll.
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Gibt das den Inhaltsbereich einer Zelle umschließende Rechteck zurück, das mithilfe der angegebenen Graphics und des Zellstils berechnet wird.
GetContentBounds(Int32)	Gibt das umschließende Rechteck zurück, das den Inhaltsbereich der Zelle unter Verwendung einer Standard-Graphics-Klasse und des gegenwärtig für die Zelle gültigen Zellstils einschließt.
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Gibt den aktuellen, formatierten Wert der Zelle zurück, unabhängig davon, ob sich die Zelle im Bearbeitungsmodus befindet und dass kein Commit für den Wert ausgeführt wurde.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Gibt das das Fehlersymbol der Zelle, sofern angezeigt, umschließende Rechteck zurück.
GetErrorText(Int32)	Gibt eine Zeichenfolge zurück, die den Fehler für die Zelle darstellt.
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Ruft den zum Anzeigen formatierten Wert der Zelle ab.
GetHashCode()	Fungiert 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, der vom Zustand der entsprechenden Zeile und Spalte geerbt wurde.
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Ruft den auf die Zelle angewendeten Stil ab.
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Berechnet die geeignete Größe der Zelle (in Pixel).
GetSize(Int32)	Ruft die Größe der Zelle ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(Int32)	Ruft den Wert der Zelle ab.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Initialisiert das Steuerelement zum Bearbeiten der Zelle.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Gibt an, ob die Freigabe der übergeordneten Zeile aufgehoben wird, wenn der Benutzer eine Taste drückt, während sich der Fokus in der Zelle befindet.
KeyEntersEditMode(KeyEventArgs)	Bestimmt, ob der Bearbeitungsmodus mit der angegebenen Taste gestartet werden soll.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn eine Taste gedrückt wird, während eine Zelle in der Zeile den Fokus besitzt.
KeyUpUnsharesRow(KeyEventArgs, Int32)	Gibt an, ob die Freigabe der übergeordneten Zeile aufgehoben wird, wenn der Benutzer eine Taste loslässt, während sich der Fokus in der Zelle befindet.
LeaveUnsharesRow(Int32, Boolean)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn eine Zelle in der Zeile den Fokus verliert.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Ruft die Höhe des angegebenen Texts in Pixel mit den angegebenen Eigenschaften ab.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)	Ruft die Höhe des angegebenen Texts in Pixel mit den angegebenen Eigenschaften ab. Gibt außerdem an, ob die erforderliche Breite größer als die angegebene maximale Breite ist.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)	Ruft die ideale Höhe und Breite des angegebenen Texts mit den angegebenen Eigenschaften ab.
MeasureTextSize(Graphics, String, Font, TextFormatFlags)	Ruft die Höhe und Breite des angegebenen Texts mit den angegebenen Eigenschaften ab.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)	Ruft die Breite des angegebenen Texts in Pixel mit den angegebenen Eigenschaften ab.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Benutzer eine Maustaste drückt, während sich der Mauszeiger in einer Zelle der Zeile befindet.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Benutzer auf eine Zelle in der Zeile doppelklickt.
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Benutzer eine Maustaste gedrückt hält, während sich der Mauszeiger in einer Zelle der Zeile befindet.
MouseEnterUnsharesRow(Int32)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Mauszeiger über eine Zelle in der Zeile bewegt wird.
MouseLeaveUnsharesRow(Int32)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Mauszeiger aus der Zeile heraus bewegt wird.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Mauszeiger über eine Zelle in der Zeile bewegt wird.
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Benutzer eine Maustaste loslässt, während sich der Mauszeiger in einer Zelle der Zeile befindet.
OnClick(DataGridViewCellEventArgs)	Wird beim Klicken auf die Zelle aufgerufen.
OnContentClick(DataGridViewCellEventArgs)	Wird beim Klicken auf den Inhalt der Zelle aufgerufen.
OnContentDoubleClick(DataGridViewCellEventArgs)	Wird beim Doppelklicken auf den Inhalt der Zelle aufgerufen.
OnDataGridViewChanged()	Wird aufgerufen, wenn sich die DataGridView-Eigenschaft der Zelle ändert.
OnDoubleClick(DataGridViewCellEventArgs)	Wird beim Doppelklicken auf die Zelle aufgerufen.
OnEnter(Int32, Boolean)	Wird aufgerufen, wenn eine Zelle den Fokus erhält.
OnKeyDown(KeyEventArgs, Int32)	Wird aufgerufen, wenn eine Zeichentaste gedrückt wird, während der Fokus auf einer Zelle ist.
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 der Fokus auf einer Zelle liegt.
OnLeave(Int32, Boolean)	Wird aufgerufen, wenn eine Zelle den Fokus verliert.
OnMouseClick(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer eine Maustaste drückt, während sich der Mauszeiger in einer Zelle befindet.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer einen Doppelklick mit einer Maustaste ausführt, während sich der Mauszeiger in einer Zelle befindet.
OnMouseDown(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer eine Maustaste gedrückt hält, während sich der Mauszeiger in einer Zelle befindet.
OnMouseEnter(Int32)	Wird aufgerufen, wenn der Mauszeiger über eine Zelle bewegt wird.
OnMouseLeave(Int32)	Wird aufgerufen, wenn der Mauszeiger den Bereich der 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 in einer Zelle befindet.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Zeichnet die aktuelle DataGridViewCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Zeichnet den Rahmen der aktuellen DataGridViewCell.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Zeichnet das Fehlersymbol der aktuellen DataGridViewCell.
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Konvertiert einen zum Anzeigen formatierten Wert in einen tatsächlichen Zellwert.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Legt die Position und die 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 die Größe des von der Zelle gehosteten Bearbeitungsbereichs fest und gibt die normalen Begrenzungen des Bearbeitungssteuerelements im Bearbeitungsbereich 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:

Teilen über