kicondialog.h

/*
 *
 * This file is part of the KDE project, module tdefile.
 * Copyright (C) 2000 Geert Jansen <jansen@kde.org>
 *           (C) 2000 Kurt Granroth <granroth@kde.org>
 *           (C) 1997 Christoph Neerfeld <chris@kde.org>
 *           (C) 2002 Carsten Pfeiffer <pfeiffer@kde.org>
 *
 * This is free software; it comes under the GNU Library General
 * Public License, version 2. See the file "COPYING.LIB" for the
 * exact licensing terms.
 */
 
#ifndef __TDEIconDialog_h__
#define __TDEIconDialog_h__
 
#include <tqstring.h>
#include <tqstringlist.h>
#include <tqpushbutton.h>
 
#include <kicontheme.h>
#include <kdialogbase.h>
#include <kiconview.h>
 
class TQComboBox;
class TQTimer;
class TQKeyEvent;
class TQRadioButton;
class KProgress;
class TDEIconLoader;

class TDEIO_EXPORT TDEIconCanvas: public TDEIconView
{
    TQ_OBJECT
 
public:
    TDEIconCanvas(TQWidget *parent=0L, const char *name=0L);
    ~TDEIconCanvas();

    void loadFiles(const TQStringList& files);

    TQString getCurrent() const;
 
public slots:
    void stopLoading();
 
signals:
    void nameChanged(TQString);
    /* KDE 4: Make it const TQString & */
 
    void startLoading(int);
    void progress(int);
    void finished();
 
private slots:
    void slotLoadFiles();
    void slotCurrentChanged(TQIconViewItem *item);
 
private:
    TQStringList mFiles;
    TQTimer *mpTimer;
    TDEIconLoader *mpLoader; // unused
 
protected:
    virtual void virtual_hook( int id, void* data );
 
private:
    class TDEIconCanvasPrivate;
    TDEIconCanvasPrivate *d;
};
 

class TDEIO_EXPORT TDEIconDialog: public KDialogBase
{
    TQ_OBJECT
 
public:
    TDEIconDialog(TQWidget *parent=0L, const char *name=0L);
    TDEIconDialog(TDEIconLoader *loader, TQWidget *parent=0,
        const char *name=0);
    ~TDEIconDialog();

    void setStrictIconSize(bool b);
    bool strictIconSize() const;
    void setCustomLocation( const TQString& location );

    void setIconSize(int size);

    int iconSize() const;
 
#ifndef KDE_NO_COMPAT
    TQString selectIcon(TDEIcon::Group group=TDEIcon::Desktop, TDEIcon::Context
        context=TDEIcon::Application, bool user=false);
#endif

    void setup( TDEIcon::Group group,
                TDEIcon::Context context = TDEIcon::Application,
                bool strictIconSize = false, int iconSize = 0,
                bool user = false );

 
    void setup( TDEIcon::Group group, TDEIcon::Context context,
                bool strictIconSize, int iconSize, bool user, bool lockUser,
                bool lockCustomDir );

    TQString openDialog();

    void showDialog();

    static TQString getIcon(TDEIcon::Group group=TDEIcon::Desktop,
                           TDEIcon::Context context=TDEIcon::Application,
                           bool strictIconSize=false, int iconSize = 0,
                           bool user=false, TQWidget *parent=0,
                           const TQString &caption=TQString::null);
 
signals:
    void newIconName(const TQString&);
 
protected slots:
    void slotOk();
 
private slots:
    void slotButtonClicked(int);
    void slotContext(int);
    void slotStartLoading(int);
    void slotProgress(int);
    void slotFinished();
    void slotAcceptIcons();
private:
    void init();
    void showIcons();
    void setContext( TDEIcon::Context context );
 
    int mGroupOrSize;
    TDEIcon::Context mContext;
    int mType;
 
    TQStringList mFileList;
    TQComboBox *mpCombo;
    TQPushButton *mpBrowseBut;
    TQRadioButton *mpRb1, *mpRb2;
    KProgress *mpProgress;
    TDEIconLoader *mpLoader;
    TDEIconCanvas *mpCanvas;
    int mNumContext;
    TDEIcon::Context mContextMap[ 12 ]; // must match TDEIcon::Context size, code has assert
 
protected:
    virtual void virtual_hook( int id, void* data );
private:
    class TDEIconDialogPrivate;
    TDEIconDialogPrivate *d;
};
 

class TDEIO_EXPORT TDEIconButton: public TQPushButton
{
    TQ_OBJECT
    TQ_PROPERTY( TQString icon READ icon WRITE setIcon RESET resetIcon )
    TQ_PROPERTY( int iconSize READ iconSize WRITE setIconSize)
    TQ_PROPERTY( bool strictIconSize READ strictIconSize WRITE setStrictIconSize )
 
public:
    TDEIconButton(TQWidget *parent=0L, const char *name=0L);

    TDEIconButton(TDEIconLoader *loader, TQWidget *parent, const char *name=0L);
    ~TDEIconButton();

    void setStrictIconSize(bool b);
    bool strictIconSize() const;

    void setIconType(TDEIcon::Group group, TDEIcon::Context context, bool user=false);

    void setIcon(const TQString& icon);

    void resetIcon();

    TQString icon() const { return mIcon; }

    void setIconSize( int size );

    int iconSize() const;
 
signals:
    void iconChanged(TQString icon);
    /* KDE 4: Make it const TQString & */
 
private slots:
    void slotChangeIcon();
    void newIconName(const TQString& name);
 
private:
    void init( TDEIconLoader *loader );
 
    bool mbUser;
    TDEIcon::Group mGroup;
    TDEIcon::Context mContext;
 
    TQString mIcon;
    TDEIconDialog *mpDialog;
    TDEIconLoader *mpLoader;
    class TDEIconButtonPrivate;
    TDEIconButtonPrivate *d;
};
 
 
#endif // __TDEIconDialog_h__