DataGridViewCell.ToolTipText プロパティ

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, set

Public Property ToolTipText As String

プロパティ値

セルに関連付けられているツールヒント テキスト。 既定値は、Empty です。

属性

BrowsableAttribute

例

次のコード例は、CellFormatting イベントのイベント ハンドラー内でToolTipText プロパティを設定する方法を示しています。 この例は、「 方法: 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されていない場合、このプロパティの値はセルのツールヒントとして表示されます。 このプロパティの値が Empty場合、セルの表示で値が切り捨てられた場合、セルにはセルの値を含むツールヒントが表示されます。それ以外の場合、セルにはツールヒントは表示されません。 また、 DataGridView.ShowCellToolTips プロパティを false に設定することで、ツールヒントの表示を禁止することもできます。

DataGridView コントロールDataSourceプロパティが設定されている場合、またはそのVirtualModeプロパティがtrueされると、ToolTipText プロパティの値を取得すると、コントロールのCellToolTipTextNeeded イベントが発生し、イベント ハンドラーで指定されたDataGridViewCellToolTipTextNeededEventArgs.ToolTipText プロパティの値が返されます。 イベントのハンドラーがない場合、 ToolTipText プロパティの値を取得すると、以前に指定した値または既定値の Emptyが返されます。

CellToolTipTextNeeded イベントの処理は、主に大量のデータを操作して、複数のセルのセルToolTipText値を設定するときのパフォーマンスの低下を回避する場合に便利です。 詳細については、「 Windows フォーム DataGridView コントロールをスケーリングするためのベスト プラクティス」を参照してください。

このプロパティを変更すると、所有するDataGridViewでCellToolTipTextChanged イベントが発生します (存在する場合)。

こちらもご覧ください

• DataGridView
• ShowCellToolTips
• CellToolTipTextChanged
• CellToolTipTextNeeded
• DataSource
• VirtualMode