DataGridViewImageCell Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Zeigt in einem DataGridView-Steuerelement eine Grafik an.

public ref class DataGridViewImageCell : System::Windows::Forms::DataGridViewCell

public class DataGridViewImageCell : System.Windows.Forms.DataGridViewCell

type DataGridViewImageCell = class
    inherit DataGridViewCell

Public Class DataGridViewImageCell
Inherits DataGridViewCell

Vererbung

Object

DataGridViewElement

DataGridViewCell

DataGridViewImageCell

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das Bild in einer Bildzelle mithilfe von geändert wird DataGridViewCell. Dieses Codebeispiel ist Teil eines größeren Beispiels für das Thema Vorgehensweise: Arbeiten mit Bildspalten im Windows Forms DataGridView-Steuerelement.

void dataGridView1_CellClick( Object^ sender, DataGridViewCellEventArgs^ e )
{
   if ( turn->Equals( gameOverString ) )
   {
      return;
   }

   DataGridViewImageCell^ cell = dynamic_cast<DataGridViewImageCell^>(dataGridView1->Rows[ e->RowIndex ]->Cells[ e->ColumnIndex ]);
   if ( cell->Value == blank )
   {
      if ( IsOsTurn() )
      {
         cell->Value = o;
      }
      else
      {
         cell->Value = x;
      }

      ToggleTurn();
   }

   if ( IsAWin( cell ) )
   {
      turn->Text = gameOverString;
   }
}

private void dataGridView1_CellClick(object sender,
    DataGridViewCellEventArgs e)
{

    if (turn.Text.Equals(gameOverString)) { return; }

    DataGridViewImageCell cell = (DataGridViewImageCell)
        dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];

    if (cell.Value == blank)
    {
        if (IsOsTurn())
        {
            cell.Value = o;
        }
        else
        {
            cell.Value = x;
        }
        ToggleTurn();
    }
    if (IsAWin())
    {
        turn.Text = gameOverString;
    }
}

Private Sub dataGridView1_CellClick(ByVal sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellClick

    If turn.Text.Equals(gameOverString) Then Return

    Dim cell As DataGridViewImageCell = _
        CType(dataGridView1.Rows(e.RowIndex). _
            Cells(e.ColumnIndex), DataGridViewImageCell)
    If (cell.Value Is blank) Then
        If IsOsTurn() Then
            cell.Value = o
        Else
            cell.Value = x
        End If
        ToggleTurn()
        ToolTip(e)
    End If
    If IsAWin() Then
        turn.Text = gameOverString
    End If
End Sub

Hinweise

Die DataGridViewImageCell -Klasse ist ein spezialisierter Typ von, der DataGridViewCell zum Anzeigen eines Image oder einer Iconverwendet wird, abhängig vom Wert der ValueIsIcon Eigenschaft. In der Regel wird die ReadOnly -Eigenschaft von DataGridViewImageCell auf true festgelegt, um anzugeben, dass der Benutzer den Zellinhalt nicht bearbeiten kann.

ist DataGridViewImageColumn der Spaltentyp, der auf Zellen dieses Typs spezialisiert ist. Standardmäßig wird mit DataGridViewImageColumn.CellTemplate einem neuen DataGridViewImageCellinitialisiert. Um die Zellen in einer Spalte nach einem vorhandenen DataGridViewImageCellzu mustern, legen Sie die -Eigenschaft der Spalte CellTemplate auf die Zelle fest, die als Muster verwendet werden soll.

Die zellenbezogenen Eigenschaften der Spalte sind Wrapper für die ähnlich benannten Eigenschaften der Vorlagenzelle. Das Ändern der Eigenschaftswerte der Vorlagenzelle wirkt sich nur auf Zellen basierend auf der Vorlage aus, die nach der Änderung hinzugefügt werden. Wenn Sie jedoch die zellbezogenen Eigenschaftswerte der Spalte ändern, werden die Vorlagenzelle und alle anderen Zellen in der Spalte aktualisiert, und die Spaltenanzeige wird bei Bedarf aktualisiert.

Hinweise für Vererber

Wenn Sie von DataGridViewImageCell abgeleitet werden und der abgeleiteten Klasse neue Eigenschaften hinzufügen, müssen Sie die Clone() -Methode überschreiben, um die neuen Eigenschaften während des Klonvorgangs zu kopieren. Sie sollten auch die -Methode der Basisklasse Clone() aufrufen, damit die Eigenschaften der Basisklasse in die neue Zelle kopiert werden.

Konstruktoren

DataGridViewImageCell()	Initialisiert eine neue Instanz der DataGridViewImageCell-Klasse und konfiguriert diese für die Verwendung mit Zellwerten, die keine Icon-Objekte sind.
DataGridViewImageCell(Boolean)	Initialisiert eine neue Instanz der DataGridViewImageCell-Klasse und konfiguriert sie optional für eine Verwendung mit Icon-Zellwerten.

Eigenschaften

AccessibilityObject	Ruft das der DataGridViewCell.DataGridViewCellAccessibleObject zugewiesene DataGridViewCell ab. (Geerbt von DataGridViewCell)
ColumnIndex	Ruft den Spaltenindex für diese Zelle ab. (Geerbt von DataGridViewCell)
ContentBounds	Ruft das den Inhaltsbereich der Zelle umschließende Rechteck ab. (Geerbt von DataGridViewCell)
ContextMenuStrip	Ruft das der Zelle zugeordnete Kontextmenü ab oder legt dieses fest. (Geerbt von DataGridViewCell)
DataGridView	Ruft das diesem Element zugeordnete DataGridView-Steuerelement ab. (Geerbt von DataGridViewElement)
DefaultNewRowValue	Ruft den Standardwert ab, der beim Erstellen einer neuen Zeile verwendet wird.
Description	Ruft den dem Bild zugeordneten Text ab oder legt diesen fest.
Displayed	Ruft einen Wert ab, der angibt, ob die Zelle momentan auf dem Bildschirm angezeigt wird. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
EditType	Ruft den Typ des gehosteten Bearbeitungssteuerelements der Zelle ab.
ErrorIconBounds	Ruft die Begrenzungen des Fehlersymbols für die Zelle ab. (Geerbt von DataGridViewCell)
ErrorText	Ruft den Text ab, mit dem ein der Zelle zugeordneter Fehlerzustand beschrieben wird, oder legt diesen Text fest. (Geerbt von DataGridViewCell)
FormattedValue	Ruft den zum Anzeigen formatierten Wert der Zelle ab. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
HasStyle	Ruft einen Wert ab, der angibt, ob die Style-Eigenschaft festgelegt wurde. (Geerbt von DataGridViewCell)
ImageLayout	Ruft das Grafiklayout für die Zelle ab oder legt es fest.
InheritedState	Ruft den aktuellen Zustand der Zelle ab, der vom Zustand ihrer Zeile und Spalte geerbt wurde. (Geerbt von DataGridViewCell)
InheritedStyle	Ruft den gegenwärtig auf die Zelle angewendeten Stil ab. (Geerbt von DataGridViewCell)
IsInEditMode	Ruft einen Wert ab, der angibt, ob diese Zelle derzeit bearbeitet wird. (Geerbt von DataGridViewCell)
OwningColumn	Ruft die diese Zelle enthaltende Spalte ab. (Geerbt von DataGridViewCell)
OwningRow	Ruft die diese Zelle enthaltende Zeile ab. (Geerbt von DataGridViewCell)
PreferredSize	Ruft die Größe eines rechteckigen Bereichs in Pixel ab, in den die Zelle eingepasst werden kann. (Geerbt von DataGridViewCell)
ReadOnly	Ruft einen Wert ab, der angibt, ob die Zelldaten bearbeitet werden können, oder legt diesen Wert fest. (Geerbt von DataGridViewCell)
Resizable	Ruft einen Wert ab, der angibt, ob die Größe der Zelle geändert werden kann. (Geerbt von DataGridViewCell)
RowIndex	Ruft den Index der übergeordneten Zeile der Zelle ab. (Geerbt von DataGridViewCell)
Selected	Ruft einen Wert ab, der angibt, ob die Zelle ausgewählt wurde, oder legt diesen fest. (Geerbt von DataGridViewCell)
Size	Ruft die Größe der Zelle ab. (Geerbt von DataGridViewCell)
State	Ruft den Benutzeroberflächenzustand des Elements ab. (Geerbt von DataGridViewElement)
Style	Ruft den Stil für die Zelle ab oder legt ihn fest. (Geerbt von DataGridViewCell)
Tag	Ruft das Objekt ab, das zusätzliche Daten zur Zelle enthält, oder legt dieses fest. (Geerbt von DataGridViewCell)
ToolTipText	Ruft den dieser Zelle zugeordneten QuickInfo-Text ab oder legt diesen fest. (Geerbt von DataGridViewCell)
Value	Ruft den dieser Zelle zugeordneten Wert ab oder legt ihn fest. (Geerbt von DataGridViewCell)
ValueIsIcon	Ruft einen Wert ab, der angibt, ob diese Zelle einen Icon-Wert anzeigt, oder legt diesen 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. (Geerbt von DataGridViewCell)

Methoden

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Ändert die Rahmenart der Eingabezelle entsprechend den angegebenen Kriterien. (Geerbt von DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Gibt ein Rectangle zurück, das die Breite aller Zellränder darstellt. (Geerbt von DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Gibt an, ob die Freigabe für die Zeile der Zelle aufgehoben wird, wenn auf die Zelle geklickt wird. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Gibt an, ob die Freigabe für die Zeile der Zelle aufgehoben wird, wenn auf den Inhalt der Zelle doppelgeklickt wird. (Geerbt von DataGridViewCell)
CreateAccessibilityInstance()	Erstellt ein neues barrierefreies Objekt für die DataGridViewImageCell.
DetachEditingControl()	Entfernt das Bearbeitungssteuerelement der Zelle aus der DataGridView. (Geerbt von DataGridViewCell)
Dispose()	Gibt alle vom DataGridViewCell verwendeten Ressourcen frei. (Geerbt von DataGridViewCell)
Dispose(Boolean)	Gibt die von DataGridViewCell verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Gibt an, ob die Freigabe für die Zeile der Zelle aufgehoben wird, wenn auf die Zelle doppelgeklickt wird. (Geerbt von DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Gibt an, ob die Freigabe der übergeordneten Zeile aufgehoben wird, wenn die Zelle den Fokus erhält. (Geerbt von DataGridViewCell)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Ruft den formatierten Wert der Zelle ab, der nach Clipboard kopiert werden soll. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Gibt eine Grafik zurück, wie sie in der Zelle angezeigt wird.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetInheritedContextMenuStrip(Int32)	Ruft das geerbte Kontextmenü für die aktuelle Zelle ab. (Geerbt von DataGridViewCell)
GetInheritedState(Int32)	Gibt einen Wert zurück, der den aktuellen Zustand der Zelle angibt, der vom Zustand der entsprechenden Zeile und Spalte geerbt wurde. (Geerbt von DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Ruft den auf die Zelle angewendeten Stil ab. (Geerbt von DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Berechnet die geeignete Größe der Zelle (in Pixel).
GetSize(Int32)	Ruft die Größe der Zelle ab. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	Bestimmt, ob der Bearbeitungsmodus mit der angegebenen Taste gestartet werden soll. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn eine Zelle in der Zeile den Fokus verliert. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Benutzer auf eine Zelle in der Zeile doppelklickt. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Mauszeiger über eine Zelle in der Zeile bewegt wird. (Geerbt von DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Mauszeiger aus der Zeile heraus bewegt wird. (Geerbt von DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Gibt an, ob die Freigabe einer Zeile aufgehoben wird, wenn der Mauszeiger über eine Zelle in der Zeile bewegt wird. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Wird beim Klicken auf die Zelle aufgerufen. (Geerbt von DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Wird beim Klicken auf den Inhalt der Zelle aufgerufen. (Geerbt von DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Wird beim Doppelklicken auf den Inhalt der Zelle aufgerufen. (Geerbt von DataGridViewCell)
OnDataGridViewChanged()	Wird aufgerufen, wenn sich die DataGridView-Eigenschaft der Zelle ändert. (Geerbt von DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Wird beim Doppelklicken auf die Zelle aufgerufen. (Geerbt von DataGridViewCell)
OnEnter(Int32, Boolean)	Wird aufgerufen, wenn eine Zelle den Fokus erhält. (Geerbt von DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Wird aufgerufen, wenn eine Zeichentaste gedrückt wird, während der Fokus auf einer Zelle ist. (Geerbt von DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Wird aufgerufen, wenn eine Taste gedrückt wird, während sich der Fokus auf einer Zelle befindet. (Geerbt von DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Wird aufgerufen, wenn eine Zeichentaste losgelassen wird, während der Fokus auf einer Zelle liegt. (Geerbt von DataGridViewCell)
OnLeave(Int32, Boolean)	Wird aufgerufen, wenn eine Zelle den Fokus verliert. (Geerbt von DataGridViewCell)
OnMouseClick(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer eine Maustaste drückt, während sich der Mauszeiger in einer Zelle befindet. (Geerbt von DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer einen Doppelklick mit einer Maustaste ausführt, während sich der Mauszeiger in einer Zelle befindet. (Geerbt von DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer eine Maustaste gedrückt hält, während sich der Mauszeiger in einer Zelle befindet. (Geerbt von DataGridViewCell)
OnMouseEnter(Int32)	Wird aufgerufen, wenn der Mauszeiger über eine Zelle bewegt wird. (Geerbt von DataGridViewCell)
OnMouseLeave(Int32)	Wird aufgerufen, wenn der Mauszeiger den Bereich der Zelle verlässt. (Geerbt von DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Mauszeiger innerhalb einer Zelle bewegt wird. (Geerbt von DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Wird aufgerufen, wenn der Benutzer eine Maustaste loslässt, während sich der Mauszeiger in einer Zelle befindet. (Geerbt von DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Zeichnet die aktuelle DataGridViewImageCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Zeichnet den Rahmen der aktuellen DataGridViewCell. (Geerbt von DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Zeichnet das Fehlersymbol der aktuellen DataGridViewCell. (Geerbt von DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Konvertiert einen zum Anzeigen formatierten Wert in einen tatsächlichen Zellwert. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
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. (Geerbt von DataGridViewCell)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt beschreibt.

Weitere Informationen

• DataGridView
• DataGridViewCell
• DataGridViewImageColumn
• CellTemplate
• Image
• Icon
• ValueIsIcon