Feature: activation delay on tooltips

[v-ein]

---

name: Pull Request
about: Create a pull request to help us improve
title: Activation delay on tooltips
assignees: @hoffstadt

---

Description:
This PR adds a couple parameters to tooltips that allow to:

• Only show the tooltip once the mouse stays still for a while (i.e. don't show it while the mouse is still moving).
• Hide the tooltip as soon as the mouse starts moving again.

This resembles, more or less, the usual behavior of tooltips on Windows (and maybe in other systems too). It would be nice if the tooltip also stayed still while the mouse is moving, but this would be harder to achieve so I put it aside for the moment.

Concerning Areas:
None.

[v-ein]

Note: in this PR, I've set the delay to a default value of 0.5 second, which works just fine but it's different from how DPG tooltips used to work.

Now on a second thought I'm not sure it was a good decision because it will change the behavior of existing apps... Should we keep the delay as zero by default? What do you think? Should tooltips by default pop up instantly, and whoever wants a delay, will have to specify delay=0.5 in each dpg.tooltip call?

The "current" DPG behavior corresponds to

dpg.tooltip(delay=0, hide_on_activity=False)

A good alternative that I'm striving to is:

dpg.tooltip(delay=0.5, hide_on_activity=True)  # hide_on_activity=False also works fine

I'm not sure which one should become implicit (the default) and which should become explicit. My gut feeling is that we shouldn't break existing tooltip behavior.

[v-ein]

Re my last comment: I've updated the PR, and the default behavior is now exactly the same as in the current DPG 1.9.1. That is, to use the delay, one has to specify it on every tooltip; this way we don't break UX on existing apps.