DataGridViewCell.ToolTipText Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállítja a cellához társított elemleírás-szöveget.
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 StringTulajdonság értéke
A cellához társított elemleírás szövege. Az alapértelmezett érték a Empty.
- Attribútumok
Példák
Az alábbi példakód bemutatja, hogyan állíthatja be a tulajdonságot egy ToolTipText eseménykezelőben az CellFormatting eseményhez. Ez a példa a A következőhöz: Elemleírások hozzáadása az egyes cellákhoz Windows Forms DataGridView-vezérlőben.
// 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
Megjegyzések
A tulajdonság értéke cella elemleírásként jelenik meg, ha az egérmutató a cellán van, és a tulajdonság értéke nem Empty. Ha ennek a tulajdonságnak az értéke, Emptya cella egy elemleírást jelenít meg, amely a cella értékét tartalmazza, ha az érték csonkolt a cellakijelenítésben; ellenkező esetben a cella nem jelenít meg elemleírást. Az elemleírások megjelenítését úgy is megakadályozhatja, ha a tulajdonságot a DataGridView.ShowCellToolTips következőre falseállítja.
Ha a DataGridView vezérlőtulajdonság DataSource be van állítva, vagy annak tulajdonsága VirtualMode van true, a ToolTipText tulajdonság értékének lekérése a vezérlőelem eseményét növeli CellToolTipTextNeeded , és az eseménykezelőben megadott tulajdonság értékét DataGridViewCellToolTipTextNeededEventArgs.ToolTipText adja vissza. Ha nincsenek kezelők az eseményhez, a ToolTipText tulajdonság értékének lekérése a korábban megadott értéket vagy annak alapértelmezett értékét Emptyadja vissza.
CellToolTipTextNeeded Az esemény kezelése elsősorban akkor hasznos, ha nagy mennyiségű adattal dolgozik, hogy elkerülje a teljesítménybírságokat több cella cellaértékének ToolTipText beállításakor. További információ: Best practices for scaling the Windows Forms DataGridView Control.
A tulajdonság módosítása esetén az CellToolTipTextChanged esemény a saját tulajdonban DataGridViewlesz, ha létezik ilyen.
