Next: , Previous: Completion Tooltip, Up: Completing Words


4.8 Pop-Up Frame

Calling completion-popup-frame when completing, bound to C-Down, displays the available completions in a separate Emacs frame positioned below the point. You can then use the usual Emacs motion keys to select a completion candidate and provisionally insert it in the buffer (up, down, M-p, M-n, C-p, C-n, pageup, C-v, M-v, pagedown, home, M-<, end and M->; you can also supply numerical optional arguments to these, as usual).

You can also toggle between displaying just the most likely completions or displaying all possible completions using completion-popup-toggle-all, bound to M-tab and M-/. If there are a lot of possible completions, it can take a while before they're displayed. If it's taking too long, use C-g to cancel. To dismiss the pop-up frame, use completion-popup-frame-dismiss, bound to C-up and M-up.

The pop-up frame can also be displayed automatically when completing, optionally after a time-delay. See Auto-Show a List of Completions.

completion-popup-frame
(C-down) Display completion candidates in a pop-up frame.
completion-popup-frame-toggle-all
(M-tab, M-/) Toggle between displaying the most likely completion candidates and displaying all possible completions.
completion-popup-frame-dismiss
(C-up, M-up) Dismiss the pop-up frame.

The following variables affect the pop-up frame:

completion-popup-frame-max-height
An integer specifying the maximum height (in rows) of pop-up frames.
completion-popup-frame-offset
A cons cell containing the number of pixels (an integer) by which to offset the pop-up frame by in the x and y directions (car and cdr, respectively).