A frame on a graphical display may be visible, invisible, or iconified. If it is visible, its contents are displayed in the usual manner. If it is iconified, its contents are not displayed, but there is a little icon somewhere to bring the frame back into view (some window managers refer to this state as minimized rather than iconified, but from Emacs' point of view they are the same thing). If a frame is invisible, it is not displayed at all.
Visibility is meaningless on text terminals, since only the selected one is actually displayed in any case.
This function returns the visibility status of frame frame. The value is
tif frame is visible,
nilif it is invisible, and
iconif it is iconified.
On a text terminal, all frames are considered “visible” for the purposes of this function, even though only one frame is displayed. See Raising and Lowering.
This function iconifies frame frame. If you omit frame, it iconifies the selected frame.
This function makes frame frame visible. If you omit frame, it makes the selected frame visible. This does not raise the frame, but you can do that with
raise-frameif you wish (see Raising and Lowering).
This function makes frame frame invisible. If you omit frame, it makes the selected frame invisible.
Unless force is non-
nil, this function refuses to make frame invisible if all other frames are invisible..
The visibility status of a frame is also available as a frame parameter. You can read or change it as such. See Management Parameters. The user can also iconify and deiconify frames with the window manager. This happens below the level at which Emacs can exert any control, but Emacs does provide events that you can use to keep track of such changes. See Misc Events.