DataGridViewImageCell Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DataGridViewImageCell.cs

Visualizza un elemento grafico in un DataGridView controllo .

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

Ereditarietà

Object

DataGridViewElement

DataGridViewCell

DataGridViewImageCell

Esempio

Nell'esempio di codice seguente viene illustrato come modificare l'immagine in una cella immagine usando DataGridViewCell. Questo esempio di codice fa parte di un esempio più ampio fornito per l'argomento How to: Work with Image Columns in the Windows Forms DataGridView Control.This code example is part of a larger example provided for the topic How to: Work with Image Columns in the Windows Forms DataGridView Control.

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

Commenti

La DataGridViewImageCell classe è un tipo specializzato di DataGridViewCell utilizzato per visualizzare un oggetto Image o , Icona seconda del valore della ValueIsIcon proprietà . In genere, la ReadOnly proprietà di un DataGridViewImageCell oggetto è impostata su true per indicare che l'utente non può modificare il contenuto della cella.

DataGridViewImageColumn è il tipo di colonna specializzato per contenere le celle di questo tipo. Per impostazione predefinita, l'oggetto DataGridViewImageColumn.CellTemplate viene inizializzato in un nuovo DataGridViewImageCelloggetto . Per creare un pattern per le celle all'interno di una colonna dopo un oggetto esistente DataGridViewImageCell, impostare la proprietà della CellTemplate colonna sulla cella da utilizzare come criterio.

Le proprietà correlate alla cella della colonna sono wrapper per le proprietà denominate in modo analogo della cella del modello. La modifica dei valori delle proprietà della cella modello influirà solo sulle celle in base al modello aggiunto dopo la modifica. Se necessario, la modifica dei valori delle proprietà correlate alla cella della colonna aggiornerà la cella del modello e tutte le altre celle della colonna e aggiornerà la visualizzazione della colonna, se necessario.

Note per gli eredi

Quando si deriva da DataGridViewImageCell e si aggiungono nuove proprietà alla classe derivata, assicurarsi di eseguire l'override del Clone() metodo per copiare le nuove proprietà durante le operazioni di clonazione. È anche necessario chiamare il metodo della classe base Clone() in modo che le proprietà della classe di base vengano copiate nella nuova cella.

Costruttori

Nome	Descrizione
DataGridViewImageCell()	Inizializza una nuova istanza della DataGridViewImageCell classe, configurandola per l'uso con valori di cella diversi dagli Icon oggetti .
DataGridViewImageCell(Boolean)	Inizializza una nuova istanza della DataGridViewImageCell classe, facoltativamente configurandola per l'uso con Icon i valori delle celle.

Proprietà

Nome	Descrizione
AccessibilityObject	Ottiene l'oggetto DataGridViewCell.DataGridViewCellAccessibleObject assegnato all'oggetto DataGridViewCell. (Ereditato da DataGridViewCell)
ColumnIndex	Ottiene l'indice di colonna per questa cella. (Ereditato da DataGridViewCell)
ContentBounds	Ottiene il rettangolo di delimitazione che racchiude l'area del contenuto della cella. (Ereditato da DataGridViewCell)
ContextMenuStrip	Ottiene o imposta il menu di scelta rapida associato alla cella. (Ereditato da DataGridViewCell)
DataGridView	Ottiene il DataGridView controllo associato a questo elemento. (Ereditato da DataGridViewElement)
DefaultNewRowValue	Ottiene il valore predefinito utilizzato durante la creazione di una nuova riga.
Description	Ottiene o imposta il testo associato all'immagine.
Displayed	Ottiene un valore che indica se la cella è attualmente visualizzata sullo schermo. (Ereditato da DataGridViewCell)
EditedFormattedValue	Ottiene il valore corrente formattato della cella, indipendentemente dal fatto che la cella sia in modalità di modifica e il valore non sia stato eseguito il commit. (Ereditato da DataGridViewCell)
EditType	Ottiene il tipo del controllo di modifica ospitato della cella.
ErrorIconBounds	Ottiene i limiti dell'icona di errore per la cella. (Ereditato da DataGridViewCell)
ErrorText	Ottiene o imposta il testo che descrive una condizione di errore associata alla cella. (Ereditato da DataGridViewCell)
FormattedValue	Ottiene il valore della cella come formattato per la visualizzazione. (Ereditato da DataGridViewCell)
FormattedValueType	Ottiene il tipo del valore formattato associato alla cella.
Frozen	Ottiene un valore che indica se la cella è bloccata. (Ereditato da DataGridViewCell)
HasStyle	Ottiene un valore che indica se la Style proprietà è stata impostata. (Ereditato da DataGridViewCell)
ImageLayout	Ottiene o imposta il layout grafico per la cella.
InheritedState	Ottiene lo stato corrente della cella ereditato dallo stato della riga e della colonna. (Ereditato da DataGridViewCell)
InheritedStyle	Ottiene lo stile attualmente applicato alla cella. (Ereditato da DataGridViewCell)
IsInEditMode	Ottiene un valore che indica se la cella è attualmente in fase di modifica. (Ereditato da DataGridViewCell)
OwningColumn	Ottiene la colonna che contiene questa cella. (Ereditato da DataGridViewCell)
OwningRow	Ottiene la riga contenente la cella. (Ereditato da DataGridViewCell)
PreferredSize	Ottiene le dimensioni, in pixel, di un'area rettangolare in cui è possibile adattare la cella. (Ereditato da DataGridViewCell)
ReadOnly	Ottiene o imposta un valore che indica se i dati della cella possono essere modificati. (Ereditato da DataGridViewCell)
Resizable	Ottiene un valore che indica se la cella può essere ridimensionata. (Ereditato da DataGridViewCell)
RowIndex	Ottiene l'indice della riga padre della cella. (Ereditato da DataGridViewCell)
Selected	Ottiene o imposta un valore che indica se la cella è stata selezionata. (Ereditato da DataGridViewCell)
Size	Ottiene le dimensioni della cella. (Ereditato da DataGridViewCell)
State	Ottiene lo stato dell'interfaccia utente dell'elemento. (Ereditato da DataGridViewElement)
Style	Ottiene o imposta lo stile per la cella. (Ereditato da DataGridViewCell)
Tag	Ottiene o imposta l'oggetto che contiene dati supplementari sulla cella. (Ereditato da DataGridViewCell)
ToolTipText	Ottiene o imposta il testo della descrizione comando associato a questa cella. (Ereditato da DataGridViewCell)
Value	Ottiene o imposta il valore associato a questa cella. (Ereditato da DataGridViewCell)
ValueIsIcon	Ottiene o imposta un valore che indica se la cella visualizza un Icon valore.
ValueType	Ottiene o imposta il tipo di dati dei valori nella cella.
Visible	Ottiene un valore che indica se la cella si trova in una riga o in una colonna nascosta. (Ereditato da DataGridViewCell)

Metodi

Nome	Descrizione
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifica lo stile del bordo della cella di input in base ai criteri specificati. (Ereditato da DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Restituisce un oggetto Rectangle che rappresenta la larghezza di tutti i margini della cella. (Ereditato da DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Indica se la riga della cella verrà annullata quando si fa clic sulla cella. (Ereditato da DataGridViewCell)
Clone()	Crea una copia esatta di questa cella.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Indica se la riga della cella verrà annullata quando si fa clic sul contenuto della cella. (Ereditato da DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se la riga della cella verrà annullata quando si fa doppio clic sul contenuto della cella. (Ereditato da DataGridViewCell)
CreateAccessibilityInstance()	Crea un nuovo oggetto accessibile per .DataGridViewImageCell
DetachEditingControl()	Rimuove il controllo di modifica della cella da DataGridView. (Ereditato da DataGridViewCell)
Dispose()	Rilascia tutte le risorse usate da DataGridViewCell. (Ereditato da DataGridViewCell)
Dispose(Boolean)	Rilascia le risorse non gestite usate da DataGridViewCell e, facoltativamente, rilascia le risorse gestite. (Ereditato da DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se la riga della cella verrà annullata quando si fa doppio clic sulla cella. (Ereditato da DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Indica se la riga padre verrà annullata quando lo stato attivo passa alla cella. (Ereditato da DataGridViewCell)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Recupera il valore formattato della cella da copiare nell'oggetto Clipboard. (Ereditato da DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Restituisce il rettangolo di delimitazione che racchiude l'area di contenuto della cella, calcolata utilizzando lo stile specificato Graphics e della cella.
GetContentBounds(Int32)	Restituisce il rettangolo di delimitazione che racchiude l'area di contenuto della cella utilizzando uno stile predefinito Graphics e di cella attualmente attivo per la cella. (Ereditato da DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Restituisce il valore corrente formattato della cella, indipendentemente dal fatto che la cella sia in modalità di modifica e che il valore non sia stato eseguito. (Ereditato da DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Restituisce il rettangolo di delimitazione che racchiude l'icona di errore della cella, se visualizzata.
GetErrorText(Int32)	Restituisce una stringa che rappresenta l'errore per la cella. (Ereditato da DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Restituisce un elemento grafico come verrebbe visualizzato nella cella.
GetInheritedContextMenuStrip(Int32)	Ottiene il menu di scelta rapida ereditato per la cella corrente. (Ereditato da DataGridViewCell)
GetInheritedState(Int32)	Restituisce un valore che indica lo stato corrente della cella ereditato dallo stato della riga e della colonna. (Ereditato da DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Ottiene lo stile applicato alla cella. (Ereditato da DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Calcola le dimensioni preferite, in pixel, della cella.
GetSize(Int32)	Ottiene le dimensioni della cella. (Ereditato da DataGridViewCell)
GetValue(Int32)	Ottiene il valore della cella.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Inizializza il controllo utilizzato per modificare la cella. (Ereditato da DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Indica se la riga padre non è condivisa se l'utente preme un tasto mentre lo stato attivo si trova nella cella. (Ereditato da DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	Determina se la modalità di modifica deve essere avviata in base alla chiave specificata. (Ereditato da DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Indica se una riga verrà annullata se viene premuto un tasto mentre una cella della riga ha lo stato attivo. (Ereditato da DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indica se la riga padre non è condivisa quando l'utente rilascia un tasto mentre lo stato attivo si trova sulla cella. (Ereditato da DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Indica se una riga verrà annullata quando lo stato attivo lascia una cella nella riga. (Ereditato da DataGridViewCell)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se una riga verrà annullata se l'utente fa clic su un pulsante del mouse mentre il puntatore si trova in una cella della riga. (Ereditato da DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se una riga verrà annullata se l'utente fa doppio clic su una cella nella riga. (Ereditato da DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se una riga verrà annullata quando l'utente tiene premuto un pulsante del mouse mentre il puntatore si trova in una cella della riga. (Ereditato da DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Indica se una riga verrà annullata quando il puntatore del mouse si sposta su una cella della riga. (Ereditato da DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Indica se una riga verrà annullata quando il puntatore del mouse lascia la riga. (Ereditato da DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se una riga verrà annullata quando il puntatore del mouse si sposta su una cella della riga. (Ereditato da DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se una riga verrà annullata quando l'utente rilascia un pulsante del mouse mentre il puntatore si trova in una cella della riga. (Ereditato da DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Chiamato quando si fa clic sulla cella. (Ereditato da DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Viene chiamato quando si fa clic sul contenuto della cella. (Ereditato da DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Chiamato quando si fa doppio clic sul contenuto della cella. (Ereditato da DataGridViewCell)
OnDataGridViewChanged()	Chiamato quando viene modificata la DataGridView proprietà della cella. (Ereditato da DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Chiamato quando si fa doppio clic sulla cella. (Ereditato da DataGridViewCell)
OnEnter(Int32, Boolean)	Chiamato quando lo stato attivo passa a una cella. (Ereditato da DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Chiamato quando viene premuto un tasto carattere mentre lo stato attivo si trova su una cella. (Ereditato da DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Chiamato quando viene premuto un tasto mentre lo stato attivo si trova su una cella. (Ereditato da DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Chiamato quando viene rilasciato un tasto carattere mentre lo stato attivo si trova su una cella. (Ereditato da DataGridViewCell)
OnLeave(Int32, Boolean)	Chiamato quando lo stato attivo si sposta da una cella. (Ereditato da DataGridViewCell)
OnMouseClick(DataGridViewCellMouseEventArgs)	Chiamato quando l'utente fa clic su un pulsante del mouse mentre il puntatore si trova in una cella. (Ereditato da DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Chiamato quando l'utente fa doppio clic su un pulsante del mouse mentre il puntatore si trova in una cella. (Ereditato da DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Chiamato quando l'utente tiene premuto un pulsante del mouse mentre il puntatore si trova in una cella. (Ereditato da DataGridViewCell)
OnMouseEnter(Int32)	Chiamato quando il puntatore del mouse si sposta su una cella. (Ereditato da DataGridViewCell)
OnMouseLeave(Int32)	Chiamato quando il puntatore del mouse lascia la cella. (Ereditato da DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Chiamato quando il puntatore del mouse si sposta all'interno di una cella. (Ereditato da DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Chiamato quando l'utente rilascia un pulsante del mouse mentre il puntatore si trova in una cella. (Ereditato da DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Disegna l'oggetto corrente DataGridViewImageCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Disegna il bordo dell'oggetto corrente DataGridViewCell. (Ereditato da DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Disegna l'icona di errore dell'oggetto corrente DataGridViewCell. (Ereditato da DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Converte un valore formattato per la visualizzazione in un valore di cella effettivo. (Ereditato da DataGridViewCell)
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Imposta la posizione e le dimensioni del controllo di modifica ospitato da una cella nel DataGridView controllo . (Ereditato da DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Imposta la posizione e le dimensioni del pannello di modifica ospitato dalla cella e restituisce i limiti normali del controllo di modifica all'interno del pannello di modifica. (Ereditato da DataGridViewCell)
RaiseCellClick(DataGridViewCellEventArgs)	Genera l'evento CellClick. (Ereditato da DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Genera l'evento CellContentClick. (Ereditato da DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Genera l'evento CellContentDoubleClick. (Ereditato da DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Genera l'evento CellValueChanged. (Ereditato da DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Genera l'evento DataError. (Ereditato da DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Genera l'evento MouseWheel. (Ereditato da DataGridViewElement)
SetValue(Int32, Object)	Imposta il valore della cella. (Ereditato da DataGridViewCell)
ToString()	Restituisce una stringa che descrive l'oggetto corrente.

Vedi anche

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