DataGridViewCell.ToolTipText DataGridViewCell.ToolTipText DataGridViewCell.ToolTipText DataGridViewCell.ToolTipText Property

定義

このセルに関連付けられているツールヒント テキストを取得または設定します。Gets or sets the ToolTip text associated with this cell.

public:
 property System::String ^ ToolTipText { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public string ToolTipText { get; set; }
member this.ToolTipText : string with get, set
Public Property ToolTipText As String

プロパティ値

セルに関連付けられたツールヒント テキスト。The ToolTip text associated with the cell. 既定値は、Empty です。The default is Empty.

イベントのイベントハンドラー内でToolTipTextプロパティを設定する方法を次のコード例に示します。 CellFormattingThe following code example shows how to set the ToolTipText property within an event handler for the CellFormatting event. この例は、次の方法で提供される大規模なコード例の一部です。Windows フォーム DataGridView コントロール内の個々のセルにツールヒントを追加します。This example is part of a larger code example provided in How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control.

// 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場合、このプロパティの値はセルのツールヒントとして表示されます。The value of this property is displayed as the cell ToolTip when the mouse pointer is over the cell and the property value is not Empty. このプロパティの値がEmptyの場合、セルの表示で値が切り捨てられている場合、セルの値を含むツールヒントがセルに表示されます。それ以外の場合、セルにはツールヒントは表示されません。If the value of this property is Empty, the cell will display a ToolTip containing the value of the cell if the value is truncated in the cell display; otherwise, the cell will not display a ToolTip. また、 DataGridView.ShowCellToolTipsプロパティをに設定するfalseことによって、ツールヒントが表示されないようにすることもできます。You can also prevent the display of a ToolTip by setting the DataGridView.ShowCellToolTips property to false.

DataGridViewコントロールVirtualMode true DataGridViewCellToolTipTextNeededEventArgs.ToolTipText CellToolTipTextNeeded ToolTipTextプロパティが設定されているか、そのプロパティがの場合、プロパティの値を取得すると、コントロールのイベントが発生し、 DataSourceイベントハンドラーに指定されたプロパティ。When the DataGridView control DataSource property is set or its VirtualMode property is true, getting the value of the ToolTipText property raises the CellToolTipTextNeeded event of the control and returns the value of the DataGridViewCellToolTipTextNeededEventArgs.ToolTipText property as specified in the event handler. イベントのハンドラーが存在しない場合、 ToolTipTextプロパティの値を取得すると、以前に指定した値またはのEmpty既定値が返されます。If there are no handlers for the event, getting the value of the ToolTipText property returns the previously specified value or its default value of Empty.

イベントをCellToolTipTextNeeded処理することは、複数のセルのセルToolTipText値を設定するときのパフォーマンスの低下を避けるために、大量のデータを操作する場合に主に役立ちます。Handling the CellToolTipTextNeeded event is primarily useful when working with large amounts of data to avoid performance penalties when setting the cell ToolTipText value for multiple cells. 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

このプロパティを変更するCellToolTipTextChangedと、所有DataGridViewしているでイベントが発生します (存在する場合)。Changing this property raises the CellToolTipTextChanged event on the owning DataGridView, if one exists.

適用対象

こちらもご覧ください