/usr/include/KF5/KIconThemes/kicondialog.h is in libkf5iconthemes-dev 5.44.0-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 | /* 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 "kiconthemes_export.h"
#include <QDialog>
#include <QtCore/QStringList>
#include <QPushButton>
#include <kiconloader.h>
/**
* @class KIconDialog kicondialog.h KIconDialog
*
* Dialog for interactive selection of icons. Use the function
* getIcon() to let the user select an icon.
*
* @short An icon selection dialog.
*/
class KICONTHEMES_EXPORT KIconDialog: public QDialog
{
Q_OBJECT
public:
/**
* Constructs an icon selection dialog using the global icon loader.
*
* @param parent The parent widget.
*/
explicit KIconDialog(QWidget *parent = nullptr);
/**
* Constructs an icon selection dialog using a specific icon loader.
*
* @param loader The icon loader to use.
* @param parent The parent widget.
*/
explicit KIconDialog(KIconLoader *loader, QWidget *parent = nullptr);
/**
* Destructs the dialog.
*/
~KIconDialog();
/**
* Sets a strict icon size policy for allowed icons.
*
* @param policy When true, only icons of the specified group's
* size in getIcon() are shown.
* When false, icons not available at the desired group's size will
* also be selectable.
*/
void setStrictIconSize(bool policy);
/**
* Returns true if a strict icon size policy is set.
*/
bool strictIconSize() const;
/**
* Sets the location of the custom icon directory. Only local directory
* paths are allowed.
*/
void setCustomLocation(const QString &location);
/**
* Sets the size of the icons to be shown / selected.
* @see KIconLoader::StdSizes
* @see iconSize
*/
void setIconSize(int size);
/**
* Returns the icon size set via setIconSize() or 0, if the default
* icon size will be used.
*/
int iconSize() const;
/**
* Allows you to set the same parameters as in the class method
* getIcon(), as well as two additional parameters to lock
* the choice between system and user directories and to lock the
* custom icon directory itself.
*/
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);
/**
* exec()utes this modal dialog and returns the name of the selected icon,
* or QString() if the dialog was aborted.
* @returns the name of the icon, suitable for loading with KIconLoader.
* @see getIcon
*/
QString openDialog();
/**
* show()s this dialog and emits a newIconName(const QString&) signal when
* successful. QString() will be emitted if the dialog was aborted.
*/
void showDialog();
/**
* Pops up the dialog an lets the user select an icon.
*
* @param group The icon group this icon is intended for. Providing the
* group shows the icons in the dialog with the same appearance as when
* used outside the dialog.
* @param context The initial icon context. Initially, the icons having
* this context are shown in the dialog. The user can change this.
* @param strictIconSize When true, only icons of the specified group's size
* are shown, otherwise icon not available in the desired group's size
* will also be selectable.
* @param iconSize the size of the icons -- the default of the icon group
* if set to 0
* @param user Begin with the "user icons" instead of "system icons".
* @param parent The parent widget of the dialog.
* @param caption The caption to use for the dialog.
* @return The name of the icon, suitable for loading with KIconLoader.
*/
static QString getIcon(KIconLoader::Group group = KIconLoader::Desktop,
KIconLoader::Context context = KIconLoader::Application,
bool strictIconSize = false, int iconSize = 0,
bool user = false, QWidget *parent = nullptr,
const QString &caption = QString());
Q_SIGNALS:
void newIconName(const QString &iconName);
protected Q_SLOTS:
void slotOk();
private:
class KIconDialogPrivate;
KIconDialogPrivate *const d;
friend class ShowEventFilter;
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_customFileSelected(const QString &path))
Q_PRIVATE_SLOT(d, void _k_slotOtherIconClicked())
Q_PRIVATE_SLOT(d, void _k_slotSystemIconClicked())
};
#endif // KICONDIALOG_H
|