GNU Info

(sawfish.info)Window Property Lists

---

Next: Window Attributes Up: Windows

---

Enter node , (file) or (file)node

Window Property Lists
=====================

   Many window manager extensions need to be able to associate Lisp data
with individual windows. For example, the module handling iconification
needs to associate a boolean value with each window--whether that
window is iconified or not.

   To solve this problem, Sawfish gives each window a property list.
These are exactly analogous to the property lists stored with each
symbol (Note: Property Lists.); they allow
values to be associated with Lisp symbols, for a particular window.

   Note that these properties are different to the properties that X
stores with each window, since these properties are internal to the
window manager (Note: X Properties).

 - Function: window-put window property value
     Set the lisp property named PROPERTY (a symbol) associated with
     window object WINDOW to VALUE.

 - Function: window-get window property
     Return the window property named PROPERTY associated with the
     window object WINDOW, or `nil' if no such property exists.

   For a list of the standard window properties, see Note: Standard
Properties.