kicondialog.h

Go to the documentation of this file.

/* vi: ts=8 sts=4 sw=4
 *
 * This file is part of the KDE project, module kfile.
 * 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 KICONDIALOG_H
#define KICONDIALOG_H

#include <kio/kio_export.h>

#include <QtCore/QStringList>
#include <QtGui/QPushButton>

#include <kdialog.h>
#include <klistwidget.h>

class KIconLoader;

class KIO_EXPORT KIconCanvas: public KListWidget
{
    Q_OBJECT

public:
    explicit KIconCanvas(QWidget *parent=0L);

    ~KIconCanvas();

    void loadFiles(const QStringList& files);

    QString getCurrent() const;

public Q_SLOTS:
    void stopLoading();

Q_SIGNALS:
    void nameChanged(const QString&);

    void startLoading(int count);

    void progress(int number);

    void finished();

private:
    class KIconCanvasPrivate;
    KIconCanvasPrivate* const d;

    Q_DISABLE_COPY(KIconCanvas)

    Q_PRIVATE_SLOT(d, void _k_slotLoadFiles())
    Q_PRIVATE_SLOT(d, void _k_slotCurrentChanged(QListWidgetItem *item))
};


class KIO_EXPORT KIconDialog: public KDialog
{
    Q_OBJECT

public:
    explicit KIconDialog(QWidget *parent=0L);

    explicit KIconDialog(KIconLoader *loader, QWidget *parent=0);

    ~KIconDialog();

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

    void setIconSize(int size);

    int iconSize() const;

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

    QString openDialog();

    void showDialog();

    static QString getIcon(KIconLoader::Group group=KIconLoader::Desktop,
                           KIconLoader::Context context=KIconLoader::Application,
                           bool strictIconSize=false, int iconSize = 0,
                           bool user=false, QWidget *parent=0,
                           const QString &caption=QString());

Q_SIGNALS:
    void newIconName(const QString&);

protected Q_SLOTS:
    void slotOk();

private:
    class KIconDialogPrivate;
    KIconDialogPrivate* const d;

    Q_DISABLE_COPY(KIconDialog)

    Q_PRIVATE_SLOT(d, void _k_slotContext(int))
    Q_PRIVATE_SLOT(d, void _k_slotStartLoading(int))
    Q_PRIVATE_SLOT(d, void _k_slotProgress(int))
    Q_PRIVATE_SLOT(d, void _k_slotFinished())
    Q_PRIVATE_SLOT(d, void _k_slotAcceptIcons())
    Q_PRIVATE_SLOT(d, void _k_slotBrowse())
    Q_PRIVATE_SLOT(d, void _k_slotOtherIconClicked())
    Q_PRIVATE_SLOT(d, void _k_slotSystemIconClicked())
};


class KIO_EXPORT KIconButton: public QPushButton
{
    Q_OBJECT
    Q_PROPERTY( QString icon READ icon WRITE setIcon RESET resetIcon )
    Q_PROPERTY( int iconSize READ iconSize WRITE setIconSize)
    Q_PROPERTY( bool strictIconSize READ strictIconSize WRITE setStrictIconSize )

public:
    explicit KIconButton(QWidget *parent=0L);

    KIconButton(KIconLoader *loader, QWidget *parent);
    ~KIconButton();

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

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

    void setIcon(const QString& icon);

    void setIcon(const QIcon& icon);

    void resetIcon();

    const QString &icon() const;

    void setIconSize( int size );

    int iconSize() const;

    void setButtonIconSize( int size );

    int buttonIconSize() const;
     

Q_SIGNALS:
    void iconChanged(const QString &icon);

private:
    class KIconButtonPrivate;
    KIconButtonPrivate* const d;

    Q_DISABLE_COPY(KIconButton)

    Q_PRIVATE_SLOT(d, void _k_slotChangeIcon())
    Q_PRIVATE_SLOT(d, void _k_newIconName(const QString&))
};


#endif // KICONDIALOG_H