7.4.0 -> 7.4.1

ragardner · Feb 18, 2025 · f094570 · f094570
1 parent 14e1840
commit f094570
Show file tree

Hide file tree

Showing 5 changed files with 47 additions and 3 deletions.
diff --git a/README.md b/README.md
@@ -52,7 +52,6 @@ This library is maintained with the help of **[others](https://github.com/ragard
 - [Expand row heights and column widths](https://github.com/ragardner/tksheet/wiki/Version-7#table-functionality-and-bindings)
 - [Change fonts and font size (not for individual cells)](https://github.com/ragardner/tksheet/wiki/Version-7#text-font-and-alignment)
 - [Change any colors in the sheet](https://github.com/ragardner/tksheet/wiki/Version-7#sheet-appearance)
-
 - [Dropdown boxes](https://github.com/ragardner/tksheet/wiki/Version-7#dropdown-boxes)
 - [Check boxes](https://github.com/ragardner/tksheet/wiki/Version-7#check-boxes)
 - [Progress bars](https://github.com/ragardner/tksheet/wiki/Version-7#progress-bars)

diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
@@ -1,3 +1,6 @@
+### Version 7.4.1
+####
+
 ### Version 7.4.0
 #### Changed:
 - Text now wraps by character by default, can also disable wrapping or wrap by word

diff --git a/docs/DOCUMENTATION.md b/docs/DOCUMENTATION.md
@@ -9,6 +9,7 @@
 - [Sheet Appearance](https://github.com/ragardner/tksheet/wiki/Version-7#sheet-appearance)
 - [Alternate Row Colors](https://github.com/ragardner/tksheet/wiki/Version-7#alternate-row-colors)
 - [Header and Index](https://github.com/ragardner/tksheet/wiki/Version-7#header-and-index)
+- [Text Wrap and Overflow](https://github.com/ragardner/tksheet/wiki/Version-7#text-wrap-and-overflow)
 ---
 - [Table Functionality and Bindings](https://github.com/ragardner/tksheet/wiki/Version-7#table-functionality-and-bindings)
 - [tkinter and tksheet Events](https://github.com/ragardner/tksheet/wiki/Version-7#tkinter-and-tksheet-events)
@@ -708,6 +709,47 @@ row_index(
 - Leaving `newindex` as `None` and using the `index` argument returns the existing row index value in that index.
 - Leaving all arguments as default e.g. `row_index()` returns the existing row index.
 
+---
+# **Text Wrap and Overflow**
+
+#### **Control text wrapping**
+
+You can set table, header and index text wrapping either at `Sheet()` initialization or using `set_options()`.
+
+Make use of the following parameters:
+- `table_wrap`
+- `index_wrap`
+- `header_wrap`
+
+With one of the following arguments:
+- `""` - For no text wrapping.
+- `"c"` - For character wrapping.
+- `"w"` - For word wrapping.
+
+**Examples:**
+```python
+# for word wrap at initialization
+my_sheet = Sheet(parent, table_wrap="w")
+
+# for character wrap using set_options()
+my_sheet.set_options(table_wrap="c")
+```
+
+#### **Control table text overflow**
+
+This setting only works for cells that are not center (north) aligned. Cell text can be set to overflow adjacent empty cells in the table like so:
+
+**Examples:**
+```python
+# for word wrap at initialization
+my_sheet = Sheet(parent, allow_cell_overflow=True)
+
+# for character wrap using set_options()
+my_sheet.set_options(allow_cell_overflow=True)
+```
+- Set it to `False` to disable it.
+- It is only available as a global setting for the table, not on a cell by cell basis.
+
 ---
 # **Table functionality and bindings**
 

diff --git a/pyproject.toml b/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.4.0"
+version = "7.4.1"
 authors = [{ name = "ragardner", email = "[email protected]" }]
 requires-python = ">=3.8"
 license = {file = "LICENSE.txt"}

diff --git a/tksheet/__init__.py b/tksheet/__init__.py
@@ -4,7 +4,7 @@
 tksheet - A Python tkinter table widget
 """
 
-__version__ = "7.4.0"
+__version__ = "7.4.1"
 
 from .colors import (
     color_map,