PilotAgent.hpp

浏览该文件的文档.

 
 
#pragma once
 
#include "AstGlobal.h"
#include <QObject>
#include <QHash>
#include <string>
#include <sstream>
#include <functional>
 
class QWidget;
class QAction;
class QMenu;
class QRubberBand;
 
AST_NAMESPACE_BEGIN
 
class AST_UIPILOT_API PilotAgent : public QObject
{
    Q_OBJECT
 
public:
    static PilotAgent* instance();
 
    explicit PilotAgent(QObject* parent = nullptr);
 
    ~PilotAgent() override;
 
    // ---- ref 管理 ----
 
    int ref(QWidget* widget);
 
    int ref(QAction* action);
 
    QWidget* widget(int refId) const;
 
    QAction* action(int refId) const;
 
    QObject* object(int refId) const;
 
    std::string objectType(int refId) const;
 
    bool isValidRef(int refId) const;
 
    // ---- 快照 ----
 
    std::string snapshot(int maxDepth = 8);
 
    std::string snapshotOf(QWidget* root, int maxDepth = 8);
 
    QWidget* activeModalDialog() const;
 
    // ---- 操作 ----
 
    void highlight(QWidget* widget, int durationMs = 2000);
 
    void waitForIdle(int timeoutMs = 5000);
 
    QList<QWidget*> topLevelWidgets() const;
 
    bool triggerAction(QAction* action);
 
    QList<QAction*> expandMenu(QMenu* menu);
 
    bool isAutoSnapshot() const{return autoSnapshot_;}
 
protected:
    bool eventFilter(QObject* obj, QEvent* event) override;
 
private:
    // ---- 剪枝 ----
    static bool isWorthReporting(QWidget* w);
    static bool isInteractive(QWidget* w);
 
    // ---- 快照输出 ----
    void formatWidget(QWidget* w, int depth, std::ostringstream& out);
    void formatAction(QAction* a, int depth, std::ostringstream& out);
    void walkWidgetTree(QWidget* root, int depth, int maxDepth, std::ostringstream& out);
    void formatWidgetValue(QWidget* w, std::ostringstream& out);
    static QString statusTags(QWidget* w);
    static QString friendlyName(QWidget* w);
 
    // ---- 内存清理 ----
    void cleanupRef(int refId);
 
    bool autoSnapshot_ = false;          
 
    // ---- ref 映射 ----
    QHash<QWidget*, int> widgetToRef_;   
    QHash<int, QWidget*> refToWidget_;   
    QHash<QAction*, int> actionToRef_;   
    QHash<int, QAction*> refToAction_;   
 
    int nextRef_ = 1;                    
    static PilotAgent* s_instance;      
};
 
AST_NAMESPACE_END