/usr/include/gammaray/ui/clienttoolmanager.h is in gammaray-dev 2.7.0-1ubuntu8.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | /*
clienttoolmanager.h
This file is part of GammaRay, the Qt application inspection and
manipulation tool.
Copyright (C) 2013-2017 Klarälvdalens Datakonsult AB, a KDAB Group company, info@kdab.com
Author: Anton Kreuzkamp <anton.kreuzkamp@kdab.com>
Licensees holding valid commercial KDAB GammaRay licenses may use this file in
accordance with GammaRay Commercial License Agreement provided with the Software.
Contact info@kdab.com if any conditions of this licensing are not clear to you.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef GAMMARAY_CLIENTTOOLMANAGER_H
#define GAMMARAY_CLIENTTOOLMANAGER_H
#include "gammaray_ui_export.h"
#include <QHash>
#include <QPointer>
#include <QVector>
QT_BEGIN_NAMESPACE
class QAbstractItemModel;
class QItemSelectionModel;
class QWidget;
QT_END_NAMESPACE
namespace GammaRay {
class ObjectId;
class ProbeControllerInterface;
struct ToolData;
class ToolManagerInterface;
class ToolUiFactory;
/*! Data structure describing a single GammaRay tool. */
class GAMMARAY_UI_EXPORT ToolInfo
{
public:
ToolInfo();
/** @internal */
explicit ToolInfo(const ToolData &toolData, ToolUiFactory *factory);
~ToolInfo();
QString id() const;
bool isEnabled() const;
void setEnabled(bool enabled);
bool hasUi() const;
QString name() const;
bool remotingSupported() const;
private:
QString m_toolId;
bool m_isEnabled;
bool m_hasUi;
ToolUiFactory *m_factory;
};
/** @brief Tool Management API for the client to find out, which tools exist,
* get the tool's widgets, etc.
*
* This is needed when implementing your own client UI embedded into a different application.
* If you want to provide a list with all supported tools, you can use
* \e ClientToolManager::model() to get all the tool information as a model.
*
* This class also takes care of loading client-sided tool plugins.
*/
class GAMMARAY_UI_EXPORT ClientToolManager : public QObject
{
Q_OBJECT
public:
explicit ClientToolManager(QObject *parent = nullptr);
~ClientToolManager();
void setToolParentWidget(QWidget *parent);
bool isToolListLoaded() const;
QWidget *widgetForId(const QString &toolId) const;
QWidget *widgetForIndex(int index) const;
int toolIndexForToolId(const QString &toolId) const;
inline QVector<ToolInfo> tools() const
{
return m_tools;
}
QAbstractItemModel *model();
QItemSelectionModel *selectionModel();
void requestToolsForObject(const ObjectId &id);
void selectObject(const ObjectId &id, const ToolInfo &toolInfo);
static ClientToolManager* instance();
public slots:
void requestAvailableTools();
void clear();
signals:
void toolEnabled(const QString &toolId);
void toolEnabledByIndex(int toolIndex);
void aboutToReceiveData();
void toolListAvailable();
void toolSelected(const QString &toolId);
void toolSelectedByIndex(int index);
void toolsForObjectResponse(const GammaRay::ObjectId &id, const QVector<GammaRay::ToolInfo> &toolInfos);
void aboutToReset();
void reset();
private slots:
void gotTools(const QVector<GammaRay::ToolData> &tools);
void toolGotEnabled(const QString &toolId);
void toolGotSelected(const QString &toolId);
void toolsForObjectReceived(const GammaRay::ObjectId &id, const QVector<QString> &toolIds);
private:
typedef QHash<QString, QPointer<QWidget> > WidgetsHash;
mutable WidgetsHash m_widgets; // ToolId -> Widget
QVector<ToolInfo> m_tools;
QPointer<ToolManagerInterface> m_remote;
QWidget *m_parentWidget;
QAbstractItemModel *m_model;
QItemSelectionModel *m_selectionModel;
static ClientToolManager *s_instance;
};
}
#endif // GAMMARAY_CLIENTTOOLMANAGER_H
|