Function: set-frame-selected-window

set-frame-selected-window is a function defined in window.c.

Signature

(set-frame-selected-window FRAME WINDOW &optional NORECORD)

Documentation

Set selected window of FRAME to WINDOW.

FRAME must be a live frame and defaults to the selected one. If FRAME is the selected frame, this makes WINDOW the selected window. Optional argument NORECORD non-nil means to neither change the order of recently selected windows nor the buffer list. WINDOW must denote a live window. Return WINDOW.

Probably introduced at or before Emacs version 23.1.

Source Code

// Defined in /usr/src/emacs/src/window.c
{
  if (NILP (frame))
    frame = selected_frame;

  CHECK_LIVE_FRAME (frame);
  CHECK_LIVE_WINDOW (window);

  if (! EQ (frame, WINDOW_FRAME (XWINDOW (window))))
    error ("In `set-frame-selected-window', WINDOW is not on FRAME");

  if (EQ (frame, selected_frame))
    return Fselect_window (window, norecord);
  else
    {
      fset_selected_window (XFRAME (frame), window);
      /* Don't clear FRAME's select_mini_window_flag here.  */
      return window;
    }
}