diff runtime/doc/eval.txt @ 12977:2d817fd289ba v8.0.1364

patch 8.0.1364: there is no easy way to get the window position commit https://github.com/vim/vim/commit/22044dc31788d9f1c2da7725269884d9923b4795 Author: Bram Moolenaar <Bram@vim.org> Date: Sat Dec 2 15:43:37 2017 +0100 patch 8.0.1364: there is no easy way to get the window position Problem: There is no easy way to get the window position. Solution: Add win_screenpos().
author Christian Brabandt <cb@256bit.org>
date Sat, 02 Dec 2017 15:45:04 +0100
parents 45987b1b77dc
children e47e70300f30
line wrap: on
line diff
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -2452,6 +2452,7 @@ win_getid([{win} [, {tab}]])	Number	get 
 win_gotoid({expr})		Number	go to window with ID {expr}
 win_id2tabwin({expr})		List	get tab and window nr from window ID
 win_id2win({expr})		Number	get window nr from window ID
+win_screenpos({nr})		List	get screen position of window {nr}
 winbufnr({nr})			Number	buffer number of window {nr}
 wincol()			Number	window column of the cursor
 winheight({nr})			Number	height of window {nr}
@@ -8633,6 +8634,14 @@ win_id2win({expr})					*win_id2win()*
 		Return the window number of window with ID {expr}.
 		Return 0 if the window cannot be found in the current tabpage.
 
+win_screenpos({nr})					*win_screenpos()*
+		Return the screen position of window {nr} as a list with two
+		numbers: [row, col].  The first window always has position
+		[1, 1].
+		{nr} can be the window number or the |window-ID|.
+		Return [0, 0] if the window cannot be found in the current
+		tabpage.
+
 							*winbufnr()*
 winbufnr({nr})	The result is a Number, which is the number of the buffer
 		associated with window {nr}.  {nr} can be the window number or