qgsshortcutsmanager.h

Go to the documentation of this file.

/***************************************************************************
    qgsshortcutsmanager.h
    ---------------------
    begin                : May 2009
    copyright            : (C) 2009 by Martin Dobias
    email                : wonder dot sk at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   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.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef QGSSHORTCUTSMANAGER_H
#define QGSSHORTCUTSMANAGER_H

#include <QHash>
#include <QList>
#include <QAction>

class QShortcut;

class GUI_EXPORT QgsShortcutsManager : public QObject
{
    Q_OBJECT

  public:

    static QgsShortcutsManager* instance();

    QgsShortcutsManager( QObject *parent = nullptr, const QString& settingsRoot = "/shortcuts/" );

    void registerAllChildren( QObject* object, bool recursive = false );

    void registerAllChildActions( QObject* object, bool recursive = false );

    void registerAllChildShortcuts( QObject* object, bool recursive = false );

    bool registerAction( QAction *action, const QString &defaultShortcut = QString() );

    bool registerShortcut( QShortcut* shortcut, const QString& defaultSequence = QString() );

    bool unregisterAction( QAction* action );

    bool unregisterShortcut( QShortcut* shortcut );

    QList<QAction*> listActions() const;

    QList<QShortcut*> listShortcuts() const;

    QList<QObject*> listAll() const;

    QString objectDefaultKeySequence( QObject* object ) const;

    QString defaultKeySequence( QAction* action ) const;

    QString defaultKeySequence( QShortcut* shortcut ) const;

    bool setKeySequence( const QString& name, const QString& sequence );

    bool setObjectKeySequence( QObject* object, const QString& sequence );

    bool setKeySequence( QAction* action, const QString& sequence );

    bool setKeySequence( QShortcut* shortcut, const QString& sequence );

    QObject* objectForSequence( const QKeySequence& sequence ) const;

    QAction* actionForSequence( const QKeySequence& sequence ) const;

    QShortcut* shortcutForSequence( const QKeySequence& sequence ) const;

    QAction* actionByName( const QString& name ) const;

    QShortcut* shortcutByName( const QString& name ) const;

    QString settingsPath() const { return mSettingsPath; }

  private slots:

    void actionDestroyed();
    void shortcutDestroyed();

  private:

    typedef QHash< QAction*, QString > ActionsHash;
    typedef QHash< QShortcut*, QString > ShortcutsHash;

    ActionsHash mActions;
    ShortcutsHash mShortcuts;
    QString mSettingsPath;
    static QgsShortcutsManager* mInstance;
};

#endif // QGSSHORTCUTSMANAGER_H