230 lines
6.9 KiB
C++
230 lines
6.9 KiB
C++
// -*- mode: C++; indent-tabs-mode: nil; c-basic-offset: 2; -*-
|
|
#ifndef __screen_hh
|
|
#define __screen_hh
|
|
|
|
/*! @file screen.hh
|
|
@brief Screen manages a single screen
|
|
*/
|
|
|
|
extern "C" {
|
|
#include <X11/Xlib.h>
|
|
}
|
|
|
|
#include "otk/strut.hh"
|
|
#include "otk/rect.hh"
|
|
#include "otk/screeninfo.hh"
|
|
#include "otk/eventhandler.hh"
|
|
#include "otk/property.hh"
|
|
#include "otk/ustring.hh"
|
|
|
|
#include <string>
|
|
#include <list>
|
|
|
|
namespace ob {
|
|
|
|
class Client;
|
|
|
|
struct DesktopLayout {
|
|
enum Corner { TopLeft, TopRight, BottomRight, BottomLeft };
|
|
enum Direction { Horizontal, Vertical };
|
|
|
|
Direction orientation;
|
|
Corner start_corner;
|
|
unsigned int rows;
|
|
unsigned int columns;
|
|
};
|
|
|
|
//! Manages a single screen
|
|
/*!
|
|
*/
|
|
class Screen : public otk::EventHandler {
|
|
public:
|
|
//! Holds a list of otk::Strut objects
|
|
typedef std::vector<otk::Strut> StrutList;
|
|
//! Holds a list of otk::Rect objects
|
|
typedef std::vector<otk::Rect> RectList;
|
|
|
|
static const unsigned long event_mask = ColormapChangeMask |
|
|
EnterWindowMask |
|
|
LeaveWindowMask |
|
|
PropertyChangeMask |
|
|
SubstructureNotifyMask |
|
|
SubstructureRedirectMask |
|
|
ButtonPressMask |
|
|
ButtonReleaseMask;
|
|
|
|
//! All managed clients on the screen (in order of being mapped)
|
|
std::list<Client*> clients;
|
|
|
|
private:
|
|
//! Was %Openbox able to manage the screen?
|
|
bool _managed;
|
|
|
|
//! The number of the screen on the X server
|
|
int _number;
|
|
|
|
//! Information about this screen
|
|
const otk::ScreenInfo *_info;
|
|
|
|
//! Area usable for placement etc (total - struts), one per desktop,
|
|
//! plus one extra for windows on all desktops
|
|
RectList _area;
|
|
|
|
//! Combined strut from all of the clients' struts, one per desktop,
|
|
//! plus one extra for windows on all desktops
|
|
StrutList _struts;
|
|
|
|
//! An offscreen window which gets focus when nothing else has it
|
|
Window _focuswindow;
|
|
|
|
//! An offscreen window which shows that a NETWM compliant window manager is
|
|
//! running
|
|
Window _supportwindow;
|
|
|
|
//! A list of all managed clients on the screen, in their stacking order
|
|
std::list<Client*> _stacking;
|
|
|
|
//! The desktop currently being displayed
|
|
unsigned int _desktop;
|
|
|
|
//! The number of desktops
|
|
unsigned int _num_desktops;
|
|
|
|
//! The names of all desktops
|
|
otk::Property::StringVect _desktop_names;
|
|
|
|
//! The layout of the desktops as specified by an EWMH compliant pager
|
|
DesktopLayout _layout;
|
|
|
|
//! True when the window manager is in 'showing desktop' mode
|
|
bool _showing_desktop;
|
|
|
|
//! Calculate the Screen::_area member
|
|
void calcArea();
|
|
//! Set the list of supported NETWM atoms on the root window
|
|
void changeSupportedAtoms();
|
|
//! Set the client list on the root window
|
|
/*!
|
|
Sets the _NET_CLIENT_LIST root window property.<br>
|
|
Also calls Screen::updateStackingList.
|
|
*/
|
|
void changeClientList();
|
|
//! Set the client stacking list on the root window
|
|
/*!
|
|
Set the _NET_CLIENT_LIST_STACKING root window property.
|
|
*/
|
|
void changeStackingList();
|
|
//! Set the work area hint on the root window
|
|
/*!
|
|
Set the _NET_WORKAREA root window property.
|
|
*/
|
|
void changeWorkArea();
|
|
|
|
//! Get desktop names from the root window property
|
|
void updateDesktopNames();
|
|
|
|
//! Gets the layout of the desktops from the root window property
|
|
void updateDesktopLayout();
|
|
|
|
//! Changes to the specified desktop, displaying windows on it and hiding
|
|
//! windows on the others.
|
|
/*!
|
|
@param desktop The number of the desktop to switch to (starts from 0).
|
|
If the desktop is out of valid range, it is ignored.
|
|
*/
|
|
void changeDesktop(unsigned int desktop);
|
|
|
|
//! Changes the number of desktops.
|
|
/*!
|
|
@param num The number of desktops that should exist. This value must be
|
|
greater than 0 or it will be ignored.
|
|
*/
|
|
void changeNumDesktops(unsigned int num);
|
|
|
|
public:
|
|
//! Constructs a new Screen object
|
|
Screen(int screen);
|
|
//! Destroys the Screen object
|
|
virtual ~Screen();
|
|
|
|
inline int number() const { return _number; }
|
|
|
|
//! Returns if the screen was successfully managed
|
|
/*!
|
|
If this is false, then the screen should be deleted and should NOT be
|
|
used.
|
|
*/
|
|
inline bool managed() const { return _managed; }
|
|
|
|
//! An offscreen window which gets focus when nothing else has it
|
|
inline Window focuswindow() const { return _focuswindow; }
|
|
//! Returns the desktop being displayed
|
|
inline unsigned int desktop() const { return _desktop; }
|
|
//! Returns the number of desktops
|
|
inline unsigned int numDesktops() const { return _num_desktops; }
|
|
//! When true, the desktop is being shown and all clients are hidden
|
|
inline bool showingDesktop() const { return _showing_desktop; }
|
|
|
|
//! Returns the area of the screen not reserved by applications' Struts
|
|
/*!
|
|
@param desktop The desktop number of the area to retrieve for. A value of
|
|
0xffffffff will return an area that combines all struts
|
|
on all desktops.
|
|
*/
|
|
const otk::Rect& area(unsigned int desktop) const;
|
|
|
|
//! Gives the layout of how the desktops are being displayed, the number of
|
|
//! rows and columns etc.
|
|
const DesktopLayout& desktopLayout() const { return _layout; }
|
|
|
|
//! Shows and focuses the desktop and hides all the client windows, or
|
|
//! returns to the normal state, showing client windows.
|
|
void showDesktop(bool show);
|
|
|
|
//! Update's the screen's combined strut of all the clients.
|
|
/*!
|
|
Clients should call this whenever they change their strut.
|
|
*/
|
|
void updateStruts();
|
|
|
|
//! Manage any pre-existing windows on the screen
|
|
void manageExisting();
|
|
//! Manage a client window
|
|
/*!
|
|
This gives the window a frame, reparents it, selects events on it, etc.
|
|
*/
|
|
void manageWindow(Window window);
|
|
//! Unmanage a client
|
|
/*!
|
|
This removes the window's frame, reparents it to root, unselects events on
|
|
it, etc.
|
|
@param client The client to unmanage
|
|
*/
|
|
void unmanageWindow(Client *client);
|
|
|
|
//! Raises a client window above all others in its stacking layer
|
|
/*!
|
|
raiseWindow has a couple of constraints that lowerWindow does not.<br>
|
|
1) raiseWindow can be called after changing a Client's stack layer, and
|
|
the list will be reorganized properly.<br>
|
|
2) raiseWindow guarantees that XRestackWindows() will <i>always</i> be
|
|
called for the specified client.
|
|
*/
|
|
void raiseWindow(Client *client);
|
|
|
|
//! Lowers a client window below all others in its stacking layer
|
|
void lowerWindow(Client *client);
|
|
|
|
const otk::Property::StringVect& desktopNames() const
|
|
{ return _desktop_names; }
|
|
|
|
void installColormap(bool install) const;
|
|
|
|
virtual void propertyHandler(const XPropertyEvent &e);
|
|
virtual void clientMessageHandler(const XClientMessageEvent &e);
|
|
virtual void mapRequestHandler(const XMapRequestEvent &e);
|
|
};
|
|
|
|
}
|
|
|
|
#endif// __screen_hh
|