39.3 Frame Titles

Every frame has a title; most window managers display the frame title at the top of the frame. You can specify an explicit title with the name frame property. But normally you don’t specify this explicitly, and SXEmacs computes the title automatically.

SXEmacs computes the frame title based on a template stored in the variable frame-title-format.

Variable: frame-title-format

This variable specifies how to compute a title for a frame when you have not explicitly specified one.

The variable’s value is actually a modeline construct, just like modeline-format. See Modeline Data.

Variable: frame-icon-title-format

This variable specifies how to compute the title for an iconified frame, when you have not explicitly specified the frame title. This title appears in the icon itself.

Function: x-set-frame-icon-pixmap frame pixmap &optional mask

This function sets the icon of the given frame to the given image instance, which should be an image instance object (as returned by make-image-instance), a glyph object (as returned by make-glyph), or nil. If a glyph object is given, the glyph will be instantiated on the frame to produce an image instance object.

If the given image instance has a mask, that will be used as the icon mask; however, not all window managers support this.

The window manager is also not required to support color pixmaps, only bitmaps (one plane deep).

If the image instance does not have a mask, then the optional third argument may be the image instance to use as the mask (it must be one plane deep). See Glyphs.