summaryrefslogtreecommitdiffstats
path: root/tdecore/kaccelmanager.h
diff options
context:
space:
mode:
Diffstat (limited to 'tdecore/kaccelmanager.h')
-rw-r--r--tdecore/kaccelmanager.h88
1 files changed, 88 insertions, 0 deletions
diff --git a/tdecore/kaccelmanager.h b/tdecore/kaccelmanager.h
new file mode 100644
index 000000000..21655fd9c
--- /dev/null
+++ b/tdecore/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 TQWidget;
+class TQString;
+
+#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(TQWidget *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(TQWidget *widget, bool programmers_mode);
+
+ /** \internal returns the result of the last manage operation. */
+ static void last_manage(TQString &added, TQString &changed, TQString &removed);
+
+ /**
+ * Use this method for a widget (and its children) you want no accels to be set on.
+ * @since 3.4
+ */
+ static void setNoAccel( TQWidget *widget );
+};
+
+
+#endif