Next: , Previous: , Up: Frames   [Contents][Index]

39.5 Finding All Frames

Function: frame-list

The function frame-list returns a list of all the frames that have not been deleted. It is analogous to buffer-list for buffers. The list that you get is newly created, so modifying the list doesn’t have any effect on the internals of SXEmacs.

Function: device-frame-list &optional device

This function returns a list of all frames on device. If device is nil, the selected device will be used.

Function: visible-frame-list &optional device

This function returns a list of just the currently visible frames. If device is specified only frames on that device will be returned. See Visibility of Frames. (TTY frames always count as “visible”, even though only the selected one is actually displayed.)

Function: next-frame &optional frame which-frames which-devices

The function next-frame lets you cycle conveniently through all the frames from an arbitrary starting point. It returns the “next” frame after frame in the cycle. If frame defaults to the selected frame.

The second argument, which-frames, says which frames to consider:


Consider only frames that are visible.


Consider only frames that are iconic.


Consider only frames that are invisible (this is different from iconic).


Consider frames that are visible or iconic.


Consider frames that are invisible or iconic.


Consider all frames except minibuffer-only ones.


Like visible but omits minibuffer-only frames.


Like iconic but omits minibuffer-only frames.


Like invisible but omits minibuffer-only frames.


Like visible-iconic but omits minibuffer-only frames.


Like invisible-iconic but omits minibuffer-only frames.


Identical to nomini.


Consider only the window window’s frame and any frame now using window as the minibuffer.

any other value

Consider all frames.

The optional argument which-devices further clarifies on which devices to search for frames as specified by which-frames.


Consider all devices on the selected console.


Consider only the one device device.


Consider all devices on console.


Consider all devices with device type device-type.


Consider all devices on window system consoles.

anything else

Consider all devices without restriction.

Function: previous-frame &optional frame which-frames which-devices

Like next-frame, but cycles through all frames in the opposite direction.

See also next-window and previous-window, in Cyclic Window Ordering.

Next: , Previous: , Up: Frames   [Contents][Index]