/usr/include/solid/genericinterface.h is in kdelibs5-dev 4:4.8.2-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 | /*
Copyright 2006-2007 Kevin Ottens <ervin@kde.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) version 3, or any
later version accepted by the membership of KDE e.V. (or its
successor approved by the membership of KDE e.V.), which shall
act as a proxy defined in Section 6 of version 3 of the license.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef SOLID_GENERICINTERFACE_H
#define SOLID_GENERICINTERFACE_H
#include <QtCore/QMap>
#include <QtCore/QVariant>
#include <solid/solid_export.h>
#include <solid/deviceinterface.h>
namespace Solid
{
class GenericInterfacePrivate;
class Device;
/**
* Generic interface to deal with a device. It exposes a set of properties
* and is organized as a key/value set.
*
* Warning: Using this class could expose some backend specific details
* and lead to non portable code. Use it at your own risk, or during
* transitional phases when the provided device interfaces don't
* provide the necessary methods.
*/
class SOLID_EXPORT GenericInterface : public DeviceInterface
{
Q_OBJECT
Q_ENUMS(PropertyChange)
Q_DECLARE_PRIVATE(GenericInterface)
friend class Device;
public:
/**
* This enum type defines the type of change that can occur to a GenericInterface
* property.
*
* - PropertyModified : A property value has changed in the device
* - PropertyAdded : A new property has been added to the device
* - PropertyRemoved : A property has been removed from the device
*/
enum PropertyChange { PropertyModified, PropertyAdded, PropertyRemoved };
private:
/**
* Creates a new GenericInterface object.
* You generally won't need this. It's created when necessary using
* Device::as().
*
* @param backendObject the device interface object provided by the backend
* @see Solid::Device::as()
*/
explicit GenericInterface(QObject *backendObject);
public:
/**
* Destroys a Processor object.
*/
virtual ~GenericInterface();
/**
* Get the Solid::DeviceInterface::Type of the GenericInterface device interface.
*
* @return the Processor device interface type
* @see Solid::Ifaces::Enums::DeviceInterface::Type
*/
static Type deviceInterfaceType() { return DeviceInterface::GenericInterface; }
/**
* Retrieves a property of the device.
*
* Warning: Using this method could expose some backend specific details
* and lead to non portable code. Use it at your own risk, or during
* transitional phases when the provided device interfaces don't
* provide the necessary methods.
*
* @param key the property key
* @return the actual value of the property, or QVariant() if the
* property is unknown
*/
QVariant property(const QString &key) const;
/**
* Retrieves a key/value map of all the known properties for the device.
*
* Warning: Using this method could expose some backend specific details
* and lead to non portable code. Use it at your own risk, or during
* transitional phases when the provided device interfaces don't
* provide the necessary methods.
*
* @return all the properties of the device
*/
QMap<QString, QVariant> allProperties() const;
/**
* Tests if a property exist in the device.
*
* Warning: Using this method could expose some backend specific details
* and lead to non portable code. Use it at your own risk, or during
* transitional phases when the provided device interfaces don't
* provide the necessary methods.
*
* @param key the property key
* @return true if the property is available in the device, false
* otherwise
*/
bool propertyExists(const QString &key) const;
Q_SIGNALS:
/**
* This signal is emitted when a property is changed in the device.
*
* @param changes the map describing the property changes that
* occurred in the device, keys are property name and values
* describe the kind of change done on the device property
* (added/removed/modified), it's one of the type Solid::Device::PropertyChange
*/
void propertyChanged(const QMap<QString,int> &changes);
/**
* This signal is emitted when an event occurred in the device.
* For example when a button is pressed.
*
* @param condition the condition name
* @param reason a message explaining why the condition has been raised
*/
void conditionRaised(const QString &condition, const QString &reason);
};
}
#endif
|