GNU Info

(sawfish.info)Frame Basics

---

Next: Frame Part Classes Up: Window Frames

---

Enter node , (file) or (file)node

Frame Basics
============

   The "frame" of a client window is defined as all decorations added
by the window manager. Usually these decorations will be immediately
adjacent to the outer edges of the window, but there is no requirement
to use this model.

   In Sawfish, each window frame is constructed from a list of "frame
parts", conceptually rectangular objects with a specified position
relative to the edges of the client window. When shaped images are used
to define frame parts, they are still thought of as being rectangular,
just with some pixels missing from the display.

   Each frame part has a list of attributes associated with it, these
include items defining the background of the part (i.e. a color or an
image), and items defining the foreground of the part (i.e. probably
some kind of text, with a color, font, etc...). Non-visual attributes
may also be defined, such as, for example, the keymap mapping events
occurring in the part to Lisp commands to execute (Note: Keymaps).

   So a window frame is defined in Lisp as a list of frame part
definitions (Note: Frame Part Definition). These frame parts are
added to the client window (in the order they are defined, so later
frame parts are above earlier parts at the same position), to produce
the entire window frame.