/usr/include/KF5/KIconThemes/kiconbutton.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 | /* 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 KICONBUTTON_H
#define KICONBUTTON_H
#include "kiconthemes_export.h"
#include <QPushButton>
#include <kiconloader.h>
/**
* @class KIconButton kiconbutton.h KIconButton
*
* A pushbutton for choosing an icon. Pressing on the button will open a
* KIconDialog for the user to select an icon. The current icon will be
* displayed on the button.
*
* @see KIconDialog
* @short A push button that allows selection of an icon.
*/
class KICONTHEMES_EXPORT KIconButton: public QPushButton
{
Q_OBJECT
Q_PROPERTY(QString icon READ icon WRITE setIcon RESET resetIcon NOTIFY iconChanged USER true)
Q_PROPERTY(int iconSize READ iconSize WRITE setIconSize)
Q_PROPERTY(bool strictIconSize READ strictIconSize WRITE setStrictIconSize)
public:
/**
* Constructs a KIconButton using the global icon loader.
*
* @param parent The parent widget.
*/
explicit KIconButton(QWidget *parent = nullptr);
/**
* Constructs a KIconButton using a specific icon loader.
*
* @param loader The icon loader to use.
* @param parent The parent widget.
*/
KIconButton(KIconLoader *loader, QWidget *parent);
/**
* Destructs the button.
*/
~KIconButton();
/**
* Sets a strict icon size policy for allowed icons. When true,
* only icons of the specified group's size in setIconType() are allowed,
* and only icons of that size will be shown in the icon dialog.
*/
void setStrictIconSize(bool b);
/**
* Returns true if a strict icon size policy is set.
*/
bool strictIconSize() const;
/**
* Sets the icon group and context. Use KIconLoader::NoGroup if you want to
* allow icons for any group in the given context.
*/
void setIconType(KIconLoader::Group group, KIconLoader::Context context, bool user = false);
/**
* Sets the button's initial icon.
*/
void setIcon(const QString &icon);
void setIcon(const QIcon &icon);
/**
* Resets the icon (reverts to an empty button).
*/
void resetIcon();
/**
* Returns the name of the selected icon.
*/
const QString &icon() const;
/**
* Sets the size of the icon 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;
/**
* Sets the size of the icon to be shown on the button.
* @see KIconLoader::StdSizes
* @see buttonIconSize
* @since 4.1
*/
void setButtonIconSize(int size);
/**
* Returns the button's icon size.
* @since 4.1
*/
int buttonIconSize() const;
Q_SIGNALS:
/**
* Emitted when the icon has changed.
*/
void iconChanged(const QString &icon);
private:
class KIconButtonPrivate;
KIconButtonPrivate *const d;
Q_DISABLE_COPY(KIconButton)
};
#endif // KICONBUTTON_H
|