Go to the first, previous, next, last section, table of contents.

Face Convenience Functions

Function: set-face-foreground face color &optional locale tag how-to-add
Function: set-face-background face color &optional locale tag how-to-add
These functions set the foreground (respectively, background) color of face face to color. The argument color should be a string (the name of a color) or a color object as returned by make-color (see section Colors).

Function: set-face-background-pixmap face pixmap &optional locale tag how-to-add
This function sets the background pixmap of face face to pixmap. The argument pixmap should be a string (the name of a bitmap or pixmap file; the directories listed in the variable x-bitmap-file-path will be searched) or a glyph object as returned by make-glyph (see section Glyphs). The argument may also be a list of the form (width height data) where width and height are the size in pixels, and data is a string, containing the raw bits of the bitmap.

Function: set-face-font face font &optional locale tag how-to-add
This function sets the font of face face. The argument font should be a string or a font object as returned by make-font (see section Fonts).

Function: set-face-underline-p face underline-p &optional locale tag how-to-add
This function sets the underline property of face face.

Function: face-foreground face &optional locale
Function: face-background face &optional locale
These functions return the foreground (respectively, background) color specifier of face face. See section Colors.

Function: face-background-pixmap face &optional locale
This function return the background-pixmap glyph object of face face.

Function: face-font face &optional locale
This function returns the font specifier of face face. (Note: This is not the same as the function face-font in FSF Emacs.) See section Fonts.

Function: face-font-name face &optional domain
This function returns the name of the font of face face, or nil if it is unspecified. This is basically equivalent to (font-name (face-font face) domain) except that it does not cause an error if face's font is nil. (This function is named face-font in FSF Emacs.)

Function: face-underline-p face &optional locale
This function returns the underline property of face face.

Function: face-foreground-instance face &optional domain
Function: face-background-instance face &optional domain
These functions return the foreground (respectively, background) color specifier of face face. See section Colors.

Function: face-background-pixmap-instance face &optional domain
This function return the background-pixmap glyph object of face face.

Function: face-font-instance face &optional domain
This function returns the font specifier of face face. See section Fonts.


Go to the first, previous, next, last section, table of contents.