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>
#include "qgis_gui.h"
#include "qgis_sip.h"

class QShortcut;

class GUI_EXPORT QgsShortcutsManager : public QObject
{
    Q_OBJECT

  public:

    QgsShortcutsManager( QObject *parent SIP_TRANSFERTHIS = 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;

    void updateActionToolTip( QAction *action, const QString &sequence );
};

// clazy:excludeall=qstring-allocations

#endif // QGSSHORTCUTSMANAGER_H