kurlbar.h

/* This file is part of the KDE libraries
    Copyright (C) 2001,2002,2003 Carsten Pfeiffer <pfeiffer@kde.org>
 
    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, version 2.
 
    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 KURLBAR_H
#define KURLBAR_H
 
#include <tqevent.h>
#include <tqframe.h>
#include <tqtooltip.h>
 
#include <kdialogbase.h>
#include <kicontheme.h>
#include <tdelistbox.h>
#include <kurl.h>
 
class TDEConfig;
class KURLBar;

class TDEIO_EXPORT KURLBarItem : public TQListBoxPixmap
{
public:
    KURLBarItem( KURLBar *parent, const KURL& url, bool persistent,
                 const TQString& description = TQString::null,
                 const TQString& icon = TQString::null,
                 TDEIcon::Group group = TDEIcon::Panel );

    KURLBarItem( KURLBar *parent, const KURL& url,
                 const TQString& description = TQString::null,
                 const TQString& icon = TQString::null,
                 TDEIcon::Group group = TDEIcon::Panel );

    ~KURLBarItem();

    void setURL( const KURL& url );
    void setIcon( const TQString& icon, TDEIcon::Group group = TDEIcon::Panel );
    void setDescription( const TQString& desc );
    void setToolTip( const TQString& tip );

    TQSize sizeHint() const;

    virtual int width( const TQListBox * ) const;
    virtual int height( const TQListBox * ) const;

    const KURL& url() const                     { return m_url; }
    const TQString& description() const          { return m_description; }
    const TQString& icon() const                 { return m_icon; }
    TQString toolTip() const;
    TDEIcon::Group iconGroup() const              { return m_group; }
    virtual const TQPixmap * pixmap() const      { return &m_pixmap; }

    void setApplicationLocal( bool local );

    bool applicationLocal() const               { return m_appLocal; }

    bool isPersistent() const;
 
protected:
    virtual void paint( TQPainter *p );
 
private:
    int iconSize() const;
    void init( const TQString& icon, TDEIcon::Group group,
               const TQString& description, bool persistent );
 
    KURL m_url;
    TQString m_description;
    TQString m_icon;
    TQString m_toolTip;
    TQPixmap m_pixmap;
    TDEIcon::Group m_group;
    KURLBar *m_parent;
    bool m_appLocal :1;
 
protected:
    virtual void virtual_hook( int id, void* data );
private:
    class KURLBarItemPrivate;
    KURLBarItemPrivate *d;
};
 

 
 
class KURLBarListBox;

class TDEIO_EXPORT KURLBar : public TQFrame
{
    TQ_OBJECT
 
public:
    KURLBar( bool useGlobalItems,
             TQWidget *parent = 0, const char *name = 0, WFlags f = 0 );
    ~KURLBar();

    virtual KURLBarItem * insertItem( const KURL& url,
                                      const TQString& description,
                                      bool applicationLocal = true,
                                      const TQString& icon = TQString::null,
                                      TDEIcon::Group group = TDEIcon::Panel );
    virtual KURLBarItem * insertDynamicItem( const KURL& url,
                                             const TQString& description,
                                             const TQString& icon = TQString::null,
                                             TDEIcon::Group group = TDEIcon::Panel );
    virtual void setOrientation( TQt::Orientation orient );
    Orientation orientation() const;

    virtual void setListBox( KURLBarListBox * );
    KURLBarListBox *listBox() const { return m_listBox; }

    virtual void setIconSize( int size );
    int iconSize() const { return m_iconSize; }

    virtual void clear();

    virtual TQSize sizeHint() const;

    virtual TQSize minimumSizeHint() const;

    virtual void readConfig(  TDEConfig *config, const TQString& itemGroup );
    virtual void writeConfig( TDEConfig *config, const TQString& itemGroup );

    virtual void readItem( int i, TDEConfig *config, bool applicationLocal );
    virtual void writeItem( KURLBarItem *item, int i, TDEConfig *, bool global );

    KURLBarItem * currentItem() const;
    KURL currentURL() const;

    bool isModified() const             { return m_isModified; }

    bool isImmutable() const             { return m_isImmutable; }

    bool isVertical() const { return orientation() == TQt::Vertical; }
 
public slots:
    virtual void setCurrentItem( const KURL& url );
 
signals:
    void activated( const KURL& url );
 
protected:
    virtual bool addNewItem();
    virtual bool editItem( KURLBarItem *item );
 
    virtual void resizeEvent( TQResizeEvent * );
 
    virtual void paletteChange( const TQPalette & );

    KURLBarItem * m_activeItem;
    bool m_useGlobal  :1;

    bool m_isModified :1;

    bool m_isImmutable :1;
 
protected slots:
    virtual void slotContextMenuRequested( TQListBoxItem *, const TQPoint& pos );
    virtual void slotSelected( TQListBoxItem * );

    virtual void slotDropped( TQDropEvent * );
 
private slots:
    void slotSelected( int button, TQListBoxItem * );
 
private:
    KURLBarListBox *m_listBox;
    int m_iconSize;
 
 
protected:
    virtual void virtual_hook( int id, void* data );
private:
    class KURLBarPrivate;
    KURLBarPrivate *d;
};
 

 
 
class TQDragObject;
class KURLBarToolTip;

class TDEIO_EXPORT KURLBarListBox : public TDEListBox
{
    TQ_OBJECT
 
public:
    KURLBarListBox( TQWidget *parent = 0, const char *name = 0 );
    ~KURLBarListBox();

    virtual void setOrientation( TQt::Orientation orient );
    TQt::Orientation orientation() const { return m_orientation; }
 
    bool isVertical() const { return m_orientation == TQt::Vertical; }
 
signals:
    void dropped( TQDropEvent *e );
 
protected:
    virtual TQDragObject * dragObject();
 
    virtual void contentsDragEnterEvent( TQDragEnterEvent * );
    virtual void contentsDropEvent( TQDropEvent * );
    virtual void contextMenuEvent( TQContextMenuEvent * );
    virtual void paintEvent( TQPaintEvent* );
 
private:
    TQt::Orientation m_orientation;
    KURLBarToolTip *m_toolTip;
 
protected:
    virtual void virtual_hook( int id, void* data );
private:
    class KURLBarListBoxPrivate;
    KURLBarListBoxPrivate *d;
};
 

 
 
class TQCheckBox;
class TDEIconButton;
class KLineEdit;
class KURLRequester;

class TDEIO_EXPORT KURLBarItemDialog : public KDialogBase
{
    TQ_OBJECT
 
public:
    static bool getInformation( bool allowGlobal, KURL& url,
                                TQString& description, TQString& icon,
                                bool& appLocal, int iconSize,
                                TQWidget *parent = 0 );

    KURLBarItemDialog( bool allowGlobal, const KURL& url,
                       const TQString& description, TQString icon,
                       bool appLocal = true,
                       int iconSize = TDEIcon::SizeMedium,
                       TQWidget *parent = 0, const char *name = 0 );
    ~KURLBarItemDialog();

    KURL url() const;

    TQString description() const;

    TQString icon() const;

    bool applicationLocal() const;
 
protected:
    KURLRequester * m_urlEdit;
    KLineEdit     * m_edit;
    TDEIconButton   * m_iconButton;
    TQCheckBox     * m_appLocal;
 
public slots:
    void urlChanged(const TQString & );
 
private:
    class KURLBarItemDialogPrivate;
    KURLBarItemDialogPrivate *d;
};
 
 
#endif // KURLBAR_H