KDFrame.h

Go to the documentation of this file.

/*
   KDChart - a multi-platform charting engine
   */
 
/****************************************************************************
 ** Copyright (C) 2001-2003 Klarälvdalens Datakonsult AB.  All rights reserved.
 **
 ** This file is part of the KDChart library.
 **
 ** This file may be distributed and/or modified under the terms of the
 ** GNU General Public License version 2 as published by the Free Software
 ** Foundation and appearing in the file LICENSE.GPL included in the
 ** packaging of this file.
 **
 ** Licensees holding valid commercial KDChart licenses may use this file in
 ** accordance with the KDChart Commercial License Agreement provided with
 ** the Software.
 **
 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 **
 ** See http://www.klaralvdalens-datakonsult.se/?page=products for
 **   information about KDChart Commercial License Agreements.
 **
 ** Contact info@klaralvdalens-datakonsult.se if any conditions of this
 ** licensing are not clear to you.
 **
 **********************************************************************/
#ifndef __KDFRAME_H__
#define __KDFRAME_H__
 
#include <tqapplication.h>
#include <tqfont.h>
#include <tqcolor.h>
#include <tqpixmap.h>
#include <tqpen.h>
#include <tqmap.h>
#include <tqobject.h>
#include <tqtextstream.h>
#include <tqdom.h>
 
#include <KDFrameProfileSection.h>
 

 

class KDCHART_EXPORT KDFrame : public TQObject
{
    TQ_OBJECT
  
    TQ_ENUMS( BackPixmapMode )
    TQ_ENUMS( SimpleFrame )
    TQ_ENUMS( ProfileName )
    TQ_ENUMS( CornerName )
    TQ_ENUMS( CornerStyle )
    TQ_ENUMS( KDFramePaintSteps )
 
public:
 

    enum BackPixmapMode { PixCentered, PixScaled, PixStretched };
 
public slots:

    static TQString backPixmapModeToString( BackPixmapMode type ) {
        switch( type ) {
            case PixCentered:
                return "Centered";
            case PixScaled:
                return "Scaled";
            case PixStretched:
                return "Stretched";
        }
 
        return "Stretched";
    }
 

    static BackPixmapMode stringToBackPixmapMode( const TQString& string ) {
        if( string == "Centered" )
            return PixCentered;
        else if( string == "Scaled" )
            return PixScaled;
        else if( string == "Stretched" )
            return PixStretched;
 
        return PixStretched;
    }
 
 
public:
 

    enum SimpleFrame { FrameFlat,        FrameElegance,
        FrameBoxRaized,   FrameBoxSunken,
        FramePanelRaized, FramePanelSunken,
        FrameSemicircular };
 
public slots:

    void setSimpleFrame( SimpleFrame    frame,
            int            lineWidth,
            int            midLineWidth,
            TQPen           pen,
            TQBrush         background     = TQBrush(),
            const TQPixmap* backPixmap     = 0,
            BackPixmapMode backPixmapMode = PixStretched );
 
public:
    enum ProfileName { ProfileTop,    ProfileRight,
        ProfileBottom, ProfileLeft };
 
public slots:
    void clearProfile( ProfileName name );

    void addProfileSection( ProfileName      name,
            int              wid,
            TQPen             pen,
            KDFrameProfileSection::Direction dir  = KDFrameProfileSection::DirPlain, // PENDING(blackie) possible enum problem
            KDFrameProfileSection::Curvature curv = KDFrameProfileSection::CvtPlain );

    void setProfile( ProfileName name, const KDFrameProfile& profile );

    const KDFrameProfile& profile( ProfileName name ) const;
 
public:

    enum CornerName { CornerTopLeft,
        CornerTopRight,
        CornerBottomLeft,
        CornerBottomRight,
        CornerUNKNOWN };
 
public slots:
    static TQString cornerNameToString( CornerName type ) {
        switch( type ) {
            case CornerTopLeft:
                return "TopLeft";
            case CornerTopRight:
                return "TopRight";
            case CornerBottomLeft:
                return "BottomLeft";
            case CornerBottomRight:
                return "BottomRight";
            case CornerUNKNOWN:
                return "UNKNOWN";
        }
 
        return "UNKNOWN";
    }
 

    static CornerName stringToCornerName( const TQString& string ) {
        if( string == "TopLeft" )
            return CornerTopLeft;
        else if( string == "TopRight" )
            return CornerTopRight;
        else if( string == "BottomLeft" )
            return CornerBottomLeft;
        else if( string == "BottomRight" )
            return CornerBottomRight;
        else if( string == "UNKNOWN" )
            return CornerUNKNOWN;
 
        return CornerUNKNOWN;
    }
 
public:
 

    enum CornerStyle { CornerNormal,
        CornerRound,
        CornerOblique };
 
public slots:
        static TQString cornerStyleToString( CornerStyle type ) {
            switch( type ) {
                case CornerNormal:
                    return "Normal";
                case CornerRound:
                    return "Round";
                case CornerOblique:
                    return "Oblique";
            }
 
            return "Normal";
        }
 

        static CornerStyle stringToCornerStyle( const TQString& string ) {
            if( string == "Normal" )
                return CornerNormal;
            else if( string == "Round" )
                return CornerRound;
            else if( string == "Oblique" )
                return CornerOblique;
 
            return CornerNormal;
        }
 
 
public:
 
// MOC_SKIP_BEGIN
    class KDCHART_EXPORT KDFrameCorner
        {
            friend class KDFrame;
            public:
            KDFrameCorner( CornerStyle           style   = CornerNormal,
                    int                   width   = 0,
                    KDFrameProfile* const profile = 0 )
                : _style( style ),
            _width( width )
            {
                if( profile )
                    _profile = *profile;
                else
                    _profile.clear();
            }
            virtual ~KDFrameCorner();

            static void createFrameCornerNode( TQDomDocument& document,
                    TQDomNode& parent,
                    const TQString& elementName,
                    const KDFrameCorner& corner );

            static bool readFrameCornerNode( const TQDomElement& element,
                    KDFrameCorner& corner );
 
            protected:
            void setAll( CornerStyle           style,
                    int                   width,
                    KDFrameProfile* const profile = 0 )
            {
                _style = style;
                _width = width;
                if( profile )
                    _profile = *profile;
                else
                    _profile.clear();
            }
            CornerStyle style() const
            {
                return _style;
            }
            int width() const
            {
                return _width;
            }
            const KDFrameProfile& profile() const
            {
                return _profile;
            }
            private:
            CornerStyle  _style;
            int          _width;
            KDFrameProfile _profile;
        };
 
// MOC_SKIP_END
 
public slots:
        void setCorner( CornerName name,
                CornerStyle style,
                int width,
                KDFrameProfile* const profile = 0 )
        {
            switch( name ) {
                case CornerTopLeft:     _cornerTL.setAll( style, width, profile );
                                        break;
                case CornerTopRight:    _cornerTR.setAll( style, width, profile );
                                        break;
                case CornerBottomLeft:  _cornerBL.setAll( style, width, profile );
                                        break;
                case CornerBottomRight: _cornerBR.setAll( style, width, profile );
                                        break;
                case CornerUNKNOWN:
                                        break;
            }
        }

        void setCorners( CornerStyle style,
                int width,
                KDFrameProfile* const profile = 0 )
        {
            _cornerTL.setAll( style, width, profile );
            _cornerTR.setAll( style, width, profile );
            _cornerBL.setAll( style, width, profile );
            _cornerBR.setAll( style, width, profile );
        }
 

        CornerStyle cornerStyle( CornerName name ) const
        {
            switch( name ) {
                case CornerTopLeft:     return _cornerTL.style();
                case CornerTopRight:    return _cornerTR.style();
                case CornerBottomLeft:  return _cornerBL.style();
                case CornerBottomRight: return _cornerBR.style();
                case CornerUNKNOWN:
                default:                return CornerNormal;
            }
        }

        int cornerWidth( CornerName name ) const
        {
            switch( name ) {
                case CornerTopLeft:     return _cornerTL.width();
                case CornerTopRight:    return _cornerTR.width();
                case CornerBottomLeft:  return _cornerBL.width();
                case CornerBottomRight: return _cornerBR.width();
                case CornerUNKNOWN:
                default:                return 0;
            }
        }

        const KDFrameProfile& cornerProfile( CornerName name ) const
        {
            switch( name ) {
                case CornerUNKNOWN:
                case CornerTopLeft:     return _cornerTL.profile();
                case CornerTopRight:    return _cornerTR.profile();
                case CornerBottomLeft:  return _cornerBL.profile();
                case CornerBottomRight: return _cornerBR.profile();
                default: return _cornerTL.profile();
            }
        }
 

        void setSunPos( CornerName sunPos )
        {
            _sunPos = sunPos;
        }

        CornerName sunPos() const
        {
            return _sunPos;
        }
 

        void setBackground( TQBrush background = TQBrush( TQt::NoBrush ) )
        {
            _background = background;
        }

        void setBackPixmap( const TQPixmap* backPixmap     = 0,
                BackPixmapMode backPixmapMode = PixStretched )
        {
            _backPixmap     = backPixmap ? *backPixmap : TQPixmap();
            _backPixmapMode = backPixmapMode;
        }

        const TQBrush& background( const TQPixmap*& backPixmap,
                BackPixmapMode& backPixmapMode ) const
        {
            backPixmap     = &_backPixmap;
            backPixmapMode =  _backPixmapMode;
            return _background;
        }
 

        void setInnerRect( TQRect innerRect )
        {
            _innerRect = innerRect;
        }

        TQRect innerRect() const
        {
            return _innerRect;
        }
 

        virtual void paintBackground( TQPainter& painter, const TQRect& innerRect ) const;
        virtual void paintEdges( TQPainter& painter, const TQRect& innerRect ) const;
        virtual void paintCorners( TQPainter& painter, const TQRect& innerRect ) const;
 
 
public:
        enum KDFramePaintSteps { PaintBackground, PaintEdges, PaintCorners, PaintBorder, PaintAll };
 
public slots:

        virtual void paint( TQPainter* painter,
                KDFramePaintSteps steps = PaintAll,
                TQRect innerRect         = TQRect(0,0,0,0) ) const;
 

        void clearAll()
        {
            _background     = TQBrush();
            _backPixmap     = TQPixmap();
            _backPixmapMode = PixStretched;
            _shadowWidth    = 0;
            _sunPos         = CornerTopLeft;
            _innerRect      = TQRect( 0,0, 0,0 );
            _topProfile.clear();
            _rightProfile.clear();
            _bottomProfile.clear();
            _leftProfile.clear();
            _cornerTL.setAll( CornerNormal, 0, 0 );
            _cornerTR.setAll( CornerNormal, 0, 0 );
            _cornerBL.setAll( CornerNormal, 0, 0 );
            _cornerBR.setAll( CornerNormal, 0, 0 );
        }
 
public:

    KDFrame( TQRect          innerRect      = TQRect(0,0,0,0),
            SimpleFrame    frame          = FrameFlat,
            int            lineWidth      = 1,
            int            midLineWidth   = 0,
            TQPen           pen            = TQPen(),   // solid black line with 0 width
            TQBrush         background     = TQBrush(), // no brush
            const TQPixmap* backPixmap     = 0,        // no pixmap
            BackPixmapMode backPixmapMode = PixStretched,
            int            shadowWidth    = 0,
            CornerName     sunPos         = CornerTopLeft )
    {
        _profileSections.setAutoDelete( true );
        _innerRect = innerRect;
        setSimpleFrame( frame,
                        lineWidth,
                        midLineWidth,
                        pen,
                        background,
                        backPixmap,
                        backPixmapMode );
        _shadowWidth = shadowWidth;
        _sunPos      = sunPos;
    }
 
 
/*
    Constructor. Set up a frame by copying settings of another frame.
 
    The constructor does *not* have a \c parent parameter since drawing
    of the frame is not done transparently but by (one or more) explicit
    calls of the frames paint() methode.  See explanation given there
    to learn about the why and how of this...
 
    \note The rectangle applies to the <b>inner</b> area of the frame.
    The Frame is drawn around this area: touching it but not covering it.
    The outer size of the frame and the position of its outer left corner
    depends from the frame profile width.
 
    \sa rect, setInnerRect, setProfile
 
    KDFrame( TQRect innerRect,
            const KDFrame& R,
            CornerName sunPos = CornerUNKNOWN )
    {
        deepCopy( *this, R );
        if( innerRect.isValid() )
            _innerRect = innerRect;
        if( CornerUNKNOWN != sunPos )
            _sunPos = sunPos;
 
        _profileSections.setAutoDelete( true );
    }
*/
private:
    KDFrame( const KDFrame& ) : TQObject(0) {}
    KDFrame& operator=( const KDFrame& ){return *this;}
 
 
 
public:
    virtual ~KDFrame();
 
    /*
    Kopierroutine, aufgerufen im Copy-C'tor und im Zuweisungs-Operator
    */
    static void deepCopy( KDFrame& D, const KDFrame& R )
    {
        D._shadowWidth    = R._shadowWidth;
        D._sunPos         = R._sunPos;
        D._background     = R._background;
        D._backPixmap     = R._backPixmap;
        D._backPixmapMode = R._backPixmapMode;
        D._innerRect      = R._innerRect;
        D._topProfile     = R._topProfile;
        D._rightProfile   = R._rightProfile;
        D._bottomProfile  = R._bottomProfile;
        D._leftProfile    = R._leftProfile;
        D._cornerTL       = R._cornerTL;
        D._cornerTR       = R._cornerTR;
        D._cornerBL       = R._cornerBL;
        D._cornerBR       = R._cornerBR;
        D._profileSections= R._profileSections;
        D._profileSections.setAutoDelete( true );
        R.setProfileSectionsAutoDelete( false );
    }
 
    friend TQTextStream& operator<<( TQTextStream& s, const KDFrame& p );
    friend TQTextStream& operator>>( TQTextStream& s, KDFrame& p );

    static void createFrameNode( TQDomDocument& document, TQDomNode& parent,
            const TQString& elementName,
            const KDFrame& frame );

    static void createFrameProfileNode( TQDomDocument& document,
            TQDomNode& parent,
            const TQString& elementName,
            KDFrameProfile profile );

    static bool readFrameNode( const TQDomElement& element,
            KDFrame& frame );

    static bool readFrameProfileNode( const TQDomElement& element,
            KDFrameProfile& profile );
 
signals:
    void changed();
 
private:
    void setProfileSectionsAutoDelete( bool on ) const
    {
        ((KDFrame*)this)->_profileSections.setAutoDelete( on );
    }

    int _shadowWidth;

    CornerName _sunPos;

    TQBrush _background;

    TQPixmap _backPixmap;

    BackPixmapMode _backPixmapMode;

    TQRect _innerRect;

    KDFrameProfile _profileSections;

    KDFrameProfile _topProfile;
    KDFrameProfile _rightProfile;
    KDFrameProfile _bottomProfile;
    KDFrameProfile _leftProfile;

    KDFrameCorner _cornerTL;
    KDFrameCorner _cornerTR;
    KDFrameCorner _cornerBL;
    KDFrameCorner _cornerBR;
};
 

TQTextStream& operator<<( TQTextStream& s, const KDFrame& p );
 

TQTextStream& operator>>( TQTextStream& s, KDFrame& p );
 
 
#endif