fluxbox/src/FbTk/XLayer.hh

// XLayer.hh for FbTk - fluxbox toolkit
// Copyright (c) 2003 Henrik Kinnunen (fluxgen at users.sourceforge.net)
//                and Simon Bowden    (rathnor at users.sourceforge.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.

// $Id: XLayer.hh,v 1.5 2003/12/16 17:06:52 fluxgen Exp $


#ifndef FBTK_XLAYER_HH
#define FBTK_XLAYER_HH

#include <list>
#include "Layer.hh"
#include "MultLayers.hh"

namespace FbTk {

class XLayerItem;

class XLayer : public FbTk::Layer<XLayerItem, std::list<XLayerItem *> > {
public:

    XLayer(MultLayers &manager, int layernum);
    ~XLayer();

    typedef std::list<XLayerItem *> ItemList;
    typedef std::list<XLayerItem *>::iterator iterator;
    
    //typedef std::list<XLayerItem *>::reverse_iterator reverse_iterator;

    void setLayerNum(int layernum) { m_layernum = layernum; };
    int  getLayerNum() { return m_layernum; };
    void restack();
    int countWindows();
    void stackBelowItem(XLayerItem *item, XLayerItem *above);
    XLayerItem *getLowestItem();
    XLayerItem *getItemBelow(XLayerItem &item);
    XLayerItem *getItemAbove(XLayerItem &item);

    const ItemList &getItemList() const { return itemList(); }
    ItemList &getItemList() { return itemList(); }

    // we redefine these as XLayer has special optimisations, and X restacking needs
    iterator insert(XLayerItem &item, unsigned int pos=0);
    void remove(XLayerItem &item);

    // move highest to bottom
    void cycleUp();
    void cycleDown();
    // just go above the next window up in the current layer (not all the way to the top)
    void stepUp(XLayerItem &item);
    void stepDown(XLayerItem &item);

    // bring to top of layer
    void raise(XLayerItem &item);
    void lower(XLayerItem &item);

    // raise it, but don't make it permanent (i.e. restack will revert)
    void tempRaise(XLayerItem &item);

    // send to next layer up
    void raiseLayer(XLayerItem &item);
    void lowerLayer(XLayerItem &item);
    void moveToLayer(XLayerItem &item, int layernum);

private:
    MultLayers &m_manager;
    int m_layernum;

};

} // namespace FbTk

#endif // FBTK_XLAYER_HH