Mercurial > vim

comparison runtime/doc/popup.txt @ 19721:bceeded72898

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update runtime files Commit: https://github.com/vim/vim/commit/ff78155aa1755aced96a3b343e81939c94aac721 Author: Bram Moolenaar <Bram@vim.org> Date: Thu Mar 19 20:37:11 2020 +0100 Update runtime files
author Bram Moolenaar <Bram@vim.org>
date Thu, 19 Mar 2020 20:45:06 +0100
parents b70fbf3f0e0b
children 350e1d3131d8
comparison
equal deleted inserted replaced
19720:69b650ef768a 19721:bceeded72898
1 *popup.txt* For Vim version 8.2. Last change: 2020 Feb 20 1 *popup.txt* For Vim version 8.2. Last change: 2020 Mar 14
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
150 - When the job ends, the popup window closes. 150 - When the job ends, the popup window closes.
151 - The popup window can be closed with `popup_close()`, the terminal buffer 151 - The popup window can be closed with `popup_close()`, the terminal buffer
152 then becomes hidden. 152 then becomes hidden.
153 - The default Pmenu color is only used for the border and padding. To change 153 - The default Pmenu color is only used for the border and padding. To change
154 the color of the terminal itself set 'wincolor'. 154 the color of the terminal itself set 'wincolor'.
155 - The default minimal size is 5 lines of 20 characters; Use the "minwidth" and
156 "minheight" parameters to set a different value.
155 157
156 To run a terminal in a popup window, first create the terminal hidden. Then 158 To run a terminal in a popup window, first create the terminal hidden. Then
157 pass the buffer number to popup_create(). Example: > 159 pass the buffer number to popup_create(). Example: >
158 let buf = term_start(['picker', 'Something'], #{hidden: 1, term_finish: 'close'}) 160 let buf = term_start(['picker', 'Something'], #{hidden: 1, term_finish: 'close'})
159 let winid = popup_create(buf, #{minwidth: 50, minheight: 20}) 161 let winid = popup_create(buf, #{minwidth: 50, minheight: 20})
564 dictionary with a "col" entry, see below: 566 dictionary with a "col" entry, see below:
565 |popup-props|. 567 |popup-props|.
566 568
567 If you want to create a new buffer yourself use |bufadd()| and pass the buffer 569 If you want to create a new buffer yourself use |bufadd()| and pass the buffer
568 number to popup_create(). 570 number to popup_create().
569 It is not possible to use the buffer of a terminal window. *E278* 571 It is not possible to use the buffer of a terminal window. *E278* You CAN
572 create a hidden terminal buffer and use that one in a popup window.
570 573
571 The second argument of |popup_create()| is a dictionary with options: 574 The second argument of |popup_create()| is a dictionary with options:
572 line Screen line where to position the popup. Can use a 575 line Screen line where to position the popup. Can use a
573 number or "cursor", "cursor+1" or "cursor-1" to use 576 number or "cursor", "cursor+1" or "cursor-1" to use
574 the line of the cursor and add or subtract a number of 577 the line of the cursor and add or subtract a number of