Dtk::Power::DPowerManager类 参考

电源设备管理类, 用于管理电源设备, 包括电源设备的创建, 电源设备的属性获取, 电源设备的状态获取等 更多...

#include <dpowermanager.h>

类 Dtk::Power::DPowerManager 继承关系图:

Dtk::Power::DPowerManager 的协作图:

Public 槽
DExpected< QStringList >	devices () const
	枚举电源设备, 将此计算机上的电源设备以QStringList的方式列举
DExpected< QString >	criticalAction () const
	获取当电源严重不足的情况下, 电脑采取的操作
DExpected< void >	refresh ()
	刷新设备列表

信号
void	deviceAdded (const QString &name)
	信号：有新的设备被接入
void	deviceRemoved (const QString &name)
	信号：设备被移除
void	lidIsClosedChanged (const bool &value)
	信号：笔记本盖子被关闭
void	lidIsPresentChanged (const bool &value)
	信号：笔记本盖子传感器启用状态发生改变

Public 成员函数
	DPowerManager (QObject *parent=nullptr)
bool	lidIsClosed () const
	笔记本盖子关闭(或者二合一设备关上皮套)通过霍尔传感器读取相关数值
bool	lidIsPresent () const
	笔记本盖子传感器是否有效
bool	hasBattery () const
	系统是否具有电池
bool	onBattery () const
	系统是否使用电池电源运行
bool	supportKbdBacklight () const
	获取设备是否支持系统级调整键盘背光
QString	daemonVersion () const
	守护程序版本
QSharedPointer< DPowerDevice >	displayDevice () const
	当前显示的电源设备(这是一个表示要在桌面环境中显示的状态图标的复合设备, docker栏显示的电源图标指向的电源设备)
QSharedPointer< DPowerDevice >	findDeviceByName (const QString &name) const
	通过设备名创建设备对象
QSharedPointer< DKbdBacklight >	kbdBacklight () const
	创建键盘背光设备对象

属性
bool	lidIsClosed
bool	lidIsPresent
bool	hasBattery
bool	onBattery
bool	supportKbdBacklight
QString	daemonVersion

详细描述

电源设备管理类, 用于管理电源设备, 包括电源设备的创建, 电源设备的属性获取, 电源设备的状态获取等

成员函数说明

criticalAction

QString DPowerManager::criticalAction ( ) const

slot

获取当电源严重不足的情况下, 电脑采取的操作

返回

返回一种电源状态

daemonVersion()

QString DPowerManager::daemonVersion

(

)

const

守护程序版本

返回

返回upower守护程序版本

deviceAdded

void DPowerManager::deviceAdded ( const QString &  path )

signal

信号：有新的设备被接入

deviceRemoved

void DPowerManager::deviceRemoved ( const QString &  path )

signal

信号：设备被移除

devices

QStringList DPowerManager::devices ( ) const

slot

枚举电源设备, 将此计算机上的电源设备以QStringList的方式列举

返回

将电源设备名称作为列表返回

displayDevice()

QSharedPointer< DPowerDevice > DPowerManager::displayDevice

(

)

const

当前显示的电源设备(这是一个表示要在桌面环境中显示的状态图标的复合设备, docker栏显示的电源图标指向的电源设备)

返回

返回一个device对象

findDeviceByName()

QSharedPointer< DPowerDevice > DPowerManager::findDeviceByName

(

const QString &

name

)

const

通过设备名创建设备对象

参数

[in]

name

传入设备名, 设备名获取见 DPowerManager::devices() const

注解

注意, 请使用DPowerManager::devices() const 返回的电源设备名称, 若不符将会返回一个nullptr.

返回

返回一个device对象

hasBattery()

bool DPowerManager::hasBattery

(

)

const

系统是否具有电池

返回

布尔值

kbdBacklight()

QSharedPointer< DKbdBacklight > DPowerManager::kbdBacklight

(

)

const

创建键盘背光设备对象

注解

注意, 请使用supportKbdBacklight()确定设备是否支持系统调节键盘背光

参见

DPowerManager::supportKbdBacklight() const

返回

返回一个device对象

lidIsClosed()

bool DPowerManager::lidIsClosed

(

)

const

笔记本盖子关闭(或者二合一设备关上皮套)通过霍尔传感器读取相关数值

返回

布尔值, 如果为true则笔记本盖子是关上的

lidIsClosedChanged

void DPowerManager::lidIsClosedChanged ( const bool &  value )

signal

信号：笔记本盖子被关闭

lidIsPresent()

bool DPowerManager::lidIsPresent

(

)

const

笔记本盖子传感器是否有效

返回

布尔值, 如果为true则笔记本盖子上存在霍尔传感器

lidIsPresentChanged

void DPowerManager::lidIsPresentChanged ( const bool &  value )

signal

信号：笔记本盖子传感器启用状态发生改变

onBattery()

bool DPowerManager::onBattery

(

)

const

系统是否使用电池电源运行

返回

布尔值

refresh

QString DPowerManager::refresh ( )

slot

刷新设备列表

supportKbdBacklight()

bool DPowerManager::supportKbdBacklight

(

)

const

获取设备是否支持系统级调整键盘背光

注解

有部分笔记本电脑厂商虽然提供了键盘背光功能, 但其相对于系统是不可见的, 而是又电脑硬件直接管理, 这样就无法通过软件调整键盘背光了。

返回

bool值, 如果为true则可以通过dkbdbacklight调整键盘背光

---

该类的文档由以下文件生成:

• include/power/dpowermanager.h
• docs/power/dpowermanager.zh_CN.dox