# sys.power 库模块帮助文档

## sys.power 成员列表 <a id="sys.power" href="#sys.power">&#x23;</a>

电源管理，支持除 XP 以外的所有操作系统

### sys.power.aliases() <a id="sys.power.aliases" href="#sys.power.aliases">&#x23;</a>
返回一个表，键为别名，值为对应的 GUID，  
不应修改返回表内容

### sys.power.change(setting,value) <a id="sys.power.change" href="#sys.power.change">&#x23;</a>
改变指定的设置值，  
@参数@1指定设置名，可省略 ac,dc 后缀，  
参数@指定设置值

### sys.power.change(sub,setting,scheme) <a id="sys.power.change" href="#sys.power.change">&#x23;</a>
查询电源方案  
参考 https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/powercfg-command-line-options#option_change

### sys.power.command() <a id="sys.power.command" href="#sys.power.command">&#x23;</a>
调用 powercfg 命令，返回进程输出

### sys.power.currentScheme() <a id="sys.power.currentScheme" href="#sys.power.currentScheme">&#x23;</a>
当前电源方案 GUID

### sys.power.getMonitorTimeout() <a id="sys.power.getMonitorTimeout" href="#sys.power.getMonitorTimeout">&#x23;</a>
返回显示器空闲关闭的超时值，以秒为单位

### sys.power.isAcOnline() <a id="sys.power.isAcOnline" href="#sys.power.isAcOnline">&#x23;</a>
当前使用外部电源返回 true  
使用电池返回 false

### sys.power.list() <a id="sys.power.list" href="#sys.power.list">&#x23;</a>
返回包含所有电源方案的数组，  
数组格式请参考此函数源码，或打印输出查看。  
返回对象的 current 属性为当前使用的电源方案 GUID

### sys.power.query <a id="sys.power.query" href="#sys.power.query">&#x23;</a>
查询电源方案

### sys.power.query(sub,setting,scheme) <a id="sys.power.query" href="#sys.power.query">&#x23;</a>
查询电源方案  
@sub 指定子组 GUID，  
@prop 指定设置别名或设置 GUID，省略返回所有设置，  
@scheme 指定电源方案，省略则为当前电源方案

### sys.power.setMonitorTimeout() <a id="sys.power.setMonitorTimeout" href="#sys.power.setMonitorTimeout">&#x23;</a>
设置显示器空闲关闭的超时值，  
参数@1 指定超时，以秒为单位，设为 0 则禁用空闲关屏

### sys.power.setValueIndex <a id="sys.power.setValueIndex" href="#sys.power.setValueIndex">&#x23;</a>
修改方案设置值

### sys.power.setValueIndex(sub,prop,value,scheme) <a id="sys.power.setValueIndex" href="#sys.power.setValueIndex">&#x23;</a>
参数@sub 指定子组 GUID，  
@prop 指定设置别名或设置 GUID，不可省略，  
@value 指定新的值，不可省略。  
@scheme 指定电源方案，省略则为当前电源方案

### sys.power.settings() <a id="sys.power.settings" href="#sys.power.settings">&#x23;</a>
打开电源管理

### sys.power.status() <a id="sys.power.status" href="#sys.power.status">&#x23;</a>
返回表示电源状态的 SYSTEM_POWER_STATUS 结构体  
结构体文档:  
https://docs.microsoft.com/en-us/windows/win32/api/winbase/ns-winbase-system_power_status
