(lispref.info)Mode Line Format

Next: Hooks Prev: Minor Modes Up: Modes

Mode Line Format

   Each Emacs window (aside from minibuffer windows) includes a mode
line which displays status information about the buffer displayed in the
window.  The mode line contains information about the buffer such as its
name, associated file, depth of recursive editing, and the major and
minor modes of the buffer.

   This section describes how the contents of the mode line are
controlled.  It is in the chapter on modes because much of the
information displayed in the mode line relates to the enabled major and
minor modes.

   `mode-line-format' is a buffer-local variable that holds a template
used to display the mode line of the current buffer.  All windows for
the same buffer use the same `mode-line-format' and the mode lines will
appear the same (except perhaps for the percentage of the file scrolled
off the top).

   The mode line of a window is normally updated whenever a different
buffer is shown in the window, or when the buffer's modified-status
changes from `nil' to `t' or vice-versa.  If you modify any of the
variables referenced by `mode-line-format', you may want to force an
update of the mode line so as to display the new information.

 - Function: force-mode-line-update &optional ALL
     Force redisplay of the current buffer's mode line.  If ALL is
     non-`nil', then force redisplay of all mode lines.  This function
     is equivalent to `redraw-mode-line'.

   The mode line is usually displayed in inverse video; see
`mode-line-inverse-video' in Note: Inverse Video.

* Mode Line Data
The data structure that controls the mode line.
* Mode Line Variables
Variables used in that data structure.
* %-Constructs
Putting information into a mode line.

automatically generated by info2www