From 9066b384771709b8c743c9368dd9a3ee2d31a2a4 Mon Sep 17 00:00:00 2001 From: Serhiy Storchaka Date: Sun, 5 Jul 2026 14:07:49 +0300 Subject: [PATCH] gh-75952: Document negative offsets in tkinter geometry strings (GH-152531) Tk geometry strings can contain a negative offset (e.g. 200x100+-9+-8) when a window edge is positioned beyond the corresponding screen edge. Note this in the geometry() and winfo_geometry() documentation. (cherry picked from commit 19b5e8e1f510eb2fdd3f6261006b61f8cf441101) Co-authored-by: Serhiy Storchaka Co-authored-by: Claude Opus 4.8 --- Doc/library/tkinter.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index d23005ebd8af05..e8ccc6640310b8 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -1991,6 +1991,7 @@ Base and mixin classes Return the geometry of the widget, in the form ``widthxheight+x+y``. All dimensions are in pixels. + An offset can be negative; see :meth:`~Wm.geometry`. .. method:: winfo_height() @@ -2451,6 +2452,8 @@ Base and mixin classes *width* and *height* are in pixels (or grid units for a gridded window); a position preceded by ``+`` is measured from the left or top edge of the screen and one preceded by ``-`` from the right or bottom edge. + An offset can be negative, as in ``'200x100+-9+-8'``, when the window + edge is positioned beyond the corresponding screen edge. An empty string cancels any user-specified geometry, letting the window revert to its natural size. With no argument, return the current geometry as a string of the form