DataGridViewCell.ToolTipText Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen des QuickInfo-Texts, der dieser Zelle zugeordnet ist.
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 StringEigenschaftswert
Der QuickInfo-Text, der der Zelle zugeordnet ist. Der Standardwert lautet Empty.
- Attribute
Beispiele
Das folgende Codebeispiel zeigt, wie die ToolTipText Eigenschaft innerhalb eines Ereignishandlers für das CellFormatting Ereignis festgelegt wird. Dieses Beispiel ist Teil eines größeren Codebeispiels, das in How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control bereitgestellt wird.
// 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
Hinweise
Der Wert dieser Eigenschaft wird als QuickInfo der Zelle angezeigt, wenn sich der Mauszeiger über der Zelle befindet und der Eigenschaftswert nicht Emptyist. Wenn der Wert dieser Eigenschaft lautet Empty, zeigt die Zelle eine QuickInfo an, die den Wert der Zelle enthält, wenn der Wert in der Zellenanzeige abgeschnitten wird. Andernfalls zeigt die Zelle keine QuickInfo an. Sie können auch die Anzeige einer QuickInfo verhindern, indem Sie die DataGridView.ShowCellToolTips Eigenschaft auf falsefestlegen.
Wenn die DataGridView Steuerelementeigenschaft DataSource festgelegt oder die VirtualMode Eigenschaft festgelegt wird true, löst das Abrufen des Werts der ToolTipText Eigenschaft das CellToolTipTextNeeded Ereignis des Steuerelements aus und gibt den Wert der DataGridViewCellToolTipTextNeededEventArgs.ToolTipText Eigenschaft zurück, wie im Ereignishandler angegeben. Wenn kein Handler für das Ereignis vorhanden ist, gibt der Wert der ToolTipText Eigenschaft den zuvor angegebenen Wert oder den Standardwert von Empty.
Die Behandlung des CellToolTipTextNeeded Ereignisses ist in erster Linie nützlich, wenn Sie mit großen Datenmengen arbeiten, um Leistungseinbußen beim Festlegen des Zellwerts ToolTipText für mehrere Zellen zu vermeiden. Weitere Informationen finden Sie unter Bewährte Methoden zum Skalieren des Windows Forms DataGridView-Steuerelements.
Wenn Sie diese Eigenschaft ändern, wird das CellToolTipTextChanged Ereignis für das besitzende DataGridViewEreignis ausgelöst, sofern vorhanden.
