DataGridViewCell Classe
Definizione
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 IDisposablePublic MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable- Ereditarietà
- Derivato
- Attributi
- Implementazioni
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. |
