7.5.10 -> 7.5.11

#### Changed:
- Option `user_can_create_notes` now overrides cells made `readonly` but not notes created by the `note()` function that are readonly.

#### Added:
- Option `tooltip_hover_delay` to control how long the mouse cursor must stay still before a tooltip appears.

#### Improved:
- If tooltips/notes are being used hovering over any area of a cell will now make them appear rather than just the cells text.
- A cell edit will now only occur when using tooltips if the tooltip editor's content changed.

#### Fixed:
- Tooltip wrongly opens while cell text editor is open.
- Removed leftover debugging `print()` call from treeview move function.

Author: ragardner

docs/CHANGELOG.md

@@ -1,3 +1,18 @@
+### Version 7.5.11
+#### Changed:
+- Option `user_can_create_notes` now overrides cells made `readonly` but not notes created by the `note()` function that are readonly.
+
+#### Added:
+- Option `tooltip_hover_delay` to control how long the mouse cursor must stay still before a tooltip appears.
+
+#### Improved:
+- If tooltips/notes are being used hovering over any area of a cell will now make them appear rather than just the cells text.
+- A cell edit will now only occur when using tooltips if the tooltip editor's content changed.
+
+#### Fixed:
+- Tooltip wrongly opens while cell text editor is open.
+- Removed leftover debugging `print()` call from treeview move function.
+
 ### Version 7.5.10
 #### Fixed:
 - Error with notes when using readonly cells and writable notes. [#301](https://github.com/ragardner/tksheet/issues/301).

docs/DOCUMENTATION.html

@@ -1045,6 +1045,7 @@ <h1 id="initialization-options"><strong>Initialization Options</strong></h1>
     note_corners: bool = False,
     tooltip_width: int = 210,
     tooltip_height: int = 210,
+    tooltip_hover_delay: int = 1200,
     # colors
     outline_thickness: int = 0,
     theme: str = &quot;light blue&quot;,
@@ -1744,6 +1745,7 @@ <h1 id="sheet-options"><strong>Sheet Options</strong></h1>
 &quot;note_corners&quot;: False,
 &quot;tooltip_width&quot;: int = 210,
 &quot;tooltip_height&quot;: int = 210,
+&quot;tooltip_hover_delay&quot;: int = 1200,
 </code></pre>
 <p>Notes:</p>
 <ul>
@@ -4572,7 +4574,7 @@ <h4 id="replace-all-using-mapping"><strong>Replace all using mapping</strong></h
 </ul>
 <hr />
 <h1 id="notes-and-tooltips"><strong>Notes and tooltips</strong></h1>
-<p>When using either notes or tooltips a popup can be made to appear for associated cells when the mouse cursor <strong>remains still over a cell's text</strong> for 1sec.</p>
+<p>When using either notes or tooltips a popup can be made to appear for associated cells when the mouse cursor remains still over a cell.</p>
 <p>Tooltips and notes are two different things but both produce the same popup, if using both cell notes and tooltips then the popup with have clickable tabs.</p>
 <h2 id="cell-tooltips"><strong>Cell tooltips</strong></h2>
 <p>Cell tooltips show the cell's value, they are:</p>
@@ -4581,11 +4583,18 @@ <h2 id="cell-tooltips"><strong>Cell tooltips</strong></h2>
 <li>A global setting and not for individual cells like <code>note</code>s are.</li>
 <li>Editable if the cell itself is editable - if the cell is readonly then the <code>Cell</code> tooltip should be also.</li>
 <li>Saved when the mouse leaves the tooltip popup.</li>
+</ul>
+<p>You can:</p>
+<ul>
 <li>Change the width and height of tooltip &amp; note popups using the settings:<ul>
 <li><code>set_options(tooltip_width=my_width)</code> (<code>int</code>).</li>
 <li><code>set_options(tooltip_height=my_height)</code> (<code>int</code>).</li>
 </ul>
 </li>
+<li>Change the time required for the mouse cursor to stay still before a tooltip appears:<ul>
+<li><code>set_options(tooltip_hover_delay=my_delay_in_ms)</code> (<code>int</code>).</li>
+</ul>
+</li>
 </ul>
 <p>Activate &amp; deactivate tooltips either at your <code>Sheet</code>s initialization:</p>
 <pre><code class="language-python">sheet = Sheet(parent, tooltips=True)
@@ -4619,7 +4628,7 @@ <h2 id="cell-notes"><strong>Cell notes</strong></h2>
 <li>Use <code>readonly</code> <code>False</code> to allow the user to edit the existing notes.</li>
 <li><code>readonly</code> is <code>True</code> by default.</li>
 </ul>
-<p>You can also allow the user to create new notes and delete notes using the setting <code>user_can_create_notes</code> e.g. <code>sheet.set_options(user_can_create_notes=True)</code>.</p>
+<p>You can also allow the user to create new notes and delete notes using the setting <code>user_can_create_notes</code> e.g. <code>sheet.set_options(user_can_create_notes=True)</code>. This allows the user to create and modify notes. This also allows note editing even in cells that have been made <code>readonly</code> in the non-note sense.</p>
 <p>If an existing note was created using the <code>note()</code> function or <code>Span.note()</code> function and <code>readonly</code> was set to <code>True</code> then the user will not be able to edit or delete that note even if <code>user_can_create_notes</code> is <code>True</code>.</p>
 <p>Examples:</p>
 <p><strong>Note for header cell in column <code>A</code>/<code>0</code>:</strong></p>

docs/DOCUMENTATION.md

@@ -360,6 +360,7 @@ def __init__(
     note_corners: bool = False,
     tooltip_width: int = 210,
     tooltip_height: int = 210,
+    tooltip_hover_delay: int = 1200,
     # colors
     outline_thickness: int = 0,
     theme: str = "light blue",
@@ -1084,6 +1085,7 @@ else ["<Home>"],
 "note_corners": False,
 "tooltip_width": int = 210,
 "tooltip_height": int = 210,
+"tooltip_hover_delay": int = 1200,
 ```
 
 Notes:
@@ -4212,7 +4214,7 @@ Notes:
 ---
 # **Notes and tooltips**
 
-When using either notes or tooltips a popup can be made to appear for associated cells when the mouse cursor **remains still over a cell's text** for 1sec.
+When using either notes or tooltips a popup can be made to appear for associated cells when the mouse cursor remains still over a cell.
 
 Tooltips and notes are two different things but both produce the same popup, if using both cell notes and tooltips then the popup with have clickable tabs.
 
@@ -4224,9 +4226,14 @@ Cell tooltips show the cell's value, they are:
 - A global setting and not for individual cells like `note`s are.
 - Editable if the cell itself is editable - if the cell is readonly then the `Cell` tooltip should be also.
 - Saved when the mouse leaves the tooltip popup.
+
+You can:
+
 - Change the width and height of tooltip & note popups using the settings:
     - `set_options(tooltip_width=my_width)` (`int`).
     - `set_options(tooltip_height=my_height)` (`int`).
+- Change the time required for the mouse cursor to stay still before a tooltip appears:
+    - `set_options(tooltip_hover_delay=my_delay_in_ms)` (`int`).
 
 Activate & deactivate tooltips either at your `Sheet`s initialization:
 
@@ -4271,7 +4278,7 @@ note(*key: CreateSpanTypes, note: str | None = None, readonly: bool = True) -> S
 - Use `readonly` `False` to allow the user to edit the existing notes.
 - `readonly` is `True` by default.
 
-You can also allow the user to create new notes and delete notes using the setting `user_can_create_notes` e.g. `sheet.set_options(user_can_create_notes=True)`.
+You can also allow the user to create new notes and delete notes using the setting `user_can_create_notes` e.g. `sheet.set_options(user_can_create_notes=True)`. This allows the user to create and modify notes. This also allows note editing even in cells that have been made `readonly` in the non-note sense.
 
 If an existing note was created using the `note()` function or `Span.note()` function and `readonly` was set to `True` then the user will not be able to edit or delete that note even if `user_can_create_notes` is `True`.
 

pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "tksheet"
 description = "Tkinter table / sheet and treeview widget"
 readme = "README.md"
-version = "7.5.10"
+version = "7.5.11"
 authors = [{ name = "ragardner", email = "[email protected]" }]
 requires-python = ">=3.8"
 license = {file = "LICENSE.txt"}

tksheet/__init__.py

@@ -4,7 +4,7 @@
 tksheet - A Python tkinter table widget
 """
 
-__version__ = "7.5.10"
+__version__ = "7.5.11"
 
 from .colors import (
     color_map,