/kde/autobuild/kdebase/kdm/kfrontend/themer/kdmitem.h

/*
 *  Copyright (C) 2003 by Unai Garro <ugarro@users.sourceforge.net>
 *  Copyright (C) 2004 by Enrico Ros <rosenric@dei.unipd.it>
 *  Copyright (C) 2004 by Stephan Kulow <coolo@kde.org>
 *  Copyright (C) 2004 by Oswald Buddenhagen <ossi@kde.org>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 */

#ifndef KDMITEM_H
#define KDMITEM_H

#include <tqobject.h>
#include <tqvaluelist.h>
#include <tqrect.h>
#include <tqdom.h>

class KdmItem;
class KdmLayoutBox;
class KdmLayoutFixed;

class TQPainter;
class TQLayoutItem;

class KdmItem : public TQObject {
        Q_OBJECT

        friend class KdmThemer;

public:
        KdmItem( KdmItem *parent, const TQDomNode &node = TQDomNode(), const char *name = 0 );
        KdmItem( TQWidget *parent, const TQDomNode &node = TQDomNode(), const char *name = 0 ); // for the root

        virtual ~KdmItem();

        virtual void setGeometry( const TQRect &newGeometry, bool force );

        void paint( TQPainter *painter, const TQRect &boundaries );

        virtual void update();

        void mouseEvent( int x, int y, bool pressed = false, bool released = false );

        virtual TQRect placementHint( const TQRect &parentGeometry );

        void setBoxLayout( const TQDomNode &node = TQDomNode() );

        void setFixedLayout( const TQDomNode &node = TQDomNode() );

        TQString type() const { return itemType;        }
        void setType( const TQString &t ) { itemType = t; }
        void setBaseDir( const TQString &bd ) { basedir = bd; }

        TQString baseDir() const
        {
                if (basedir.isEmpty() && parent())
                        return static_cast<KdmItem *>( parent()->qt_cast( "KdmItem" ) )->baseDir();
                return basedir;
        }

        KdmItem *findNode( const TQString &id ) const;
        virtual void setWidget( TQWidget *widget );
        TQWidget *widget() const { return myWidget; }
        virtual void setLayoutItem( TQLayoutItem *item );

        virtual void hide( bool force = false );
        virtual void show( bool force = false );

        bool isHidden() const { return isShown != Shown; }
        bool isExplicitlyHidden() const { return isShown == ExplicitlyHidden; }
        TQRect rect() const { return area; }

        TQWidget *parentWidget() const;
        TQString getId() const { return id; }

signals:
        void needUpdate( int x, int y, int w, int h );
        void activated( const TQString &id );

protected slots:
        void widgetGone();
        void layoutItemGone();

protected:
        virtual TQSize sizeHint();

        virtual void drawContents( TQPainter *painter, const TQRect &region ) = 0;

        virtual void statusChanged();

        void needUpdate();

        // This enum identifies in which state the item is
        enum ItemState { Snormal, Sactive, Sprelight } state;

        static KdmItem *currentActive;

        // This struct can be filled in by derived items
        struct {
                bool incrementalPaint;
        } properties;

        // This is the placement of the item
        TQRect area;

        // This struct is filled in by KdmItem base class
        enum DataType { DTnone, DTpixel, DTnpixel, DTpercent, DTbox };
        struct {
                enum DataType xType, yType, wType, hType;
                int x;
                int y;
                int width;
                int height;
                TQString anchor;
        } pos;

        /* For internal use ONLY
         * Add a child item. This function is called automatically
         * when constructing an @p item with this as the parent.
         */
        void addChildItem( KdmItem *item );

        /* For internal use ONLY
         * Parse type and value of an attribute (pos tag), a font or a
         * color.
         */
        void parseAttribute( const TQString &, int &, enum DataType & );
        void parseFont( const TQString &, TQFont & );
        void parseColor( const TQString &, TQColor & );

        void inheritFromButton( KdmItem *button );
        void init( const TQDomNode &node = TQDomNode(), const char *name = 0 );

        TQString itemType, id;
        TQValueList<KdmItem *> m_children;

        int m_backgroundModifier;

        // Layouting related variables
        enum { MNone = 0, MFixed = 1, MBox = 2 } currentManager;
        KdmLayoutBox *boxManager;
        KdmLayoutFixed *fixedManager;

        // Compositing related variables
        TQImage *image;

        // defines the directory the theme is in (may be present in the parent)
        TQString basedir;

        TQWidget *myWidget;
        TQLayoutItem *myLayoutItem;

        enum { InitialHidden, ExplicitlyHidden, Shown } isShown;

        KdmItem *buttonParent;
};

#endif

---