diff options
| author | Bram Moolenaar <Bram@vim.org> | 2019-08-31 16:20:32 +0200 |
|---|---|---|
| committer | Bram Moolenaar <Bram@vim.org> | 2019-08-31 16:20:32 +0200 |
| commit | 06fe74aef72606ac34c9f494186e52614b8fb59a (patch) | |
| tree | cc18e67c68b4d19fdcd70349fcd180a2dcd36986 /runtime/doc/popup.txt | |
| parent | 4bbfb0f3cc67c00c8cee4e47283e8d760025219d (diff) | |
Runtime files update.
Diffstat (limited to 'runtime/doc/popup.txt')
| -rw-r--r-- | runtime/doc/popup.txt | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/runtime/doc/popup.txt b/runtime/doc/popup.txt index 6f29c5efd7..0a464103c8 100644 --- a/runtime/doc/popup.txt +++ b/runtime/doc/popup.txt @@ -1,4 +1,4 @@ -*popup.txt* For Vim version 8.1. Last change: 2019 Aug 03 +*popup.txt* For Vim version 8.1. Last change: 2019 Aug 31 VIM REFERENCE MANUAL by Bram Moolenaar @@ -125,7 +125,9 @@ is always associated with the popup window and manipulation is restricted: It is possible to change the specifically mentioned options, but anything might break then, so better leave them alone. -The window does have a cursor position, but the cursor is not displayed. +The window does have a cursor position, but the cursor is not displayed. In +fact, the cursor in the underlying window is displayed, as if it peeks through +the popup, so you can see where it is. To execute a command in the context of the popup window and buffer use `win_execute()`. Example: > @@ -315,6 +317,10 @@ popup_getoptions({id}) *popup_getoptions()* The "mousemoved" entry is a list with screen row, minimum and maximum screen column, [0, 0, 0] when not set. + "firstline" is the property set on the popup, unlike the + "firstline" obtained with |popup_getpos()| which is the actual + buffer line at the top of the popup window. + "border" and "padding" are not included when all values are zero. When all values are one then an empty list is included. @@ -344,6 +350,7 @@ popup_getpos({id}) *popup_getpos()* core_width width of the text box in screen cells core_height height of the text box in screen cells firstline line of the buffer at top (1 unless scrolled) + (not the value of the "firstline" property) scrollbar non-zero if a scrollbar is displayed visible one if the popup is displayed, zero if hidden Note that these are the actual screen positions. They differ @@ -559,6 +566,7 @@ The second argument of |popup_create()| is a dictionary with options: firstline First buffer line to display. When larger than one it looks like the text scrolled up. When out of range the last buffer line will at the top of the window. + Set to zero to leave the position as set by commands. Also see "scrollbar". hidden When TRUE the popup exists but is not displayed; use `popup_show()` to unhide it. |