3 * Messing with X atom properties
5 * (c) 2007 Straylight/Edgeware
8 /*----- Licensing notice --------------------------------------------------*
10 * This file is part of the Edgeware X tools collection.
12 * X tools is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
17 * X tools is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with X tools; if not, write to the Free Software Foundation,
24 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
34 /*----- Header files ------------------------------------------------------*/
40 /*----- Functions provided ------------------------------------------------*/
42 /* --- @xatom_set@ --- *
44 * Arguments: @Display *d@ = pointer to display
45 * @Window w@ = window to set
46 * @Atom p@ = property to set
47 * @Atom a@ = atom property value
51 * Use: Sets an atom property on a particular window.
54 extern void xatom_set(Display */*d*/, Window /*w*/, Atom /*p*/, Atom /*a*/);
56 /* --- @xatom_get@ --- *
58 * Arguments: @Display *d@ = pointer to display
59 * @Window w@ = window to set
60 * @Atom p@ = property to read
62 * Returns: Atom which is the value of the property.
64 * Use: Reads an atom property from a particular window. The value
65 * @None@ is returned if there is no atom value.
68 extern Atom xatom_get(Display */*d*/, Window /*w*/, Atom /*p*/);
70 /* --- @xatom_delete@ --- *
72 * Arguments: @Display *d@ = pointer to display
73 * @Window w@ = window containing atom
74 * @Atom p@ = property to delete
78 * Use: Removes a property from a window.
81 extern void xatom_delete(Display */*d*/, Window /*w*/, Atom /*p*/);
83 /* --- @xatom_wait@ --- *
85 * Arguments: @Display *d@ = pointer to display
86 * @Window w@ = window to watch
87 * @Atom p@ = property to fetch
88 * @const Atom *aa@ = pointer to vector of atoms
89 * @size_t n@ = numer of atoms in vector
91 * Returns: The matching atom.
93 * Use: Waits for the given property on the window to match one of
97 extern Atom xatom_wait(Display */*d*/, Window /*w*/, Atom /*p*/,
98 const Atom */*aa*/, size_t /*n*/);
100 /*----- That's all, folks -------------------------------------------------*/