/usr/include/solid/battery.h is in kdelibs5-dev 4:4.14.2-5+deb8u2.
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 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 | /*
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_BATTERY_H
#define SOLID_BATTERY_H
#include <solid/solid_export.h>
#include <solid/deviceinterface.h>
namespace Solid
{
class BatteryPrivate;
class Device;
/**
* This device interface is available on batteries.
*/
class SOLID_EXPORT Battery : public DeviceInterface
{
Q_OBJECT
Q_ENUMS(BatteryType ChargeState)
Q_PROPERTY(bool plugged READ isPlugged)
Q_PROPERTY(bool powerSupply READ isPowerSupply)
Q_PROPERTY(BatteryType type READ type)
Q_PROPERTY(int chargePercent READ chargePercent)
Q_PROPERTY(int capacity READ capacity)
Q_PROPERTY(bool rechargeable READ isRechargeable)
Q_PROPERTY(ChargeState chargeState READ chargeState)
Q_DECLARE_PRIVATE(Battery)
friend class Device;
public:
/**
* This enum type defines the type of the device holding the battery
*
* - PdaBattery : A battery in a Personal Digital Assistant
* - UpsBattery : A battery in an Uninterruptible Power Supply
* - PrimaryBattery : A primary battery for the system (for example laptop battery)
* - MouseBattery : A battery in a mouse
* - KeyboardBattery : A battery in a keyboard
* - KeyboardMouseBattery : A battery in a combined keyboard and mouse
* - CameraBattery : A battery in a camera
* - PhoneBattery : A battery in a phone
* - MonitorBattery : A battery in a monitor
* - UnknownBattery : A battery in an unknown device
*/
enum BatteryType { UnknownBattery, PdaBattery, UpsBattery,
PrimaryBattery, MouseBattery, KeyboardBattery,
KeyboardMouseBattery, CameraBattery,
PhoneBattery, MonitorBattery };
/**
* This enum type defines charge state of a battery
*
* - NoCharge : Battery charge is stable, not charging or discharging or
* the state is Unknown
* - Charging : Battery is charging
* - Discharging : Battery is discharging
*/
enum ChargeState { NoCharge, Charging, Discharging };
private:
/**
* Creates a new Battery 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 Battery(QObject *backendObject);
public:
/**
* Destroys a Battery object.
*/
virtual ~Battery();
/**
* Get the Solid::DeviceInterface::Type of the Battery device interface.
*
* @return the Battery device interface type
* @see Solid::DeviceInterface::Type
*/
static Type deviceInterfaceType() { return DeviceInterface::Battery; }
/**
* Indicates if this battery is plugged.
*
* @return true if the battery is plugged, false otherwise
*/
bool isPlugged() const;
/**
* Indicates if this battery is powering the machine or from an attached deviced.
*
* @since 4.11
* @return true the battery is a powersupply, false otherwise
*/
bool isPowerSupply() const;
/**
* Retrieves the type of device holding this battery.
*
* @return the type of device holding this battery
* @see Solid::Battery::BatteryType
*/
BatteryType type() const;
/**
* Retrieves the current charge level of the battery normalised
* to percent.
*
* @return the current charge level normalised to percent
*/
int chargePercent() const;
/**
* Retrieves the battery capacity normalised to percent,
* meaning how much energy can it hold compared to what it is designed to.
* The capacity of the battery will reduce with age.
* A capacity value less than 75% is usually a sign that you should renew your battery.
*
* @since 4.11
* @return the battery capacity normalised to percent
*/
int capacity() const;
/**
* Indicates if the battery is rechargeable.
*
* @return true if the battery is rechargeable, false otherwise (one time usage)
*/
bool isRechargeable() const;
/**
* Retrieves the current charge state of the battery. It can be in a stable
* state (no charge), charging or discharging.
*
* @return the current battery charge state
* @see Solid::Battery::ChargeState
*/
ChargeState chargeState() const;
Q_SIGNALS:
/**
* This signal is emitted when the charge percent value of this
* battery has changed.
*
* @param value the new charge percent value of the battery
* @param udi the UDI of the battery with the new charge percent
*/
void chargePercentChanged(int value, const QString &udi);
/**
* This signal is emitted when the capacity of this battery has changed.
*
* @param value the new capacity of the battery
* @param udi the UDI of the battery with the new capacity
* @since 4.11
*/
void capacityChanged(int value, const QString &udi);
/**
* This signal is emitted when the charge state of this battery
* has changed.
*
* @param newState the new charge state of the battery, it's one of
* the type Solid::Battery::ChargeState
* @see Solid::Battery::ChargeState
* @param udi the UDI of the battery with the new charge state
*/
void chargeStateChanged(int newState, const QString &udi);
/**
* This signal is emitted if the battery get plugged in/out of the
* battery bay.
*
* @param newState the new plugging state of the battery, type is boolean
* @param udi the UDI of the battery with the new plugging state
*/
void plugStateChanged(bool newState, const QString &udi);
/**
* This signal is emitted when the power supply state of the battery
* changes.
*
* @param newState the new power supply state, type is boolean
* @param udi the UDI of the battery with the new power supply state
* @since 4.11
*/
void powerSupplyStateChanged(bool newState, const QString &udi);
};
}
#endif
|