/usr/include/avogadro/toolgroup.h is in libavogadro-dev 1.2.0-3.
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 146 | /**********************************************************************
ToolGroup - GLWidget manager for Tools.
Copyright (C) 2007,2008 Donald Ephraim Curtis
This file is part of the Avogadro molecular editor project.
For more information, see <http://avogadro.cc/>
Avogadro 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.
Avogadro 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, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301, USA.
**********************************************************************/
#ifndef TOOLGROUP_H
#define TOOLGROUP_H
#include <QObject>
#include <avogadro/plugin.h>
#include <avogadro/tool.h>
class QActionGroup;
namespace Avogadro {
class Molecule;
/**
* @class ToolGroup
* @brief Manager for GLWidget Tools
* @author Donald Ephraim Curtis
*
* This class is a collection of Tools which allow manipulation of the
* GLWidget area.
*/
class ToolGroupPrivate;
class A_EXPORT ToolGroup : public QObject
{
Q_OBJECT
public:
/**
* Constructor
*/
ToolGroup(QObject *parent = 0);
/**
* Deconstructor
*/
~ToolGroup();
/**
* Append the @p tools to the toolgroup.
*/
void append(QList<Tool *> tools);
/**
* Append the @p tool to the toolgroup.
*/
void append(Tool *tool);
/**
* @return The active tool.
*/
Tool* activeTool() const;
/**
* @param i index of the tool to return
* @return The tool at index i.
*/
Tool* tool(int i) const;
/**
* @return Constant list of the tools.
*/
const QList<Tool *>& tools() const;
/**
* @return constant QActionGroup of all the tool select actions.
*/
const QActionGroup * activateActions() const;
public Q_SLOTS:
/**
* @param i index of the tool to set active
*/
void setActiveTool(int i);
/**
* @param name the name of the tool to set active (if it's found)
*/
void setActiveTool(const QString& name);
/**
* @param tool pointer to the tool to set active
*/
void setActiveTool(Tool *tool);
/**
* @param molecule pointer to the molecule tools in this group should use
*/
void setMolecule(Molecule *molecule);
/**
* Write the settings of the GLWidget in order to save them to disk.
*/
void writeSettings(QSettings &settings) const;
/**
* Read the settings of the GLWidget and restore them.
*/
void readSettings(QSettings &settings);
/**
* Reset the toolgroup to it's original state.
*/
void removeAllTools();
private Q_SLOTS:
void activateTool();
Q_SIGNALS:
/**
* @param tool the activated tool
*/
void toolActivated(Tool *tool);
/**
* This signal is emitted when one or more tools are destoyed.
* (Happens when plugins are reloaded)
*/
void toolsDestroyed();
private:
ToolGroupPrivate * const d;
};
} // end namespace Avogadro
#endif
|