DataGridViewCell.ToolTipText Proprietà
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.
Ottiene o imposta il testo della descrizione comandi associato a questa cella.
public:
property System::String ^ ToolTipText { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.Browsable(false)]
public string ToolTipText { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.ToolTipText : string with get, setPublic Property ToolTipText As StringValore della proprietà
Testo della descrizione comandi associato a questa cella. Il valore predefinito è Empty.
- Attributi
Esempio
Nell'esempio di codice seguente viene illustrato come impostare la ToolTipText proprietà all'interno di un gestore eventi per l'evento CellFormatting . Questo esempio fa parte di un esempio di codice più ampio fornito in 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
Il valore di questa proprietà viene visualizzato come descrizione comando della cella quando il puntatore del mouse si trova sulla cella e il valore della proprietà non Emptyè . Se il valore di questa proprietà è Empty, la cella visualizzerà una descrizione comando contenente il valore della cella se il valore viene troncato nella visualizzazione della cella; in caso contrario, la cella non visualizzerà una descrizione comando. È anche possibile impedire la visualizzazione di una descrizione comando impostando la DataGridView.ShowCellToolTips proprietà su false.
Quando la proprietà del DataGridView controllo DataSource è impostata o la relativa VirtualMode proprietà è true, ottenere il valore della ToolTipText proprietà genera l'evento CellToolTipTextNeeded del controllo e restituisce il valore della DataGridViewCellToolTipTextNeededEventArgs.ToolTipText proprietà come specificato nel gestore eventi. Se non sono presenti gestori per l'evento, ottenere il valore della ToolTipText proprietà restituisce il valore specificato in precedenza o il valore predefinito di Empty.
La gestione dell'evento CellToolTipTextNeeded è particolarmente utile quando si usano grandi quantità di dati per evitare sanzioni sulle prestazioni quando si imposta il valore della cella ToolTipText per più celle. Per altre informazioni, vedere Procedure consigliate per ridimensionare il controllo DataGridView Windows Form.
Se si modifica questa proprietà, viene generato l'evento CellToolTipTextChangedDataGridViewproprietario, se presente.
