From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sun, 5 Jul 2026 11:15:42 +0000 (+0200) Subject: [3.15] gh-75952: Document negative offsets in tkinter geometry strings (GH-152531... X-Git-Tag: v3.15.0b4~117 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=67d782c6bc76578a1ed28e82953a9013bc6226bd;p=thirdparty%2FPython%2Fcpython.git [3.15] gh-75952: Document negative offsets in tkinter geometry strings (GH-152531) (GH-153101) 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 --- diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 4687057788d5..17ea03d0de4d 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -2020,6 +2020,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() @@ -2480,6 +2481,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