• Skip to content
  • Skip to link menu
  • KDE API Reference
  • kdelibs-4.14.38 API Reference
  • KDE Home
  • Contact Us
 

KIO

  • kio
  • kfile
kicondialog.h
Go to the documentation of this file.
1/* vi: ts=8 sts=4 sw=4
2 *
3 * This file is part of the KDE project, module kfile.
4 * Copyright (C) 2000 Geert Jansen <jansen@kde.org>
5 * (C) 2000 Kurt Granroth <granroth@kde.org>
6 * (C) 1997 Christoph Neerfeld <chris@kde.org>
7 * (C) 2002 Carsten Pfeiffer <pfeiffer@kde.org>
8 *
9 * This is free software; it comes under the GNU Library General
10 * Public License, version 2. See the file "COPYING.LIB" for the
11 * exact licensing terms.
12 */
13
14#ifndef KICONDIALOG_H
15#define KICONDIALOG_H
16
17#include <kio/kio_export.h>
18
19#include <QtCore/QStringList>
20#include <QtGui/QPushButton>
21
22#include <kdialog.h>
23#include <klistwidget.h>
24
25class KIconLoader;
26
30class KIO_EXPORT KIconCanvas: public KListWidget
31{
32 Q_OBJECT
33
34public:
40 explicit KIconCanvas(QWidget *parent=0L);
41
45 ~KIconCanvas();
46
50 void loadFiles(const QStringList& files);
51
55 QString getCurrent() const;
56
57public Q_SLOTS:
61 void stopLoading();
62
63Q_SIGNALS:
67 void nameChanged(const QString&);
68
75 void startLoading(int count);
76
82 void progress(int number);
83
88 void finished();
89
90private:
91 class KIconCanvasPrivate;
92 KIconCanvasPrivate* const d;
93
94 Q_DISABLE_COPY(KIconCanvas)
95
96 Q_PRIVATE_SLOT(d, void _k_slotLoadFiles())
97 Q_PRIVATE_SLOT(d, void _k_slotCurrentChanged(QListWidgetItem *item))
98};
99
100
107class KIO_EXPORT KIconDialog: public KDialog
108{
109 Q_OBJECT
110
111public:
117 explicit KIconDialog(QWidget *parent=0L);
118
125 explicit KIconDialog(KIconLoader *loader, QWidget *parent=0);
126
130 ~KIconDialog();
131
138 void setStrictIconSize(bool b);
142 bool strictIconSize() const;
146 void setCustomLocation( const QString& location );
147
153 void setIconSize(int size);
154
159 int iconSize() const;
160
167
168 void setup( KIconLoader::Group group,
169 KIconLoader::Context context = KIconLoader::Application,
170 bool strictIconSize = false, int iconSize = 0,
171 bool user = false, bool lockUser = false,
172 bool lockCustomDir = false );
173
180 QString openDialog();
181
186 void showDialog();
187
206 static QString getIcon(KIconLoader::Group group=KIconLoader::Desktop,
207 KIconLoader::Context context=KIconLoader::Application,
208 bool strictIconSize=false, int iconSize = 0,
209 bool user=false, QWidget *parent=0,
210 const QString &caption=QString());
211
212Q_SIGNALS:
213 void newIconName(const QString&);
214
215protected Q_SLOTS:
216 void slotOk();
217
218private:
219 class KIconDialogPrivate;
220 KIconDialogPrivate* const d;
221
222 Q_DISABLE_COPY(KIconDialog)
223
224 Q_PRIVATE_SLOT(d, void _k_slotContext(int))
225 Q_PRIVATE_SLOT(d, void _k_slotStartLoading(int))
226 Q_PRIVATE_SLOT(d, void _k_slotProgress(int))
227 Q_PRIVATE_SLOT(d, void _k_slotFinished())
228 Q_PRIVATE_SLOT(d, void _k_slotAcceptIcons())
229 Q_PRIVATE_SLOT(d, void _k_slotBrowse())
230 Q_PRIVATE_SLOT(d, void _k_slotOtherIconClicked())
231 Q_PRIVATE_SLOT(d, void _k_slotSystemIconClicked())
232};
233
234
243class KIO_EXPORT KIconButton: public QPushButton
244{
245 Q_OBJECT
246 Q_PROPERTY( QString icon READ icon WRITE setIcon RESET resetIcon )
247 Q_PROPERTY( int iconSize READ iconSize WRITE setIconSize)
248 Q_PROPERTY( bool strictIconSize READ strictIconSize WRITE setStrictIconSize )
249
250public:
256 explicit KIconButton(QWidget *parent=0L);
257
264 KIconButton(KIconLoader *loader, QWidget *parent);
268 ~KIconButton();
269
275 void setStrictIconSize(bool b);
279 bool strictIconSize() const;
280
285 void setIconType(KIconLoader::Group group, KIconLoader::Context context, bool user=false);
286
290 void setIcon(const QString& icon);
291
292 void setIcon(const QIcon& icon);
293
297 void resetIcon();
298
302 const QString &icon() const;
303
309 void setIconSize( int size );
310
315 int iconSize() const;
316
323 void setButtonIconSize( int size );
324
329 int buttonIconSize() const;
330
331
332Q_SIGNALS:
336 void iconChanged(const QString &icon);
337
338private:
339 class KIconButtonPrivate;
340 KIconButtonPrivate* const d;
341
342 Q_DISABLE_COPY(KIconButton)
343
344 Q_PRIVATE_SLOT(d, void _k_slotChangeIcon())
345 Q_PRIVATE_SLOT(d, void _k_newIconName(const QString&))
346};
347
348
349#endif // KICONDIALOG_H
KDialog::KDialog
KDialog(QWidget *parent=0, Qt::WindowFlags flags=0)
KIconButton::setIcon
void setIcon(const QString &icon)
Sets the button's initial icon.
Definition kicondialog.cpp:849
KIconButton::strictIconSize
bool strictIconSize
Definition kicondialog.h:248
KIconButton::setStrictIconSize
void setStrictIconSize(bool b)
Sets a strict icon size policy for allowed icons.
Definition kicondialog.cpp:807
KIconButton::KIconButton
KIconButton(QWidget *parent=0L)
Constructs a KIconButton using the global iconloader.
Definition kicondialog.cpp:769
KIconButton::setIconType
void setIconType(KIconLoader::Group group, KIconLoader::Context context, bool user=false)
Sets the icon group and context.
Definition kicondialog.cpp:842
KIconButton::buttonIconSize
int buttonIconSize() const
Returns the Button's Icon-Size.
Definition kicondialog.cpp:837
KIconButton::setButtonIconSize
void setButtonIconSize(int size)
Sets the size of the icon to be shown on the button.
Definition kicondialog.cpp:831
KIconButton::iconSize
int iconSize
Definition kicondialog.h:247
KIconButton::iconChanged
void iconChanged(const QString &icon)
Emitted when the icon has changed.
KIconButton::icon
QString icon
Definition kicondialog.h:246
KIconButton::resetIcon
void resetIcon()
Resets the icon (reverts to an empty button).
Definition kicondialog.cpp:869
KIconButton::setIconSize
void setIconSize(int size)
Sets the size of the icon to be shown / selected.
Definition kicondialog.cpp:817
KIconCanvas::nameChanged
void nameChanged(const QString &)
Emitted when the current icon has changed.
KIconCanvas::finished
void finished()
This signal is emitted when the loading of the icons has been finished.
KIconCanvas::loadFiles
void loadFiles(const QStringList &files)
Load icons into the canvas.
Definition kicondialog.cpp:156
KIconCanvas::getCurrent
QString getCurrent() const
Returns the current icon.
Definition kicondialog.cpp:258
KIconCanvas::startLoading
void startLoading(int count)
This signal is emitted when the loading of the icons has started.
KIconCanvas::stopLoading
void stopLoading()
Call this slot to stop the loading of the icons.
Definition kicondialog.cpp:265
KIconCanvas::progress
void progress(int number)
This signal is emitted whenever an icon has been loaded.
KIconCanvas::KIconCanvas
KIconCanvas(QWidget *parent=0L)
Creates a new icon canvas.
Definition kicondialog.cpp:132
KIconDialog::strictIconSize
bool strictIconSize() const
Returns true if a strict icon size policy is set.
Definition kicondialog.cpp:544
KIconDialog::setup
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)
Allows you to set the same parameters as in the class method getIcon(), as well as two additional par...
Definition kicondialog.cpp:565
KIconDialog::KIconDialog
KIconDialog(QWidget *parent=0L)
Constructs an icon selection dialog using the global iconloader.
Definition kicondialog.cpp:329
KIconDialog::iconSize
int iconSize() const
Returns the iconsize set via setIconSize() or 0, if the default iconsize will be used.
Definition kicondialog.cpp:559
KIconDialog::newIconName
void newIconName(const QString &)
KIconDialog::setStrictIconSize
void setStrictIconSize(bool b)
Sets a strict icon size policy for allowed icons.
Definition kicondialog.cpp:539
KIconDialog::showDialog
void showDialog()
show()es this dialog and emits a newIcon(const QString&) signal when successful.
Definition kicondialog.cpp:632
KIconDialog::openDialog
QString openDialog()
exec()utes this modal dialog and returns the name of the selected icon, or QString() if the dialog wa...
Definition kicondialog.cpp:610
KIconDialog::setIconSize
void setIconSize(int size)
Sets the size of the icons to be shown / selected.
Definition kicondialog.cpp:549
KIconDialog::getIcon
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())
Pops up the dialog an lets the user select an icon.
Definition kicondialog.cpp:657
KIconDialog::setCustomLocation
void setCustomLocation(const QString &location)
sets a custom icon directory
Definition kicondialog.cpp:605
KIconDialog::slotOk
void slotOk()
Definition kicondialog.cpp:640
KIconLoader
KIconLoader::Group
Group
KIconLoader::Desktop
Desktop
KIconLoader::Context
Context
KIconLoader::Application
Application
KListWidget::KListWidget
KListWidget(QWidget *parent=0)
QPushButton
QWidget
kdialog.h
kio_export.h
klistwidget.h
This file is part of the KDE documentation.
Documentation copyright © 1996-2025 The KDE developers.
Generated on Tue Mar 25 2025 00:00:00 by doxygen 1.13.2 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

KIO

Skip menu "KIO"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Related Pages

kdelibs-4.14.38 API Reference

Skip menu "kdelibs-4.14.38 API Reference"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDEWebKit
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • KPty
  • Kross
  • KUnitConversion
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal