ukui-search/libsearch/appdata/application-info.h

110 lines
3.9 KiB
C++

#ifndef APPLICATIONINFO_H
#define APPLICATIONINFO_H
#include <QObject>
#include "application-property.h"
namespace UkuiSearch {
class ApplicationInfoPrivate;
class ApplicationInfo : public QObject
{
Q_OBJECT
public:
explicit ApplicationInfo(QObject *parent = nullptr);
~ApplicationInfo();
/**
* @brief getInfo 查询单个应用的单个属性
* @param desktopFile
* @param property
* @return
*/
QVariant getInfo(const QString &desktopFile, ApplicationProperty::Property property);
/**
* @brief getInfo 查询单个应用的多个属性
* @param desktopFile
* @param properties
* @return
*/
ApplicationPropertyMap getInfo(const QString &desktopFile, ApplicationProperties properties);
/**
* @brief getInfo 查询所有应用的多个属性
* @param property
* @return
*/
ApplicationInfoMap getInfo(ApplicationProperties properties);
/**
* @brief ApplicationInfo::getInfo
* get the application info that meets the restrictions
* @param restrictions: The restrictions that the search results should meet(e.g. u want get the app infos whose top state is 0)
* @param properties: Each application's information should contain these properties
* @return ApplicationInfoMap: the search result
*/
ApplicationInfoMap getInfo(ApplicationProperties properties, ApplicationPropertyMap restrictions);
/**
* @brief ApplicationInfo::searchApp
* @param keyWord: the keyword of this search for applications
* @param installAppInfoRes: the search results of applications
* @return ApplicationInfoMap: the search result
*/
ApplicationInfoMap searchApp(ApplicationProperties properties, const QString &keyword, ApplicationPropertyMap restrictions);
ApplicationInfoMap searchApp(ApplicationProperties properties, const QStringList &keywords, ApplicationPropertyMap restrictions);
/**
* @brief ApplicationInfo::setAppFavoritesState
* set the favorites state of the app
* @param desktopFilePath: the desktop file path of app
* @param num: the favorites app's order(from 1)
*/
void setAppFavoritesState(const QString &desktopFilePath, size_t num);
/**
* @brief ApplicationInfo::setAppTopState
* set the top state of the app
* @param desktopFilePath: the desktop file path of app
* @param num: the top app's order(from 1)
*/
void setAppTopState(const QString &desktopFilePath, size_t num);
/**
* @brief ApplicationInfo::changeFavoriteAppPos
* change the position of the app which is one of the Favorites Apps
* @param desktopFilePath: desktop file path of app
* @param pos: the position which the app will be changed into
*/
bool changeFavoriteAppPos(const QString &desktopFilePath, size_t pos);
/**
* @brief ApplicationInfo::changeTopAppPos
* hange the position of the app which is one of the Top Apps
* @param desktopFilePath: desktop file path of app
* @param pos: the position which the app will be changed into
* @return bool: true if success, else false
*/
bool changeTopAppPos(const QString &desktopFilePath, size_t pos);
/**
* @brief ApplicationInfo::tranPid2DesktopFp
* find the desktop file path of the process which corresponds to the pid
* @param pid: the pid of the process which need to get its desktop file path
* @param desktopFilePath: the desktop file path of the process corresponding to pid
* @return bool:true if success,else false
*/
bool tranPidToDesktopFp(int pid, QString &desktopFilePath);
Q_SIGNALS:
void DBOpenFailed();
void appDBItems2BUpdate(ApplicationInfoMap);
void appDBItems2BUpdateAll(QStringList);
void appDBItems2BAdd(QStringList);
void appDBItems2BDelete(QStringList);
private:
ApplicationInfoPrivate *d = nullptr;
};
}
#endif // APPLICATIONINFO_H