Qt 4.2 Shortcut Management

[dvmorris]

Is there a good tutorial on how to create a simple shortcut manager in Qt 4.2?

I found this one on google, but it's using a lot of deprecated functions, and I don't know enough yet to update all of it: http://doc.trolltech.com/qq/qq14-actioneditor.html

Thanks for the help,
dave

[fullmetalcoder]

I've written such a component myself for use with my IDE project. As soon as I'll have enough time I'll release a proper package but in the meantime you can get the sources (licensed under GPL) from Edyuk's SVN trunk or source packages

It includes a translation-aware shortcut manager class (QShortcutManager) which can register one or more actions under a given context and assign them a shorcut (either the default one or another set by the user) and a configuration dialog, QShortcutDialog which shows a tree of registered shortcuts and allow the user to set shortcuts through a custom input dialog (double click on tree item, type your shortcut, click on the OK button and you're done!).
The shortcuts are stored in XML files in a predefined location (you may need to change the source code to fit your needs in this domain...)

Hope this helps you.

[dvmorris]

wow this sounds like exactly what i've been looking for. I will check it out and let you know how it goes. Thanks so much for the quick reply,

Dave

[dvmorris]

I downloaded edjuk from sourceforge the other day but I don't see those files anywhere in there. Have they been renamed or moved?

it looks like they are supposed to be in trunk/src/lib/qcumber but I don't see them there in the local copy i have.

[fullmetalcoder]

I downloaded edyuk from sourceforge the other day but I don't see those files anywhere in there. Have they been renamed or moved?

it looks like they are supposed to be in trunk/src/lib/qcumber but I don't see them there in the local copy i have.

Are you sure you get the right version??? If you used SVN the files must be here (unless the checkout failed someway), if you downloaded packages they must be these of version 0.8.0-rc1.

the path to these files is : $PATH_TO_EDYUK/src/lib/qcumber where PATH_TO_EDYUK corresponds to the place where you extracted the archive or did your SVN checkout...
the files you're interested in are : qshortcutmanager.h qshortcutmanager.cpp qshortcutdialog.h qshortcutdialog.cpp

Alternatively, you can always use the SVN browse option on Sourceforge, access these files and copy there content by hand.

[dvmorris]

is there an example in the svn checkout that uses the shortcut manager? like a hello world kind of example or something?

[fullmetalcoder]

is there an example in the svn checkout that uses the shortcut manager? like a hello world kind of example or something?

Well I'm afraid I did not make any example... However it is really simple to use and here is a sample code :

#include "qshortcutmanager.h"
 
#include <QMenu>
#include <QAction>
#include <QMenuBar>
#include <QMainWindow>
#include <QMessageBox>
#include <QApplication>
 
int main(int argc, char **argv)
{
    QApplication app(argc, argv);
 
    QMainWindow main;
    QShortcutManager sm;
 
    QMessageBox ms(&main);
    ms.setText(    "This is a stub message box. The\n"
                "only nice thing about it is that\n"
                "it is triggered via a configurable\n"
                "shortcut\n\n"
                "So long buddy!");
 
    QMenu help("&Help", &main);
 
    QAction *a = new QAction("Show message box", &main);
    ms.connect(    a , SIGNAL( triggered() ),
                SLOT  ( exec() ) );
 
    sm.registerAction(a, "Help", "CTRL+M");
    help.addAction(a);
 
    QMenu settings("&Settings", &main);
 
    QAction *b = new QAction("Configure &shortcuts", &main);
    sm.connect(    b , SIGNAL( triggered() ),
                SLOT  ( configure() ) );
 
    sm.registerAction(b, "Settings", "CTRL+S");
    settings.addAction(b);
 
    main.menuBar()->addMenu(&settings);
    main.menuBar()->addMenu(&help);
    main.show();
 
    return app.exec();
}

#include "qshortcutmanager.h"

#include <QMenu>
#include <QAction>
#include <QMenuBar>
#include <QMainWindow>
#include <QMessageBox>
#include <QApplication>

int main(int argc, char **argv)
{
    QApplication app(argc, argv);
    
    QMainWindow main;
    QShortcutManager sm;
    
    QMessageBox ms(&main);
    ms.setText(    "This is a stub message box. The\n"
                "only nice thing about it is that\n"
                "it is triggered via a configurable\n"
                "shortcut\n\n"
                "So long buddy!");
    
    QMenu help("&Help", &main);
    
    QAction *a = new QAction("Show message box", &main);
    ms.connect(    a , SIGNAL( triggered() ),
                SLOT  ( exec() ) );
    
    sm.registerAction(a, "Help", "CTRL+M");
    help.addAction(a);
    
    QMenu settings("&Settings", &main);
    
    QAction *b = new QAction("Configure &shortcuts", &main);
    sm.connect(    b , SIGNAL( triggered() ),
                SLOT  ( configure() ) );
    
    sm.registerAction(b, "Settings", "CTRL+S");
    settings.addAction(b);
    
    main.menuBar()->addMenu(&settings);
    main.menuBar()->addMenu(&help);
    main.show();
    
    return app.exec();
}

To copy to clipboard, switch view to plain text mode 

Of course to compile this you need to link against Edyuk core library or to pack the need components in your project (no path relocation in the example below : it is assumed that you copied the files in your project folder...) :

QT *= xml
 
HEADERS += qshortcutmanager.h qshortcutdialog.h
SOURCES += qshortcutmanager.cpp qshortcutdialog.cpp
 
FORMS += shortcutdialog.ui

QT *= xml

HEADERS += qshortcutmanager.h qshortcutdialog.h
SOURCES += qshortcutmanager.cpp qshortcutdialog.cpp

FORMS += shortcutdialog.ui

To copy to clipboard, switch view to plain text mode 

Hope this helps.

P.S : I just checked Edyuk sources and the settings storage path is incorrectly set. If you wish to use QShortcutManager within one of your application you should change some code in qshortcutmanager.cpp Replace the content of the QShortcutManager::file(const QString& lang) function with the code below :

QString QShortcutManager::file(const QString& lang)
{
    return QDir::homePath()
            + QDir::separator()
            + "."
            + QApplication::applicationName()
            + QDir::separator()
            + "shortcuts_"
            + lang
            + ".xml";
}

QString QShortcutManager::file(const QString& lang)
{
    return QDir::homePath()
            + QDir::separator()
            + "."
            + QApplication::applicationName()
            + QDir::separator()
            + "shortcuts_"
            + lang
            + ".xml";
}

To copy to clipboard, switch view to plain text mode 

[dvmorris]

Wow this example is really great. I think I have most of it integrated into my code properly but I am getting an error:

qshortcutmanager.cc: In member function 'void QShortcutManager::destroyed(QObject*)':
qshortcutmanager.cc:396: error: 'quintptr' was not declared in this scope

qshortcutmanager.cc: In member function 'void QShortcutManager::destroyed(QObject*)':
qshortcutmanager.cc:396: error: 'quintptr' was not declared in this scope

To copy to clipboard, switch view to plain text mode 

I have put qcumber.h into my directory, and the four files for the qshortcut stuff, but I don't really see any other files I'm supposed to include.

[fullmetalcoder]

Wow this example is really great. I think I have most of it integrated into my code properly but I am getting an error:

qshortcutmanager.cc: In member function 'void QShortcutManager::destroyed(QObject*)':
qshortcutmanager.cc:396: error: 'quintptr' was not declared in this scope

qshortcutmanager.cc: In member function 'void QShortcutManager::destroyed(QObject*)':
qshortcutmanager.cc:396: error: 'quintptr' was not declared in this scope

To copy to clipboard, switch view to plain text mode 

I have put qcumber.h into my directory, and the four files for the qshortcut stuff, but I don't really see any other files I'm supposed to include.

This is weird... quintptr is a very convinient typedef defined in qglobal.h
I have no idea why it wouldn't compile properly on your box but you can always replace any occurence with : (void*)

[dvmorris]

I just tried adding

#include <QtGlobal>

to my qshortcutmanager.cpp file, but it didn't seem to work. It looks like quintptr is declared in QtGlobal, but that change gives the same error.

http://stuff.mit.edu/afs/athena/soft.../qtglobal.html

[dvmorris]

you know what? It may be a problem that I am actually using Qt 4.1 and not Qt 4.2.

Qt 4.2 will not install on my mac for some reason, it gets two errors right at the end:

http://www.qtcentre.org/forum/f-inst...os-x-5867.html

[fullmetalcoder]

you know what? It may be a problem that I am actually using Qt 4.1 and not Qt 4.2.

That's absolutely right and I hadn't spotted it... I'll place some macro'ed typedef to avoid troubles.

[fullmetalcoder]

I just tried adding

#include <QtGlobal>

to my qshortcutmanager.cpp file, but it didn't seem to work. It looks like quintptr is declared in QtGlobal, but that change gives the same error.

http://stuff.mit.edu/afs/athena/soft.../qtglobal.html

it is documented here : http://stuff.mit.edu/afs/athena/soft...intptr-typedef

and should be defined in any context provided that you have ANY Qt header included in the source. This is the case in qshortcutmanager.cpp so my only suggestion is to try #include "qglogal.h" and if it still doesn't work replace the occurence or add the typedef by hand in the source file :

typedef void* quintptr;

typedef void* quintptr;

To copy to clipboard, switch view to plain text mode