Files
qelectrotech-source-mirror/sources/shortcutmanager.h
T
ispyisail 86cb7e430e Add a command search: type part of a command's name, press Enter
Ctrl+Shift+M (Édition → "Rechercher une commande…") opens a small
search box at the cursor listing every command of the diagram editor
window, as SolidWorks' "Search Commands" and the command palette of
many editors do. Typing narrows it, best match first: name starting
with the text, then a word starting with it, then containing it.
Matching ignores case, accents and mnemonic "&", so "editer" finds
"Éditer l'item sélectionné". Each row shows the command's key when it
has one, which also teaches the keys. Disabled commands are listed,
greyed, and cannot be run. Enter runs the highlighted one after
closing the box; Esc closes.

The list is ShortcutManager's registry, restricted to the actions this
window owns (ShortcutManager::action(id, owner)), so a second editor
window's commands never appear and nothing has to be listed by hand.

Ctrl+Shift+P, the usual key for this, is already the autonumbering
dock's.

tst_commandsearch covers the folding, the ranking, that another
window's commands are left out and that a disabled command does not
run; both behaviours were checked to fail the test when broken.

Discussion #1033.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G2d2Zi8BfrYRPX88zhaoFG
2026-09-26 21:34:02 +12:00

109 lines
3.9 KiB
C++

/*
Copyright 2006-2026 The QElectroTech Team
This file is part of QElectroTech.
QElectroTech 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.
QElectroTech 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 QElectroTech. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef SHORTCUTMANAGER_H
#define SHORTCUTMANAGER_H
#include <QHash>
#include <QKeySequence>
#include <QList>
#include <QPointer>
#include <QString>
#include <QStringList>
class QObject;
class QAction;
/**
@brief The ShortcutManager class
App-wide registry of every rebindable shortcut, carried by either a
QAction or a QAbstractButton -- both declare an identical "shortcut"
Q_PROPERTY of type QKeySequence, which this class targets generically via
QObject so it doesn't need a separate code path for the handful of
QAbstractButton-based shortcuts (e.g. a QPushButton acting as a shortcut-
only trigger).
Every place in the code that used to call setShortcut() directly now
calls registerAction() instead, giving each shortcut a stable string id, a
category (for grouping in the UI) and a hardcoded default sequence.
registerAction() applies the user's saved override for that id (if any),
falling back to the default, and remembers the target so the Shortcuts
configuration page can list, edit and persist it.
Several targets can share the same id at once, since QET allows several
windows of the same kind (diagram editor, element editor...) to be open
simultaneously, each with its own QAction. setSequence() updates every
live target for a given id in one call.
*/
class ShortcutManager
{
public:
static ShortcutManager &instance();
struct ShortcutInfo {
QString id;
QString category;
QString description;
QKeySequence default_sequence;
QKeySequence current_sequence;
};
void registerAction(QObject *target, const QString &id,
const QString &category,
const QKeySequence &default_sequence);
QList<ShortcutInfo> allShortcuts() const;
QKeySequence currentSequence(const QString &id) const;
void setSequence(const QString &id, const QKeySequence &sequence);
void resetToDefault(const QString &id);
void resetAllToDefaults();
/// Activate the first still-alive target registered under \a id
/// -- QAction::trigger() or QAbstractButton::click(), whichever
/// it turns out to be -- for an input source other than the
/// keyboard (e.g. a 3D mouse button) that wants to invoke a
/// named action without knowing or caring which of the two it
/// is. Deliberately not disambiguated by the currently active
/// window when an id has several live targets: a target's
/// owning top-level window isn't reliably discoverable from a
/// bare QAction. Correct in the overwhelming common case of one
/// open editor window; a known simplification in the rarer
/// multi-window case, not a guaranteed-correct dispatch.
/// @return whether a live target was found and triggered.
bool trigger(const QString &id) const;
QAction *action(const QString &id, const QObject *owner) const;
private:
ShortcutManager() = default;
ShortcutManager(const ShortcutManager &) = delete;
void operator=(const ShortcutManager &) = delete;
struct Entry {
QString category;
QString description;
QKeySequence default_sequence;
QList<QPointer<QObject>> targets;
};
QKeySequence savedSequence(const QString &id, const QKeySequence &default_sequence) const;
QHash<QString, Entry> m_entries;
QStringList m_order;
};
#endif // SHORTCUTMANAGER_H