TVM_SETHOT message

[Intended for internal use; not recommended for use in applications. This message may not be supported in future versions of Windows.]

Sets the hot item for a tree-view control. You can send this message explicitly or by using the TreeView_SetHot macro.



Must be zero.


Handle to the new hot item. If this value is NULL, the tree-view control will be set to have no hot item.

Return value

Returns TRUE if successful, or FALSE otherwise.

Security Considerations

Using this message might compromise the security of your program.


The hot item is the item that the mouse is hovering over. This message makes an item look like it is the hot item even if the mouse is not hovering over it.

This message has no visible effect if the TVS_TRACKSELECT style is not set.

If it succeeds, this message causes the hot item to be redrawn.

This message is ignored if lParam is NULL and the tree-view control is tracking the mouse.


Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]



See also