ListView.HotTracking Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ListView.cs

Gets or sets a value indicating whether the text of an item or subitem has the appearance of a hyperlink when the mouse pointer passes over it.

public:
 property bool HotTracking { bool get(); void set(bool value); };

public bool HotTracking { get; set; }

member this.HotTracking : bool with get, set

Public Property HotTracking As Boolean

Property Value

Boolean

true if the item text has the appearance of a hyperlink when the mouse passes over it; otherwise, false. The default is false.

Examples

The following code example demonstrates a ListView with hot tracking enabled. To run this example, paste the following code into a Windows Form and call the InitializeHotTrackingListView method from the form's constructor or Load event handler.

private ImageList list = new ImageList();
private ListView hotTrackinglistView = new ListView();

private void InitializeHotTrackingListView(){
    list.Images.Add(new Bitmap(typeof(Button), "Button.bmp"));
    hotTrackinglistView.SmallImageList = list;
    hotTrackinglistView.Location = new Point(20, 20);
    hotTrackinglistView.View = View.SmallIcon;
    ListViewItem listItem1 = new ListViewItem("Short", 0 );
    ListViewItem listItem2 = new ListViewItem("Tiny", 0);
    hotTrackinglistView.Items.Add(listItem1);
    hotTrackinglistView.Items.Add(listItem2);
    hotTrackinglistView.HotTracking = true;
    this.Controls.Add(hotTrackinglistView);
}

Private list As New ImageList()
Private hotTrackinglistView As New ListView()


Private Sub InitializeHotTrackingListView()
    list.Images.Add(New Bitmap(GetType(Button), "Button.bmp"))
    hotTrackinglistView.SmallImageList = list
    hotTrackinglistView.Location = New Point(20, 20)
    hotTrackinglistView.View = View.SmallIcon
    Dim listItem1 As New ListViewItem("Short", 0)
    Dim listItem2 As New ListViewItem("Tiny", 0)
    hotTrackinglistView.Items.Add(listItem1)
    hotTrackinglistView.Items.Add(listItem2)
    hotTrackinglistView.HotTracking = True
    Me.Controls.Add(hotTrackinglistView)

End Sub

Remarks

Enabling hot tracking will cause the Activation property to be set to OneClick and the HoverSelection property to be set to true. In addition, run-time label editing is not allowed when hot tracking is enabled.