1 files changed, 88 insertions, 0 deletions
diff --git a/kdecore/kaccelmanager.h b/kdecore/kaccelmanager.h
new file mode 100644
index 000000000..7619d2e29
--- /dev/null
+++ b/kdecore/kaccelmanager.h
@@ -0,0 +1,88 @@
+/*  This file is part of the KDE project
+    Copyright (C) 2002 Matthias Hoelzer-Kluepfel <mhk@kde.org>
+
+    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., 51 Franklin Street, Fifth Floor,
+    Boston, MA 02110-1301, USA.
+*/
+
+
+#ifndef __K_ACCELMANAGER_H__
+#define __K_ACCELMANAGER_H__
+
+
+class QWidget;
+class QString;
+
+#include <kdelibs_export.h>
+
+/**
+ * KDE Accelerator manager.
+ *
+ * This class can be used to find a valid and working set of
+ * accelerators for any widget.
+ *
+ * @author Matthias Hoelzer-Kluepfel <mhk@kde.org>
+ * @since 3.1
+*/
+
+class KDECORE_EXPORT KAcceleratorManager
+{
+public:
+
+    /**
+     * Manages the accelerators of a widget.
+     *
+     * Call this function on the top widget of the hierarchy you
+     * want to manage. It will fix the accelerators of the child widgets so
+     * there are never duplicate accelerators. It also tries to put
+     * accelerators on as many widgets as possible.
+     *
+     * The algorithm used tries to take the existing accelerators into
+     * account, as well as the class of each widget. Hopefully, the result
+     * is close to what you would assign manually.
+     *
+     * QPopupMenu's are managed dynamically, so when you add or remove entries,
+     * the accelerators are reassigned. If you add or remove widgets to your
+     * toplevel widget, you will have to call manage again to fix the
+     * accelerators.
+     *
+     * @param widget The toplevel widget you want to manage.
+     */
+
+    static void manage(QWidget *widget);
+
+    /**
+     * Does the same as the above function, but puts hints in the GUI so the
+     * programmer can enhance his program.
+     *
+     * TODO KDE4: merge with the above
+     * @param widget The toplevel widget you want to manage.
+     * @param programmers_mode if true, KAcceleratorManager adds (&) for removed
+     *             accels and & before added accels
+     */
+    static void manage(QWidget *widget, bool programmers_mode);
+
+    /** \internal returns the result of the last manage operation. */
+    static void last_manage(QString &added,  QString &changed,  QString &removed);
+
+    /**
+     * Use this method for a widget (and its children) you want no accels to be set on.
+     * @since 3.4
+     */
+    static void setNoAccel( QWidget *widget );
+};
+
+
+#endif