watch for when screens cant be managed
[mikachu/openbox.git] / src / screen.hh
1 // -*- mode: C++; indent-tabs-mode: nil; c-basic-offset: 2; -*-
2 #ifndef   __screen_hh
3 #define   __screen_hh
4
5 /*! @file screen.hh
6   @brief OBScreen manages a single screen
7 */
8
9 extern "C" {
10 #include <X11/Xlib.h>
11 }
12
13 #include "otk/image.hh"
14 #include "otk/strut.hh"
15 #include "otk/rect.hh"
16 #include "otk/point.hh"
17 #include "otk/style.hh"
18 #include "otk/configuration.hh" // TEMPORARY
19
20 #include <string>
21
22 namespace ob {
23
24 class OBClient;
25
26 //! Manages a single screen
27 /*!
28 */
29 class OBScreen {
30 public:
31   //! Holds a list of OBClient objects
32   typedef std::vector<OBClient*> ClientList;
33   //! Holds a list of otk::Strut objects
34   typedef std::list<otk::Strut*> StrutList;
35
36   static const unsigned long event_mask = ColormapChangeMask |
37                                           EnterWindowMask |
38                                           LeaveWindowMask |
39                                           PropertyChangeMask |
40                                           SubstructureNotifyMask |
41                                           SubstructureRedirectMask |
42                                           ButtonPressMask |
43                                           ButtonReleaseMask;
44
45 private:
46   //! Was %Openbox able to manage the screen?
47   bool _managed;
48
49   //! The number of the screen on the X server
50   int _number;
51
52   //! Information about this screen
53   const otk::ScreenInfo *_info;
54   
55   //! The Image Control used for rendering on the screen
56   otk::BImageControl *_image_control;
57
58   //! The style with which to render on the screen
59   otk::Style _style;
60
61   //! Is the root colormap currently installed?
62   bool _root_cmap_installed;
63
64   //! The dimentions of the screen
65   otk::Point _size;
66
67   //! All managed clients on the screen
68   ClientList _clients;
69
70   //! Area usable for placement etc (total - struts)
71   otk::Rect _area;
72
73   //! Areas of the screen reserved by applications
74   StrutList _struts;
75
76
77   //! Calculate the OBScreen::_area member
78   void calcArea();
79   //! Set the client list on the root window
80   /*!
81     Sets the _NET_CLIENT_LIST root window property.<br>
82     Also calls OBScreen::updateStackingList.
83   */
84   void setClientList();
85   //! Set the client stacking list on the root window
86   /*!
87     Set the _NET_CLIENT_LIST_STACKING root window property.
88   */
89   void setStackingList();
90   //! Set the work area hint on the root window
91   /*!
92     Set the _NET_WORKAREA root window property.
93   */
94   void setWorkArea();
95   
96 public:
97   //! Constructs a new OBScreen object
98   OBScreen(int screen, const otk::Configuration &config);
99   //! Destroys the OBScreen object
100   virtual ~OBScreen();
101
102   //! Returns if the screen was successfully managed
103   /*!
104     If this is false, then the screen should be deleted and should NOT be
105     used.
106   */
107   inline bool managed() const { return _managed; }
108   //! Returns the Image Control used for rendering on the screen
109   inline otk::BImageControl *imageControl() { return _image_control; }
110   //! Returns the dimentions of the screen
111   inline const otk::Point &size() const { return _size; }
112   //! Returns the area of the screen not reserved by applications' Struts
113   inline const otk::Rect &area() const { return _area; }
114   //! Returns the style in use on the screen
115   inline const otk::Style *style() const { return &_style; }
116
117
118   //! Adds a window's strut to the screen's list of reserved spaces
119   void addStrut(otk::Strut *strut);
120   //! Removes a window's strut from the screen's list of reserved spaces
121   void removeStrut(otk::Strut *strut);
122
123   //! Loads a new style on the screen
124   void loadStyle(const otk::Configuration &config);
125
126   //! Manage any pre-existing windows on the screen
127   void manageExisting();
128   //! Manage a client window
129   /*!
130     This gives the window a frame, reparents it, selects events on it, etc.
131   */
132   void manageWindow(Window window);
133   //! Unmanage a client
134   /*!
135     This removes the window's frame, reparents it to root, unselects events on
136     it, etc.
137   */
138   void unmanageWindow(OBClient *client);
139 };
140
141 }
142
143 #endif// __screen_hh