Function: set-face-background

set-face-background is an interactive and byte-compiled function defined in faces.el.gz.

Signature

(set-face-background FACE COLOR &optional FRAME)

Documentation

Change the background color of face FACE to COLOR (a string).

FRAME nil or not specified means change face on all frames. COLOR can be a system-defined color name (see list-colors-display) or a hex spec of the form #RRGGBB. When called interactively, prompts for the face and color.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/faces.el.gz
;; Implementation note: Emulating gray background colors with a
;; stipple pattern is now part of the face realization process, and is
;; done in C depending on the frame on which the face is realized.

(defun set-face-background (face color &optional frame)
  "Change the background color of face FACE to COLOR (a string).
FRAME nil or not specified means change face on all frames.
COLOR can be a system-defined color name (see `list-colors-display')
or a hex spec of the form #RRGGBB.
When called interactively, prompts for the face and color."
  (interactive (read-face-and-attribute :background))
  (set-face-attribute face frame :background (or color 'unspecified)))