Home • Explore • Blog • CI
☰



neovim
54th chunk of `runtime/doc/api.txt`
d2d02fec43a8e8d0710c4499bc2c840dd9a39950bbd7f7d10000000100000c8f

        Since: 0.1.0

    Parameters: ~
      • {width}    Requested screen columns
      • {height}   Requested screen rows
      • {options}  |ui-option| map

nvim_ui_detach()                                            *nvim_ui_detach()*
    Deactivates UI events on the channel.

    Removes the client from the list of UIs. |nvim_list_uis()|

    Attributes: ~
        |RPC| only
        Since: 0.1.0

                                                    *nvim_ui_pum_set_bounds()*
nvim_ui_pum_set_bounds({width}, {height}, {row}, {col})
    Tells Nvim the geometry of the popupmenu, to align floating windows with
    an external popup menu.

    Note that this method is not to be confused with
    |nvim_ui_pum_set_height()|, which sets the number of visible items in the
    popup menu, while this function sets the bounding box of the popup menu,
    including visual elements such as borders and sliders. Floats need not use
    the same font size, nor be anchored to exact grid corners, so one can set
    floating-point numbers to the popup menu geometry.

    Attributes: ~
        |RPC| only
        Since: 0.5.0

    Parameters: ~
      • {width}   Popupmenu width.
      • {height}  Popupmenu height.
      • {row}     Popupmenu row.
      • {col}     Popupmenu height.

nvim_ui_pum_set_height({height})                    *nvim_ui_pum_set_height()*
    Tells Nvim the number of elements displaying in the popupmenu, to decide
    <PageUp> and <PageDown> movement.

    Attributes: ~
        |RPC| only
        Since: 0.4.0

    Parameters: ~
      • {height}  Popupmenu height, must be greater than zero.

nvim_ui_set_focus({gained})                              *nvim_ui_set_focus()*
    Tells the nvim server if focus was gained or lost by the GUI

    Attributes: ~
        |RPC| only
        Since: 0.9.0

nvim_ui_set_option({name}, {value})                     *nvim_ui_set_option()*

    Attributes: ~
        |RPC| only
        Since: 0.1.0

nvim_ui_term_event({event}, {value})                    *nvim_ui_term_event()*
    Tells Nvim when a terminal event has occurred

    The following terminal events are supported:
    • "termresponse": The terminal sent an OSC or DCS response sequence to
      Nvim. The payload is the received response. Sets |v:termresponse| and
      fires |TermResponse|.

    Attributes: ~
        |RPC| only
        Since: 0.10.0

    Parameters: ~
      • {event}  Event name
      • {value}  Event payload

nvim_ui_try_resize({width}, {height})                   *nvim_ui_try_resize()*

    Attributes: ~
        |RPC| only
        Since: 0.1.0

                                                   *nvim_ui_try_resize_grid()*
nvim_ui_try_resize_grid({grid}, {width}, {height})
    Tell Nvim to resize a grid. Triggers a grid_resize event with the
    requested grid size or the maximum size if it exceeds size limits.

    On invalid grid handle, fails with error.

    Attributes: ~
        |RPC| only
        Since: 0.4.0

    Parameters: ~
      • {grid}    The handle of the grid to be changed.
      • {width}   The new requested width.
      • {height}  The new requested height.


 vim:tw=78:ts=8:sw=4:sts=4:et:ft=help:norl:
Title: Neovim UI Functions: Popup Menu Height, Focus, Options, Terminal Events, and Grid Resizing
Summary
This section details several Neovim UI functions for controlling the UI. `nvim_ui_pum_set_height` sets the number of visible elements in the popup menu. `nvim_ui_set_focus` notifies Neovim when the GUI gains or loses focus. `nvim_ui_set_option` allows setting UI options. `nvim_ui_term_event` reports terminal events to Neovim, such as responses to OSC or DCS sequences. Lastly, `nvim_ui_try_resize` and `nvim_ui_try_resize_grid` are used to request resizes of the overall UI and individual grids, respectively.