DataGridViewCell.ToolTipText プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このセルに関連付けられているツールヒント テキストを取得または設定します。
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 Stringプロパティ値
セルに関連付けられたツールヒント テキスト。 既定値は、Empty です。
- 属性
例
次のコード例は、 イベントの ToolTipText イベント ハンドラー内で プロパティを設定する方法を CellFormatting 示しています。 この例は、「方法: Windows フォーム 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
注釈
マウス ポインターがセルの上にあり、プロパティ値が ではない Empty場合、このプロパティの値はセル ToolTip として表示されます。 このプロパティの値が の場合、セルの表示で値が Empty切り捨てられた場合、セルにはセルの値を含む ToolTip が表示されます。それ以外の場合、セルにはツールヒントは表示されません。 また、 プロパティを にfalse設定することで、ツールヒントの表示をDataGridView.ShowCellToolTips禁止することもできます。
コントロール プロパティがDataGridView設定されている場合、またはそのVirtualModeプロパティが の場合、 trueプロパティの値をToolTipText取得すると、コントロールのイベントが発生CellToolTipTextNeededし、イベント ハンドラーで指定されたプロパティのDataGridViewCellToolTipTextNeededEventArgs.ToolTipText値が返DataSourceされます。 イベントのハンドラーがない場合、 プロパティの ToolTipText 値を取得すると、以前に指定した値またはその既定値 が Empty返されます。
イベントの CellToolTipTextNeeded 処理は、複数のセルのセル ToolTipText 値を設定するときにパフォーマンスが低下しないように、大量のデータを操作する場合に主に役立ちます。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。
このプロパティを変更すると、 CellToolTipTextChanged 所有 DataGridViewしている でイベントが発生します (存在する場合)。
適用対象
こちらもご覧ください
.NET