TpSystemApi 类
V0.2.1TpUtilsService
2025-11-14
介绍
系统桌面级API功能接口类
基础信息
| 头文件: | include <TpSystemApi.h> |
|---|---|
| Cmake: | None |
| 发布版本: | V0.2.1 |
| 继承类: | |
| 派生类: |
Public 类型
struct TpSystemApi::RunAppInfo
| 类型 | 名称 | 描述 |
|---|---|---|
| TpAppConfigIO | appInfo | |
| int32_t | pid |
enum TpSystemApi::OpenFileError
| 名称 | 值 | 描述 |
|---|---|---|
| Succsssful | 0 | 打开成功 |
| FileNotExist | 1 | 打开文件不存在 |
| NotSupport | 2 | 不支持文件类型 |
| SystemFileDamage | 3 | 系统文件损坏 |
Public 成员函数
| static TpSystemApi * TpSystemApi::Instance | Instance() | 获取唯一单例 |
|---|---|---|
| static OpenFileError | openFile(const TpString &filePath, const TpString &appUuid="") | 根据文件类型启动对应应用打开文件 |
| notifyWidgetsResize(const TpString &widgetUuid, const TpSize &widgetSize) | 指定UUID通知小组件绘制画布尺寸变化；小组件更新画布并重绘；暂不可用 | |
| notifyWidgetsPaint(const TpString &widgetUuid) | 指定UUID通知小组件进行重绘；暂不可用 | |
| TpImage | appImage(const TpString &uuid) | 指定应用UUID获取该应用缩略图；若应用未运行则返回空对象 |
| home() | 返回桌面；调用后会直接返回桌面显示 | |
| startApp(const TpString &uuid, const TpVector< TpString ](/V0.2.1/TpUtils/TpString/)> &argList=TpVector< TpString >()) | 指定应用UUID启动该应用；若应用已启动则将应用重新置顶显示 | |
| killApp(const TpString &uuid) | 指定应用UUID停止应用进程 | |
| killAllApp() | 停止当前运行的所有应用进程 | |
| TpVector< RunAppInfo > | runAppList() | 获取当前运行应用信息列表 |
| RunAppInfo | runAppInfo(const TpString &uuid) | 指定应用UUID获取应用运行信息 |
| TpSystemApi(const TpSystemApi &)=delete | 禁用拷贝构造 | |
| TpSystemApi & TpSystemApi::operator= | operator=(const TpSystemApi &)=delete | 禁用赋值构造 |
成员函数说明
static TpSystemApi * TpSystemApi::Instance()
获取唯一单例...
获取唯一单例
返回值：实例指针
static OpenFileError TpSystemApi::openFile(const TpString &filePath, const TpString &appUuid="")
根据文件类型启动对应应用打开文件...
根据文件类型启动对应应用打开文件
参数：filePath: 文件绝对路径
参数：appUuid: 指定打开文件的应用UUID；为空则使用系统默认
void TpSystemApi::notifyWidgetsResize(const TpString &widgetUuid, const TpSize &widgetSize)
指定UUID通知小组件绘制画布尺寸变化；小组件更新画布并重绘...
指定UUID通知小组件绘制画布尺寸变化；小组件更新画布并重绘；暂不可用
参数：widgetUuid: 小组件UUID
void TpSystemApi::notifyWidgetsPaint(const TpString &widgetUuid)
指定UUID通知小组件进行重绘；暂不可用...
指定UUID通知小组件进行重绘；暂不可用
参数：widgetUuid: 小组件UUID
TpImage TpSystemApi::appImage(const TpString &uuid)
指定应用UUID获取该应用缩略图；若应用未运行则返回空对象...
指定应用UUID获取该应用缩略图；若应用未运行则返回空对象
参数：uuid: 应用UUID
返回值：应用缩略图；若应用未运行则返回空对象
bool TpSystemApi::home()
返回桌面；调用后会直接返回桌面显示...
返回桌面；调用后会直接返回桌面显示
返回值：执行结果
bool TpSystemApi::startApp(const TpString &uuid, const TpVector< TpString > &argList=TpVector< TpString >())
指定应用UUID启动该应用；若应用已启动则将应用重新置顶显示...
指定应用UUID启动该应用；若应用已启动则将应用重新置顶显示
参数：uuid: 应用UUID
参数：argList: 应用启动参数
返回值：启动应用结果
bool TpSystemApi::killApp(const TpString &uuid)
指定应用UUID停止应用进程...
指定应用UUID停止应用进程
参数：uuid: 应用UUID
返回值：停止结果；应用进程未运行同样返回false
bool TpSystemApi::killAllApp()
停止当前运行的所有应用进程...
停止当前运行的所有应用进程
返回值：停止结果
TpVector< RunAppInfo > TpSystemApi::runAppList()
获取当前运行应用信息列表...
获取当前运行应用信息列表
返回值：应用信息列表
RunAppInfo TpSystemApi::runAppInfo(const TpString &uuid)
指定应用UUID获取应用运行信息...
指定应用UUID获取应用运行信息
参数：uuid: 应用UUID
返回值：该应用的进程信息；若应用未运行则返回空
TpSystemApi::TpSystemApi(const TpSystemApi &)=delete
禁用拷贝构造...
禁用拷贝构造
TpSystemApi & TpSystemApi::operator=(const TpSystemApi &)=delete
禁用赋值构造...
禁用赋值构造
