|
|
/* This file is part of the KDE libraries Copyright (C) 1997 Nicolas Hadacek <hadacek@via.ecp.fr> This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library 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 Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with this library; see the file COPYING.LIB. If not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ #ifndef __KKEYDIALOG_H__ #define __KKEYDIALOG_H__ #include <kdialogbase.h> #include <kaccel.h> class QButtonGroup; class QCheckBox; class QGroupBox; class QLabel; class QLineEdit; class KActionCollection; class KGlobalAccel; class KKeyDialogPrivate; class KKeyChooserPrivate; /** * Configure dictionaries of key/action associations for KAccel and * KGlobalAccel. * * The class takes care of all aspects of configuration, including * handling key conflicts internally. Connect to the @ref allDefault() * slot if you want to set all configurable keybindings to their * default values. * * @short Widget for configuration of @ref KAccel and @ref KGlobalAccel. * @see KKeyDialog * @version $Id: kkeydialog_h.html 103207 2001-06-20 17:39:10Z dfaure $ * @author Nicolas Hadacek <hadacek@via.ecp.fr> */ class KKeyChooser : public QWidget { Q_OBJECT public: enum { NoKey = 1, DefaultKey, CustomKey }; /** * Constructor. * * @param aKeyDict A dictionary (@ref QMap) of key definitons. **/ KKeyChooser( KKeyEntryMap *aKeyDict, QWidget* parent = 0, bool check_against_std_keys = false ); ~KKeyChooser(); signals: /** * Emitted when a key definition has been changed. **/ void keyChange(); public slots: /** * Set all keys to their default values (bindings). **/ void allDefault(); /** * Set all list entries to their changed values. * Use this if you changed the underlying map **/ void listSync(); protected slots: void toChange( QListViewItem *item ); void changeKey(); void updateAction( QListViewItem *item ); void defaultKey(); void noKey(); void keyMode( int _mode ); void shiftClicked(); void ctrlClicked(); void altClicked(); void editKey(); void editEnd(); void readGlobalKeys(); void readStdKeys(); protected: void keyPressEvent( QKeyEvent* _event ); void fontChange( const QFont& _font ); protected: bool isKeyPresent(int kcode, bool warnuser = true ); void setKey( int kCode ); KKeyChooserPrivate *d; }; /** * The KKeyDialog class is used for configuring dictionaries of key/action * associations for KAccel and KGlobalAccel. It uses the KKeyChooser widget * and offers buttons to set all keys to defaults and invoke on-line help. * * Two static methods are supplied which provide the most convienient interface * to the dialog. For example you could use KAccel and KKeyDialog like this * * <pre> * KAccel keys; * * keys.insertItem( i18n( "Zoom in" ), "Zoom in", "+" ); * keys.connectItem( "Zoom in", myWindow, SLOT( zoomIn() ) ); * * keys.connectItem( KAccel::Print, myWindow, SLOT( print() ) ); * * keys.readSettings(); * * if( KKeyDialog::configureKeys( &keys ) ) { * ... * } * </pre> * * This will also implicitly save the settings. If you don't want this, * you can call * * <pre> * if( KKeyDialog::configureKeys( &keys, false ) ) { // do not save settings * ... * } * </pre> * @short Dialog for configuration of @ref KAccel and @ref KGlobalAccel. * @version $Id: kkeydialog_h.html 103207 2001-06-20 17:39:10Z dfaure $ * @author Nicolas Hadacek <hadacek@via.ecp.fr> */ class KKeyDialog : public KDialogBase { Q_OBJECT public: KKeyDialog( KKeyEntryMap* aKeyDict, QWidget *parent = 0, bool check_against_std_keys = false ); ~KKeyDialog(); /** * Configure key settings. **/ static int configureKeys( KAccel *keys, bool save_settings = true, QWidget *parent = 0 ); /** * Configure key settings. **/ static int configureKeys( KGlobalAccel *keys, bool save_settings = true, QWidget *parent = 0 ); /** * Configure key settings. **/ static int configureKeys( KActionCollection *coll, const QString& xmlfile, bool save_settings = true, QWidget *parent = 0 ); private: QPushButton* bDefaults; QPushButton* bOk; QPushButton* bCancel; QPushButton* bHelp; KKeyDialogPrivate *d; }; #endif // __KKEYDIALOG_H__
Generated by: faure on ftp.kde.com on Wed Jun 20 13:26:11 2001, using kdoc 2.0a53. |