kdecore Library API Documentation

kaccelmanager_private.h

00001 /*  This file is part of the KDE project
00002     Copyright (C) 2002 Matthias H�zer-Klpfel <mhk@kde.org>
00003 
00004     This library is free software; you can redistribute it and/or
00005     modify it under the terms of the GNU Library General Public
00006     License as published by the Free Software Foundation; either
00007     version 2 of the License, or (at your option) any later version.
00008 
00009     This library is distributed in the hope that it will be useful,
00010     but WITHOUT ANY WARRANTY; without even the implied warranty of
00011     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00012     Library General Public License for more details.
00013 
00014     You should have received a copy of the GNU Library General Public License
00015     along with this library; see the file COPYING.LIB.  If not, write to
00016     the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
00017     Boston, MA 02111-1307, USA.
00018 */
00019 
00020 
00021 #ifndef __KACCELMANAGER_PRIVATE_H__
00022 #define __KACCELMANAGER_PRIVATE_H__
00023 
00024 
00025 #include <qstring.h>
00026 #include <qmemarray.h>
00027 #include <qvaluelist.h>
00028 #include <qobject.h>
00029 
00030 class QWidgetStack;
00031 
00042 class KAccelString
00043 {
00044 public:
00045 
00046   KAccelString() : m_pureText(), m_accel(-1) {};
00047   KAccelString(const QString &input, int initalWeight=-1);
00048 
00049   void calculateWeights(int initialWeight);
00050 
00051   const QString &pure() const { return m_pureText; };
00052   QString accelerated() const;
00053 
00054   int accel() const { return m_accel; };
00055   void setAccel(int accel) { m_accel = accel; };
00056 
00057   int originalAccel() const { return m_orig_accel; }
00058   QString originalText() const { return m_origText; }
00059 
00060   QChar accelerator() const;
00061 
00062   int maxWeight(int &index, const QString &used);
00063 
00064   bool operator == (const KAccelString &c) const { return m_pureText == c.m_pureText && m_accel == c.m_accel && m_orig_accel == c.m_orig_accel; }
00065 
00066 
00067 private:
00068 
00069   int stripAccelerator(QString &input);
00070 
00071   void dump();
00072 
00073   QString        m_pureText,  m_origText;
00074   int            m_accel, m_orig_accel;
00075   QMemArray<int> m_weight;
00076 
00077 };
00078 
00079 
00080 typedef QValueList<KAccelString> KAccelStringList;
00081 
00082 
00090 class KAccelManagerAlgorithm
00091 {
00092 public:
00093 
00094   enum {
00095     // Default control weight
00096     DEFAULT_WEIGHT = 50,
00097     // Additional weight for first character in string
00098     FIRST_CHARACTER_EXTRA_WEIGHT = 50,
00099     // Additional weight for the beginning of a word
00100     WORD_BEGINNING_EXTRA_WEIGHT = 50,
00101     // Additional weight for the dialog buttons (large, we basically never want these reassigned)
00102     DIALOG_BUTTON_EXTRA_WEIGHT = 300,
00103     // Additional weight for a 'wanted' accelerator
00104     WANTED_ACCEL_EXTRA_WEIGHT = 150,
00105     // Default weight for an 'action' widget (ie, pushbuttons)
00106     ACTION_ELEMENT_WEIGHT = 50,
00107     // Default weight for group boxes (low priority)
00108     GROUP_BOX_WEIGHT = -2000,
00109     // Default weight for menu titles
00110     MENU_TITLE_WEIGHT = 250,
00111     // Additional weight for KDE standard accelerators
00112     STANDARD_ACCEL = 300
00113   };
00114 
00115   static void findAccelerators(KAccelStringList &result, QString &used);
00116 
00117 };
00118 
00119 
00120 class QPopupMenu;
00121 
00122 
00132 class KPopupAccelManager : public QObject
00133 {
00134   Q_OBJECT
00135 
00136 public:
00137 
00138   static void manage(QPopupMenu *popup);
00139 
00140 
00141 protected:
00142 
00143   KPopupAccelManager(QPopupMenu *popup);
00144 
00145 
00146 private slots:
00147 
00148   void aboutToShow();
00149 
00150 
00151 private:
00152 
00153   void calculateAccelerators();
00154 
00155   void findMenuEntries(KAccelStringList &list);
00156   void setMenuEntries(const KAccelStringList &list);
00157 
00158   QPopupMenu       *m_popup;
00159   KAccelStringList m_entries;
00160   int              m_count;
00161 
00162 };
00163 
00164 
00165 class QWidgetStackAccelManager : public QObject
00166 {
00167   Q_OBJECT
00168 
00169 public:
00170 
00171   static void manage(QWidgetStack *popup);
00172 
00173 
00174 protected:
00175 
00176   QWidgetStackAccelManager(QWidgetStack *popup);
00177 
00178 
00179 private slots:
00180 
00181   void aboutToShow(QWidget *);
00182     bool eventFilter ( QObject * watched, QEvent * e );
00183 
00184 private:
00185 
00186   void calculateAccelerators();
00187 
00188   QWidgetStack     *m_stack;
00189   KAccelStringList m_entries;
00190 
00191 };
00192 
00193 
00194 #endif
KDE Logo
This file is part of the documentation for kdecore Library Version 3.4.1.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Tue Nov 1 10:31:46 2005 by doxygen 1.4.3 written by Dimitri van Heesch, © 1997-2003