DataGridViewCell Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta una singola cella in un controllo DataGridView.

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

Ereditarietà: Object

DataGridViewElement
DataGridViewCell

Derivato: System.Windows.Forms.DataGridViewButtonCell

System.Windows.Forms.DataGridViewCheckBoxCell

System.Windows.Forms.DataGridViewComboBoxCell

System.Windows.Forms.DataGridViewHeaderCell

System.Windows.Forms.DataGridViewImageCell

Altro…

Attributi: TypeConverterAttribute

Implementazioni: ICloneable IDisposable

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo tipo. Per altre informazioni su questo esempio, vedere Procedura: Aggiungere descrizioni comando a singole celle in un controllo DataGridView Windows Forms.

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

Commenti

La DataGridViewCell classe rappresenta una singola cella in un DataGridView controllo . È possibile recuperare le celle tramite la Cells raccolta di un oggetto DataGridViewRow.

Riga e colonna per un'identificazione DataGridViewCell della posizione della cella in DataGridView. Una cella tipica contiene dati specifici della riga e della colonna in cui è contenuta. La cella può essere personalizzata in diversi modi impostandone le proprietà e gestendo gli eventi associati.

Note per gli implementatori

Quando si deriva da DataGridViewCell 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 di Clone() base in modo che le proprietà della classe di base vengano copiate nella nuova cella.

Costruttori

DataGridViewCell()

Inizializza una nuova istanza della classe DataGridViewCell.

Proprietà

AccessibilityObject	Ottiene l'oggetto DataGridViewCell.DataGridViewCellAccessibleObject assegnato a DataGridViewCell.
ColumnIndex	Ottiene l'indice della colonna per la cella.
ContentBounds	Ottiene il rettangolo di delimitazione che racchiude l'area del contenuto della cella.
ContextMenuStrip	Ottiene o imposta il menu di scelta rapida associato alla cella.
DataGridView	Ottiene il controllo DataGridView associato a questo elemento. (Ereditato da DataGridViewElement)
DefaultNewRowValue	Ottiene il valore predefinito per una cella nella riga per i nuovi record.
Displayed	Ottiene un valore che indica se la cella è attualmente visualizzata su schermo.
EditedFormattedValue	Ottiene il valore formattato corrente della cella, indipendentemente dal fatto che la cella sia in modalità di modifica e che non sia stato eseguito il commit del valore.
EditType	Ottiene il tipo del controllo di modifica contenuto della cella.
ErrorIconBounds	Ottiene i limiti dell'icona di errore per la cella.
ErrorText	Ottiene o imposta il testo che descrive la condizione di errore associata alla cella.
FormattedValue	Ottiene il valore della cella formattato per la visualizzazione.
FormattedValueType	Ottiene il tipo del valore formattato associato alla cella.
Frozen	Ottiene un valore che indica se la cella è bloccata.
HasStyle	Ottiene un valore che indica se la proprietà Style è stata impostata.
InheritedState	Ottiene lo stato corrente della cella, ereditato dallo stato della relativa riga e colonna.
InheritedStyle	Ottiene lo stile attualmente applicato alla cella.
IsInEditMode	Ottiene un valore che indica se la cella è attualmente in fase di modifica.
OwningColumn	Ottiene la colonna contenente questa cella.
OwningRow	Ottiene la riga contenente questa cella.
PreferredSize	Ottiene le dimensioni in pixel di un'area rettangolare in cui è possibile inserire la cella.
ReadOnly	Ottiene o imposta un valore che indica se è possibile modificare i dati della cella.
Resizable	Ottiene un valore che indica se è possibile ridimensionare la cella.
RowIndex	Ottiene l'indice della riga padre della cella.
Selected	Ottiene o imposta un valore che indica se la cella è stata selezionata.
Size	Ottiene le dimensioni della cella.
State	Ottiene lo stato dell'interfaccia utente dell'elemento. (Ereditato da DataGridViewElement)
Style	Ottiene o imposta lo stile della cella.
Tag	Ottiene o imposta l'oggetto contenente dati aggiuntivi relativi alla cella.
ToolTipText	Ottiene o imposta il testo della descrizione comandi associato a questa cella.
Value	Ottiene o imposta il valore associato a questa cella.
ValueType	Ottiene o imposta il tipo di dati dei valori della cella.
Visible	Ottiene un valore che indica se la cella si trova in una riga o colonna nascosta.

Metodi

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifica lo stile del bordo della cella di input in base ai criteri specificati.
BorderWidths(DataGridViewAdvancedBorderStyle)	Restituisce una struttura Rectangle che rappresenta le larghezze di tutti i margini delle celle.
ClickUnsharesRow(DataGridViewCellEventArgs)	Indica se verrà annullata la condivisione della riga contenente la cella quando viene fatto clic sulla cella.
Clone()	Crea una copia esatta della cella.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Indica se verrà annullata la condivisione della riga contenente la cella quando viene fatto clic sul contenuto della cella.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se verrà annullata la condivisione della riga contenente la cella quando viene fatto doppio clic sul contenuto della cella.
CreateAccessibilityInstance()	Crea un nuovo oggetto accessibile per DataGridViewCell.
DetachEditingControl()	Rimuove il controllo di modifica della cella da DataGridView.
Dispose()	Rilascia tutte le risorse usate da DataGridViewCell.
Dispose(Boolean)	Rilascia le risorse non gestite usate da DataGridViewCell e, facoltativamente, le risorse gestite.
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Indica se verrà annullata la condivisione della riga contenente la cella quando viene fatto doppio clic sulla cella.
EnterUnsharesRow(Int32, Boolean)	Indica se verrà annullata la condivisione della riga padre quando lo stato attivo si sposta sulla cella.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Finalize()	Libera le risorse non gestite ed esegue altre operazioni di pulitura prima che l'oggetto DataGridViewCell venga recuperato dalla procedura di Garbage Collection.
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Recupera il valore formattato della cella da copiare nell'oggetto Clipboard.
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Restituisce il rettangolo delimitatore che racchiude l'area di contenuto della cella, calcolato usando l'oggetto Graphics e lo stile della cella specificati.
GetContentBounds(Int32)	Restituisce il rettangolo di delimitazione che racchiude l'area del contenuto della cella mediante una classe Graphics predefinita e lo stile della cella attualmente utilizzato.
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Restituisce il valore formattato corrente della cella, indipendentemente dal fatto che la cella sia in modalità di modifica e che non sia stato eseguito il commit del valore.
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.
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Ottiene il valore della cella formattato per la visualizzazione.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetInheritedContextMenuStrip(Int32)	Ottiene il menu di scelta rapida ereditato per la cella corrente.
GetInheritedState(Int32)	Restituisce un valore che indica lo stato corrente della cella, ereditato dallo stato della relativa riga e colonna.
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Ottiene lo stile applicato alla cella.
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Calcola le dimensioni preferenziali, in pixel, della cella.
GetSize(Int32)	Ottiene le dimensioni della cella.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(Int32)	Ottiene il valore della cella.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Inizializza il controllo usato per la modifica della cella.
KeyDownUnsharesRow(KeyEventArgs, Int32)	Indica se verrà annullata la condivisione della riga padre quando l'utente preme un pulsante mentre è attiva la cella.
KeyEntersEditMode(KeyEventArgs)	Determina se la modalità di modifica deve essere avviata in base al tasto premuto.
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Indica se verrà annullata la condivisione della riga quando viene premuto un tasto mentre è attiva una cella nella riga.
KeyUpUnsharesRow(KeyEventArgs, Int32)	Indica se verrà annullata la condivisione della riga padre quando l'utente rilascia un pulsante mentre è attiva la cella.
LeaveUnsharesRow(Int32, Boolean)	Indica se verrà annullata la condivisione di una riga quando la cella nella riga perde lo stato attivo.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)	Ottiene l'altezza, in pixel, del testo specificato considerando le caratteristiche specificate.
MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)	Ottiene l'altezza, in pixel, del testo specificato considerando le caratteristiche specificate. Indica inoltre se la larghezza richiesta è maggiore della larghezza massima specificata.
MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)	Ottiene l'altezza e la larghezza ideali del testo specificato considerando le caratteristiche specificate.
MeasureTextSize(Graphics, String, Font, TextFormatFlags)	Ottiene l'altezza e la larghezza del testo specificato considerando le caratteristiche specificate.
MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)	Ottiene la larghezza, in pixel, del testo specificato considerando le caratteristiche specificate.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se verrà annullata la condivisione di una riga quando l'utente fa clic su un pulsante del mouse con il puntatore posizionato in una cella della riga.
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se verrà annullata la condivisione di una riga quando l'utente fa doppio clic su una cella della riga.
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se verrà annullata la condivisione di una riga quando l'utente tiene premuto un pulsante del mouse con il puntatore posizionato in una cella della riga.
MouseEnterUnsharesRow(Int32)	Indica se verrà annullata la condivisione di una riga quando il puntatore del mouse viene spostato su una cella della riga.
MouseLeaveUnsharesRow(Int32)	Indica se verrà annullata la condivisione di una riga quando si sposta il puntatore del mouse da tale riga.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se verrà annullata la condivisione di una riga quando il puntatore del mouse viene spostato su una cella della riga.
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Indica se verrà annullata la condivisione di una riga quando l'utente rilascia un pulsante del mouse con il puntatore posizionato in una cella della riga.
OnClick(DataGridViewCellEventArgs)	Chiamato quando si fa clic sulla cella.
OnContentClick(DataGridViewCellEventArgs)	Chiamato quando si fa clic sul contenuto della cella.
OnContentDoubleClick(DataGridViewCellEventArgs)	Chiamato quando si fa doppio clic sul contenuto della cella.
OnDataGridViewChanged()	Viene chiamato quando cambia la proprietà DataGridView della cella.
OnDoubleClick(DataGridViewCellEventArgs)	Chiamato quando si fa doppio clic sulla cella.
OnEnter(Int32, Boolean)	Chiamato quando lo stato attivo si sposta su una cella.
OnKeyDown(KeyEventArgs, Int32)	Chiamato quando viene premuto il tasto di una carattere mentre è attiva una cella.
OnKeyPress(KeyPressEventArgs, Int32)	Chiamato quando viene premuto un tasto mentre è attiva una cella.
OnKeyUp(KeyEventArgs, Int32)	Chiamato quando viene rilasciato il tasto di un carattere mentre è attiva una cella.
OnLeave(Int32, Boolean)	Chiamato quando lo stato attivo viene spostato da una cella.
OnMouseClick(DataGridViewCellMouseEventArgs)	Chiamato quando un utente fa clic con un pulsante del mouse con il puntatore posizionato in una cella.
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Chiamato quando un utente fa doppio clic con un pulsante del mouse con il puntatore posizionato in una cella.
OnMouseDown(DataGridViewCellMouseEventArgs)	Chiamato quando un utente tiene premuto un pulsante del mouse con il puntatore posizionato in una cella.
OnMouseEnter(Int32)	Chiamato quando il puntatore del mouse viene spostato su una cella.
OnMouseLeave(Int32)	Chiamato quando il puntatore del mouse esce dalla cella.
OnMouseMove(DataGridViewCellMouseEventArgs)	Chiamato quando il puntatore del mouse viene spostato all'interno di una cella.
OnMouseUp(DataGridViewCellMouseEventArgs)	Chiamato quando un utente rilascia un pulsante del mouse con il puntatore posizionato in una cella.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Disegna l'oggetto DataGridViewCell corrente.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Disegna il bordo dell'oggetto DataGridViewCell corrente.
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Disegna l'icona di errore della classe DataGridViewCell corrente.
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Converte un valore formattato per la visualizzazione in un valore di cella effettivo.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Imposta la posizione e le dimensioni del controllo di modifica contenuto da una cella nel controllo DataGridView.
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.
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.
ToString()	Restituisce una stringa che descrive l'oggetto corrente.

Si applica a