Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DataGridViewCell-Klasse

.NET Framework 4

Stellt eine einzelne Zelle in einem DataGridView-Steuerelement dar.

System.Object
  System.Windows.Forms.DataGridViewElement
    System.Windows.Forms.DataGridViewCell
      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

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
C#
C++
F#
VB
Kopieren 
public abstract class DataGridViewCell : DataGridViewElement, 
	ICloneable, IDisposable

Der DataGridViewCell-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Geschützte Methode DataGridViewCell Initialisiert eine neue Instanz der DataGridViewCell-Klasse.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft AccessibilityObject Ruft das der DataGridViewCell zugewiesene DataGridViewCell.DataGridViewCellAccessibleObject ab.
Öffentliche Eigenschaft ColumnIndex Ruft den Spaltenindex für diese Zelle ab.
Öffentliche Eigenschaft ContentBounds Ruft das den Inhaltsbereich der Zelle umschließende Rechteck ab.
Öffentliche Eigenschaft ContextMenuStrip Ruft das der Zelle zugeordnete Kontextmenü ab oder legt dieses fest.
Öffentliche Eigenschaft DataGridView Ruft das diesem Element zugeordnete DataGridView-Steuerelement ab. (Von DataGridViewElement geerbt.)
Öffentliche Eigenschaft DefaultNewRowValue Ruft den Standardwert für eine Zelle in der Zeile für neue Datensätze ab.
Öffentliche Eigenschaft Displayed Ruft einen Wert ab, der angibt, ob die Zelle momentan auf dem Bildschirm angezeigt wird.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft EditType Ruft den Typ des gehosteten Bearbeitungssteuerelements der Zelle ab.
Öffentliche Eigenschaft ErrorIconBounds Ruft die Begrenzungen des Fehlersymbols für die Zelle ab.
Öffentliche Eigenschaft ErrorText Ruft den Text ab, mit dem ein der Zelle zugeordneter Fehlerzustand beschrieben wird, oder legt diesen Text fest.
Öffentliche Eigenschaft FormattedValue Ruft den zum Anzeigen formatierten Wert der Zelle ab.
Öffentliche Eigenschaft FormattedValueType Ruft den Typ des formatierten Werts ab, der der Zelle zugeordnet ist.
Öffentliche Eigenschaft Frozen Ruft einen Wert ab, der angibt, ob die Zelle fixiert ist.
Öffentliche Eigenschaft HasStyle Ruft einen Wert ab, der angibt, ob die Style-Eigenschaft festgelegt wurde.
Öffentliche Eigenschaft InheritedState Ruft den aktuellen Zustand der Zelle ab, der vom Zustand ihrer Zeile und Spalte geerbt wurde.
Öffentliche Eigenschaft InheritedStyle Ruft den gegenwärtig auf die Zelle angewendeten Stil ab.
Öffentliche Eigenschaft IsInEditMode Ruft einen Wert ab, der angibt, ob diese Zelle derzeit bearbeitet wird.
Öffentliche Eigenschaft OwningColumn Ruft die diese Zelle enthaltende Spalte ab.
Öffentliche Eigenschaft OwningRow Ruft die diese Zelle enthaltende Zeile ab.
Öffentliche Eigenschaft PreferredSize Ruft die Größe eines rechteckigen Bereichs in Pixel ab, in den die Zelle eingepasst werden kann.
Öffentliche Eigenschaft ReadOnly Ruft einen Wert ab, der angibt, ob die Zelldaten bearbeitet werden können, oder legt diesen Wert fest.
Öffentliche Eigenschaft Resizable Ruft einen Wert ab, der angibt, ob die Größe der Zelle geändert werden kann.
Öffentliche Eigenschaft RowIndex Ruft den Index der übergeordneten Zeile der Zelle ab.
Öffentliche Eigenschaft Selected Ruft einen Wert ab, der angibt, ob die Zelle ausgewählt wurde, oder legt diesen fest.
Öffentliche Eigenschaft Size Ruft die Größe der Zelle ab.
Öffentliche Eigenschaft State Ruft den Benutzeroberflächenzustand des Elements ab. (Von DataGridViewElement geerbt.)
Öffentliche Eigenschaft Style Ruft den Stil für die Zelle ab oder legt ihn fest.
Öffentliche Eigenschaft Tag Ruft das Objekt ab, das zusätzliche Daten zur Zelle enthält, oder legt dieses fest.
Öffentliche Eigenschaft ToolTipText Ruft den dieser Zelle zugeordneten QuickInfo-Text ab oder legt diesen fest.
Öffentliche Eigenschaft Value Ruft den dieser Zelle zugeordneten Wert ab oder legt ihn fest.
Öffentliche Eigenschaft ValueType Ruft den Datentyp der Werte in der Zelle ab oder legt diesen fest.
Öffentliche Eigenschaft Visible Ruft einen Wert ab, der angibt, ob sich die Zelle in einer Zeile oder Spalte befindet, die ausgeblendet wurde.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode AdjustCellBorderStyle Ändert die Rahmenart der Eingabezelle entsprechend den angegebenen Kriterien.
Geschützte Methode BorderWidths Gibt ein Rectangle zurück, das die Breite aller Zellränder darstellt.
Geschützte Methode ClickUnsharesRow Gibt an, ob die Freigabe für die Zeile der Zelle aufgehoben wird, wenn auf die Zelle geklickt wird.
Öffentliche Methode Clone Erstellt eine genaue Kopie dieser Zelle.
Geschützte Methode ContentClickUnsharesRow Gibt an, ob die Freigabe für die Zeile der Zelle aufgehoben wird, wenn auf den Inhalt der Zelle geklickt wird.
Geschützte Methode ContentDoubleClickUnsharesRow Gibt an, ob die Freigabe für die Zeile der Zelle aufgehoben wird, wenn auf den Inhalt der Zelle doppelgeklickt wird.
Geschützte Methode CreateAccessibilityInstance Erstellt ein neues barrierefreies Objekt für die DataGridViewCell.
Öffentliche Methode DetachEditingControl Entfernt das Bearbeitungssteuerelement der Zelle aus der DataGridView.
Öffentliche Methode Dispose() Gibt alle von DataGridViewCell verwendeten Ressourcen frei.
Geschützte Methode Dispose(Boolean) Gibt die von der DataGridViewCell verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei.
Geschützte Methode DoubleClickUnsharesRow Gibt an, ob die Freigabe für die Zeile der Zelle aufgehoben wird, wenn auf die Zelle doppelgeklickt wird.
Geschützte Methode EnterUnsharesRow Gibt an, ob die Freigabe der übergeordneten Zeile aufgehoben wird, wenn die Zelle den Fokus erhält.
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode 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. (Überschreibt Object.Finalize().)
Geschützte Methode GetClipboardContent Ruft den formatierten Wert der Zelle ab, der nach Clipboard kopiert werden soll.
Öffentliche Methode 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.
Geschützte Methode GetContentBounds(Graphics, DataGridViewCellStyle, Int32) Gibt das den Inhaltsbereich einer Zelle umschließende Rechteck zurück, das mithilfe der angegebenen Graphics-Klasse und des Zellstils berechnet wird.
Öffentliche Methode GetEditedFormattedValue 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.
Geschützte Methode GetErrorIconBounds Gibt das das Fehlersymbol der Zelle, sofern angezeigt, umschließende Rechteck zurück.
Geschützte Methode GetErrorText Gibt eine Zeichenfolge zurück, die den Fehler für die Zelle darstellt.
Geschützte Methode GetFormattedValue Ruft den zum Anzeigen formatierten Wert der Zelle ab.
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetInheritedContextMenuStrip Ruft das geerbte Kontextmenü für die aktuelle Zelle ab.
Öffentliche Methode GetInheritedState Gibt einen Wert zurück, der den aktuellen Zustand der Zelle angibt, der vom Zustand der entsprechenden Zeile und Spalte geerbt wurde.
Öffentliche Methode GetInheritedStyle Ruft den auf die Zelle angewendeten Stil ab.
Geschützte Methode GetPreferredSize Berechnet die bevorzugte Größe der Zelle in Pixel.
Geschützte Methode GetSize Ruft die Größe der Zelle ab.
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode GetValue Ruft den Wert der Zelle ab.
Öffentliche Methode InitializeEditingControl Initialisiert das Steuerelement zum Bearbeiten der Zelle.
Geschützte Methode KeyDownUnsharesRow 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.
Öffentliche Methode KeyEntersEditMode Bestimmt, ob der Bearbeitungsmodus mit der angegebenen Taste gestartet werden soll.
Geschützte Methode KeyPressUnsharesRow 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.
Geschützte Methode KeyUpUnsharesRow 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.
Geschützte Methode LeaveUnsharesRow Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn eine Zelle in der Zeile den Fokus verliert.
Öffentliche Methode Statischer Member MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags) Ruft die Höhe des angegebenen Texts in Pixel mit den angegebenen Eigenschaften ab.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode Statischer Member MeasureTextPreferredSize Ruft die ideale Höhe und Breite des angegebenen Texts mit den angegebenen Eigenschaften ab.
Öffentliche Methode Statischer Member MeasureTextSize Ruft die Höhe und Breite des angegebenen Texts mit den angegebenen Eigenschaften ab.
Öffentliche Methode Statischer Member MeasureTextWidth Ruft die Breite des angegebenen Texts in Pixel mit den angegebenen Eigenschaften ab.
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte Methode MouseClickUnsharesRow 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.
Geschützte Methode MouseDoubleClickUnsharesRow Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Benutzer auf eine Zelle in der Zeile doppelklickt.
Geschützte Methode MouseDownUnsharesRow 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.
Geschützte Methode MouseEnterUnsharesRow Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Mauszeiger über eine Zelle in der Zeile bewegt wird.
Geschützte Methode MouseLeaveUnsharesRow Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Mauszeiger aus der Zeile heraus bewegt wird.
Geschützte Methode MouseMoveUnsharesRow Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Mauszeiger über eine Zelle in der Zeile bewegt wird.
Geschützte Methode MouseUpUnsharesRow 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.
Geschützte Methode OnClick Wird beim Klicken auf die Zelle aufgerufen.
Geschützte Methode OnContentClick Wird beim Klicken auf den Inhalt der Zelle aufgerufen.
Geschützte Methode OnContentDoubleClick Wird beim Doppelklicken auf den Inhalt der Zelle aufgerufen.
Geschützte Methode OnDataGridViewChanged Wird aufgerufen, wenn sich die DataGridView-Eigenschaft der Zelle ändert. (Überschreibt DataGridViewElement.OnDataGridViewChanged().)
Geschützte Methode OnDoubleClick Wird beim Doppelklicken auf die Zelle aufgerufen.
Geschützte Methode OnEnter Wird aufgerufen, wenn eine Zelle den Fokus erhält.
Geschützte Methode OnKeyDown Wird aufgerufen, wenn eine Zeichentaste gedrückt wird, während der Fokus auf einer Zelle ist.
Geschützte Methode OnKeyPress Wird aufgerufen, wenn eine Taste gedrückt wird, während sich der Fokus auf einer Zelle befindet.
Geschützte Methode OnKeyUp Wird aufgerufen, wenn eine Zeichentaste losgelassen wird, während der Fokus auf einer Zelle liegt.
Geschützte Methode OnLeave Wird aufgerufen, wenn eine Zelle den Fokus verliert.
Geschützte Methode OnMouseClick Wird aufgerufen, wenn der Benutzer eine Maustaste drückt, während sich der Mauszeiger in einer Zelle befindet.
Geschützte Methode OnMouseDoubleClick Wird aufgerufen, wenn der Benutzer einen Doppelklick mit einer Maustaste ausführt, während sich der Mauszeiger in einer Zelle befindet.
Geschützte Methode OnMouseDown Wird aufgerufen, wenn der Benutzer eine Maustaste gedrückt hält, während sich der Mauszeiger in einer Zelle befindet.
Geschützte Methode OnMouseEnter Wird aufgerufen, wenn der Mauszeiger über eine Zelle bewegt wird.
Geschützte Methode OnMouseLeave Wird aufgerufen, wenn der Mauszeiger den Bereich der Zelle verlässt.
Geschützte Methode OnMouseMove Wird aufgerufen, wenn der Mauszeiger innerhalb einer Zelle bewegt wird.
Geschützte Methode OnMouseUp Wird aufgerufen, wenn der Benutzer eine Maustaste loslässt, während sich der Mauszeiger in einer Zelle befindet.
Geschützte Methode Paint Zeichnet die aktuelle DataGridViewCell.
Geschützte Methode PaintBorder Zeichnet den Rahmen der aktuellen DataGridViewCell.
Geschützte Methode PaintErrorIcon Zeichnet das Fehlersymbol der aktuellen DataGridViewCell.
Öffentliche Methode ParseFormattedValue Konvertiert einen zum Anzeigen formatierten Wert in einen tatsächlichen Zellwert.
Öffentliche Methode PositionEditingControl Legt die Position und die Größe des Bearbeitungssteuerelements fest, das von einer Zelle im DataGridView-Steuerelement gehostet wird.
Öffentliche Methode PositionEditingPanel 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.
Geschützte Methode RaiseCellClick Löst das DataGridView.CellClick-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode RaiseCellContentClick Löst das DataGridView.CellContentClick-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode RaiseCellContentDoubleClick Löst das DataGridView.CellContentDoubleClick-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode RaiseCellValueChanged Löst das DataGridView.CellValueChanged-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode RaiseDataError Löst das DataGridView.DataError-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode RaiseMouseWheel Löst das Control.MouseWheel-Ereignis aus. (Von DataGridViewElement geerbt.)
Geschützte Methode SetValue Legt den Wert der Zelle fest.
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt beschreibt. (Überschreibt Object.ToString().)
Zum Seitenanfang

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

Die Zeile und die Spalte für eine DataGridViewCell identifizieren die Position der Zelle in der DataGridView. Eine typische Zelle enthält spezifische Daten für die Zeile und die Spalte, in der sie enthalten ist. Die Zelle kann verschiedentlich angepasst werden, indem ihre Eigenschaften festgelegt und die ihr zugeordneten Ereignisse behandelt werden.

Hinweise zur Vererbung

Wenn Sie aus DataGridViewCell ableiten und der abgeleiteten Klasse neue Eigenschaften hinzufügen, muss die Clone-Methode überschrieben werden, damit die neuen Eigenschaften während der Klonvorgänge kopiert werden. Sie sollten auch die Clone-Methode der Basisklasse aufrufen, damit die Eigenschaften der Basisklasse in die neue Zelle kopiert werden.

Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht. Weitere Informationen zu diesem Beispiel finden Sie unter Gewusst wie: Hinzufügen von QuickInfos zu einzelnen Zellen in einem DataGridView-Steuerelement in Windows Forms.

C#
C++
VB
Kopieren 

// 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";
        }
    }
}

.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ