DataGridViewCell.ToolTipText Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de knopinfotekst op die aan deze cel is gekoppeld of stelt u deze in.
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 StringWaarde van eigenschap
De tekst van de knopinfo die aan de cel is gekoppeld. De standaardwaarde is Empty.
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de ToolTipText eigenschap instelt in een gebeurtenis-handler voor de CellFormatting gebeurtenis. Dit voorbeeld maakt deel uit van een groter codevoorbeeld in Hoe u kunt: Knopinfo toevoegen aan afzonderlijke cellen in een Windows Forms DataGridView-besturingselement.
// 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
Opmerkingen
De waarde van deze eigenschap wordt weergegeven als de knopinfo voor cellen wanneer de muis aanwijzer boven de cel staat en de eigenschapswaarde niet Emptyis. Als de waarde van deze eigenschap is Empty, geeft de cel een knopinfo weer die de waarde van de cel bevat als de waarde is afgekapt in de celweergave. Anders wordt in de cel geen knopinfo weergegeven. U kunt ook voorkomen dat knopinfo wordt weergegeven door de DataGridView.ShowCellToolTips eigenschap in te stellen op false.
Wanneer de eigenschap van het DataGridView besturingselement DataSource is ingesteld of VirtualMode de eigenschap is true, wordt de waarde van de ToolTipText eigenschap opgehaald door de CellToolTipTextNeeded gebeurtenis van het besturingselement op te halen en wordt de waarde van de DataGridViewCellToolTipTextNeededEventArgs.ToolTipText eigenschap geretourneerd zoals opgegeven in de gebeurtenis-handler. Als er geen handlers voor de gebeurtenis zijn, retourneert het ophalen van de waarde van de ToolTipText eigenschap de eerder opgegeven waarde of de standaardwaarde van Empty.
Het afhandelen van de CellToolTipTextNeeded gebeurtenis is voornamelijk handig bij het werken met grote hoeveelheden gegevens om prestatiestraffen te voorkomen bij het instellen van de celwaarde ToolTipText voor meerdere cellen. Zie Best practices voor het schalen van het Windows Forms DataGridView-besturingselement voor meer informatie.
Als u deze eigenschap wijzigt, wordt de CellToolTipTextChanged gebeurtenis voor de eigenaar DataGridViewgegenereerd, indien aanwezig.
