openbox/src/XAtom.hh

// XAtom.h for Openbox
// Copyright (c) 2002 - 2002 Ben Janens (ben at orodu.net)
//
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the "Software"),
// to deal in the Software without restriction, including without limitation
// the rights to use, copy, modify, merge, publish, distribute, sublicense,
// and/or sell copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.

#ifndef   __XAtom_h
#define   __XAtom_h

#include <X11/Xlib.h>
#include <X11/Xatom.h>
#include <vector>
#include <string>

class Blackbox;
class ScreenInfo;

class XAtom {
public:
  enum Atoms {
    // types
    cardinal,
    window,
    pixmap,
    atom,
    string,
    utf8_string,
    
#ifdef    HAVE_GETPID
    blackbox_pid,
#endif // HAVE_GETPID

    // window hints
    wm_colormap_windows,
    wm_protocols,
    wm_state,
    wm_delete_window,
    wm_take_focus,
    wm_change_state,
    motif_wm_hints,
    blackbox_attributes,
    blackbox_change_attributes,
    blackbox_hints,

    // blackbox-protocol atoms (wm -> client)
    blackbox_structure_messages,
    blackbox_notify_startup,
    blackbox_notify_window_add,
    blackbox_notify_window_del,
    blackbox_notify_window_focus,
    blackbox_notify_current_workspace,
    blackbox_notify_workspace_count,
    blackbox_notify_window_raise,
    blackbox_notify_window_lower,
    // blackbox-protocol atoms (client -> wm)
    blackbox_change_workspace,
    blackbox_change_window_focus,
    blackbox_cycle_window_focus,

    // NETWM atoms
    // root window properties
    net_supported,
    net_client_list,
    net_client_list_stacking,
    net_number_of_desktops,
    net_desktop_geometry,
    net_desktop_viewport,
    net_current_desktop,
    net_desktop_names,
    net_active_window,
    net_workarea,
    net_supporting_wm_check,
    net_virtual_roots,
    // root window messages
    net_close_window,
    net_wm_moveresize,
    // application window properties
    net_properties,
    net_wm_name,
    net_wm_desktop,
    net_wm_window_type,
    net_wm_state,
    net_wm_strut,
    net_wm_icon_geometry,
    net_wm_icon,
    net_wm_pid,
    net_wm_handled_icons,
    // application protocols
    net_wm_ping,

    // constant for how many atoms exist in the enumerator
    NUM_ATOMS
  };

  enum StringType {
    ansi,
    utf8,
    NUM_STRING_TYPE
  };

private:
  typedef std::vector<Window> SupportWindows;
  
  Display              *_display;
  // windows used to specify support for NETWM
  SupportWindows        _support_windows;
  Atom                  _atoms[NUM_ATOMS];

  Atom create(const char *name) const;

  void setValue(Window win, Atom atom, Atom type, unsigned char *data,
                int size, int nelements, bool append) const;
  bool getValue(Window win, Atom atom, Atom type,
                unsigned long &nelements, unsigned char **value,
                int size) const;

  // no copying!!
  XAtom(const XAtom &);
  XAtom& operator=(const XAtom&);

public:
  XAtom(Blackbox *bb);
  virtual ~XAtom();

  // setup support on a screen, each screen should call this once in its
  // constructor.
  void setSupported(const ScreenInfo *screen);
  
  void setValue(Window win, Atoms atom, Atoms type, unsigned long value) const;
  void setValue(Window win, Atoms atom, Atoms type,
                unsigned long value[], int elements) const;
  void setValue(Window win, Atoms atom, StringType type,
                const std::string &value) const;

  // the 'value' is allocated inside the function and
  // delete [] value needs to be called when you are done with it.
  // the 'value' array returned is null terminated, and has 'nelements'
  // elements in it plus the null.
  bool getValue(Window win, Atoms atom, Atoms type,
                unsigned long &nelements, unsigned long **value) const;
  bool getValue(Window win, Atoms atom, StringType type,
                std::string &value) const;
  
  void eraseValue(Window win, Atoms atom) const;

  // temporary function!! remove when not used in blackbox.hh anymore!!
  inline Atom getAtom(Atoms a)
  { Atom ret = _atoms[a]; assert(ret != 0); return ret; }
};

#endif // __XAtom_h