DataGridViewCell.ToolTipText Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define o texto ToolTip associado a esta célula.
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 StringValor de Propriedade
O texto ToolTip associado à célula. A predefinição é Empty.
- Atributos
Exemplos
O exemplo de código seguinte mostra como definir a ToolTipText propriedade dentro de um gestor de eventos para o CellFormatting evento. Este exemplo faz parte de um exemplo de código mais amplo fornecido em Como: Adicionar ToolTips a células individuais num controlo Windows Forms DataGridView.
// 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
Observações
O valor desta propriedade é apresentado como a ToolTip da célula quando o ponteiro do rato está sobre a célula e o valor da propriedade não Emptyé . Se o valor desta propriedade for Empty, a célula mostrará uma ToolTip contendo o valor da célula se o valor estiver truncado no ecrã da célula; caso contrário, a célula não mostrará uma ToolTip. Também pode evitar a visualização de uma dica de ferramenta definindo a DataGridView.ShowCellToolTips propriedade para false.
Quando a DataGridView propriedade de controlo DataSource é definida ou a sua VirtualMode propriedade é true, obter o valor da ToolTipText propriedade eleva o CellToolTipTextNeeded evento do controlo e devolve o valor da DataGridViewCellToolTipTextNeededEventArgs.ToolTipText propriedade conforme especificado no gestor de eventos. Se não existirem manipuladores para o evento, obter o valor da ToolTipText propriedade devolve o valor previamente especificado ou o seu valor padrão de Empty.
O tratamento do CellToolTipTextNeeded evento é principalmente útil quando se trabalha com grandes quantidades de dados para evitar penalizações de desempenho ao definir o valor da célula ToolTipText para múltiplas células. Para mais informações, consulte Boas Práticas para Escalar o Controlo Windows Forms DataGridView.
Alterar esta propriedade eleva o CellToolTipTextChanged evento na posse DataGridView, se existir uma.
