Fluent-Qt

API 參考

PluginManager

註冊選用外掛程式並依相依順序管理啟用與停用。外掛程式與選用宿主仍由呼叫端於管理員執行緒擁有;請勿在外掛程式勾點或直接連接的訊號處理常式中變更註冊狀態或刪除管理員。

fluent::plugins::PluginManager

繼承自 QObject

建構函式

解構函式

方法

bool registerPlugin(Plugin* plugin, QString* error = nullptr)

註冊外掛程式但不啟用(外掛程式仍由應用程式擁有)。須於管理員執行緒提供非空且去除首尾空白的 ID;相依項目可稍後註冊。

bool unregisterPlugin(const QString& id, QString* error = nullptr)

停止使用中的相依項目與該外掛程式,然後在不刪除該外掛程式的情況下移除其註冊。

bool activate(const QString& id, QString* error = nullptr)

依序啟用相依項目與 @p id;失敗時自動復原本次新啟用的外掛程式。若缺少相依項目或存在循環相依會在執行 hook 前直接失敗,已啟用時直接傳回 true。

bool deactivate(const QString& id, QString* error = nullptr)

先停用所有作用中的相依項目,再停用 @p id(其相依性維持啟用狀態)。

bool deactivateAll(QString* error = nullptr)

依啟用逆序停用所有作用中的外掛程式。

QWidget* createWidget(const QString& pluginId, const QString& key, QWidget* parent = nullptr, QString* error = nullptr)

在 GUI 執行緒透過已啟用外掛程式的 WidgetPluginInterface 建立控制項;傳入非空 @p parent 時由其接管 Qt 擁有權。不會自動啟用外掛程式,外掛程式未啟用或 key 不支援時傳回 nullptr。

訊號

Qt 基底類別文件:QObject