kmultitabbar.h

Go to the documentation of this file.

/***************************************************************************
                          kmultitabbar.h -  description
                             -------------------
    begin                :  2001
    copyright            : (C) 2001,2002,2003 by Joseph Wenninger <jowenn@kde.org>
 ***************************************************************************/

/***************************************************************************
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library 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
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public License
    along with this library; see the file COPYING.LIB.  If not, write to
    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
    Boston, MA 02110-1301, USA.
 ***************************************************************************/

#ifndef _KMultitabbar_h_
#define _KMultitabbar_h_

#include <QtGui/QLayout>
#include <QtCore/QString>
#include <QtCore/QList>
#include <QtGui/QPushButton>

#include <kdeui_export.h>

class QPixmap;
class QPainter;
class QMenu;
class QStyleOptionToolButton;

class KMultiTabBarPrivate;
class KMultiTabBarTabPrivate;
class KMultiTabBarButtonPrivate;
class KMultiTabBarInternal;

class KDEUI_EXPORT KMultiTabBar: public QWidget
{
    Q_OBJECT
    Q_ENUMS(KMultiTabBarPosition KMultiTabBarStyle)
    Q_PROPERTY(KMultiTabBarPosition position READ position WRITE setPosition)
    Q_PROPERTY(KMultiTabBarStyle tabStyle READ tabStyle WRITE setStyle)
public:
    enum KMultiTabBarPosition { Left, Right, Top, Bottom };

    enum KMultiTabBarStyle{VSNET=0, KDEV3ICON=2,STYLELAST=0xffff};

    explicit KMultiTabBar(KMultiTabBarPosition pos, QWidget *parent=0 );
    virtual ~KMultiTabBar();

    int appendButton(const QPixmap &pic,int id=-1,QMenu* popup=0,const QString& not_used_yet=QString());
    void removeButton(int id);
    int appendTab(const QPixmap &pic,int id=-1,const QString& text=QString());
    void removeTab(int id);
    void setTab(int id ,bool state);
    bool isTabRaised(int id) const;
    class KMultiTabBarButton *button(int id) const;

    class KMultiTabBarTab *tab(int id) const;

    void setPosition(KMultiTabBarPosition pos);

    KMultiTabBarPosition position() const;

    void setStyle(KMultiTabBarStyle style);

    KMultiTabBarStyle tabStyle() const;

protected:
    friend class KMultiTabBarButton;
    virtual void fontChange( const QFont& );
    void updateSeparator();
private:
    KMultiTabBarPrivate * const d;
};

class KDEUI_EXPORT KMultiTabBarButton: public QPushButton
{
    Q_OBJECT
public:
    int id() const;
    virtual ~KMultiTabBarButton();

public Q_SLOTS:
    void setText(const QString &text);

Q_SIGNALS:
    void clicked(int id);
protected Q_SLOTS:
    virtual void slotClicked();

protected:
    virtual void hideEvent( class QHideEvent*);
    virtual void showEvent( class QShowEvent*);
    virtual void paintEvent( class QPaintEvent*);

    KMultiTabBarButton(const QPixmap& pic, const QString&, int id, QWidget *parent);
private:
    friend class KMultiTabBar;

    int m_id;
    KMultiTabBarButtonPrivate * const d;
};

class KDEUI_EXPORT KMultiTabBarTab: public KMultiTabBarButton
{
    Q_OBJECT
public:
    virtual ~KMultiTabBarTab();
    virtual QSize sizeHint() const;
    virtual QSize minimumSizeHint() const;

public Q_SLOTS:
    void setPosition(KMultiTabBar::KMultiTabBarPosition);

    void setStyle(KMultiTabBar::KMultiTabBarStyle);

    void setState(bool state);

    void setIcon(const QString&);
    void setIcon(const QPixmap&);
protected:
    virtual void paintEvent(QPaintEvent *);
private:
    KMultiTabBar::KMultiTabBarPosition m_position;
    KMultiTabBar::KMultiTabBarStyle m_style;
    
    void  computeMargins (int* hMargin, int* vMargin) const;
    QSize computeSizeHint(bool withText) const;
    bool shouldDrawText() const;
    bool isVertical()     const;
    QPixmap iconPixmap()  const;
    
    void initStyleOption(QStyleOptionToolButton* opt) const;

    friend class KMultiTabBarInternal;
    KMultiTabBarTab(const QPixmap& pic, const QString&, int id, QWidget *parent,
                    KMultiTabBar::KMultiTabBarPosition pos, KMultiTabBar::KMultiTabBarStyle style);
    KMultiTabBarTabPrivate * const d;
};

#endif
// kate: indent-width 4; replace-tabs on; tab-width 4; space-indent on;