summaryrefslogtreecommitdiff
path: root/libopie2
authorzecke <zecke>2004-05-10 21:08:55 (UTC)
committer zecke <zecke>2004-05-10 21:08:55 (UTC)
commit613e0a6b246d8dcfd808089b2b6a1dc0501732da (patch) (unidiff)
treef08854dc0b7121777badeb6cef1007ae8c53a1e1 /libopie2
parent0e1086dfe7238cbee8553828afaf32aae4cee70d (diff)
downloadopie-613e0a6b246d8dcfd808089b2b6a1dc0501732da.zip
opie-613e0a6b246d8dcfd808089b2b6a1dc0501732da.tar.gz
opie-613e0a6b246d8dcfd808089b2b6a1dc0501732da.tar.bz2
Some virtuals which we discussed some time back...
Diffstat (limited to 'libopie2') (more/less context) (ignore whitespace changes)
-rw-r--r--libopie2/opiecore/okeyconfigmanager.h19
1 files changed, 11 insertions, 8 deletions
diff --git a/libopie2/opiecore/okeyconfigmanager.h b/libopie2/opiecore/okeyconfigmanager.h
index b861675..d0a6247 100644
--- a/libopie2/opiecore/okeyconfigmanager.h
+++ b/libopie2/opiecore/okeyconfigmanager.h
@@ -115,65 +115,72 @@ private:
115 OKeyPair m_key; 115 OKeyPair m_key;
116 OKeyPair m_def; 116 OKeyPair m_def;
117 QObject *m_obj; 117 QObject *m_obj;
118 QCString m_str; 118 QCString m_str;
119 class Private; 119 class Private;
120 Private *d; 120 Private *d;
121}; 121};
122 122
123 123
124 124
125/** 125/**
126 * \brief A manager to load and save Key Actions and get notified 126 * \brief A manager to load and save Key Actions and get notified
127 * This is the Manager for KeyActions. 127 * This is the Manager for KeyActions.
128 * You can say from which config and group to read data, to grab the 128 * You can say from which config and group to read data, to grab the
129 * keyboard to handle hardware keys, you can supply a blacklist of 129 * keyboard to handle hardware keys, you can supply a blacklist of
130 * keys which should not be used by allowed to be used. 130 * keys which should not be used by allowed to be used.
131 * You can even pass this manager to a Widget to do the configuration for you. 131 * You can even pass this manager to a Widget to do the configuration for you.
132 * You need to add OKeyConfigItem for your keys and then issue a load() to 132 * You need to add OKeyConfigItem for your keys and then issue a load() to
133 * read the Key information. 133 * read the Key information.
134 * You can either handle the QKeyEvent yourself and ask this class if it is 134 * You can either handle the QKeyEvent yourself and ask this class if it is
135 * handled by your action and let give you the action. Or you can install 135 * handled by your action and let give you the action. Or you can install
136 * the event filter and get a signal. 136 * the event filter and get a signal.
137 * You need to load and save yourself! 137 * You need to load and save yourself!
138 * 138 *
139 * Again if you want to extend it and I missed a virtual, tell me so I can improve (zecke@handhelds.org)
140 *
139 * @since 1.1.2 141 * @since 1.1.2
140 */ 142 */
141class OKeyConfigManager : public QObject { 143class OKeyConfigManager : public QObject {
142 Q_OBJECT 144 Q_OBJECT
143 typedef QMap<int, OKeyConfigItem::List> OKeyMapConfigPrivate; 145 typedef QMap<int, OKeyConfigItem::List> OKeyMapConfigPrivate;
144public: 146public:
147 enum EventMask {
148 MaskPressed = 0x1,
149 MaskReleased = 0x2,
150 };
151
145 OKeyConfigManager(Opie::Core::OConfig *conf = 0, 152 OKeyConfigManager(Opie::Core::OConfig *conf = 0,
146 const QString& group = QString::null, 153 const QString& group = QString::null,
147 const OKeyPair::List &block = OKeyPair::List(), 154 const OKeyPair::List &block = OKeyPair::List(),
148 bool grabkeyboard = false, QObject * par = 0, 155 bool grabkeyboard = false, QObject * par = 0,
149 const char* name = 0 ); 156 const char* name = 0 );
150 ~OKeyConfigManager(); 157 virtual ~OKeyConfigManager();
151 158
152 void load(); 159 virtual void load();
153 void save(); 160 virtual void save();
154 161
155 OKeyConfigItem handleKeyEvent( QKeyEvent* ); 162 virtual OKeyConfigItem handleKeyEvent( QKeyEvent* );
156 int handleKeyEventId( QKeyEvent* ); 163 int handleKeyEventId( QKeyEvent* );
157 164
158 void addKeyConfig( const OKeyConfigItem& ); 165 void addKeyConfig( const OKeyConfigItem& );
159 void removeKeyConfig( const OKeyConfigItem& ); 166 void removeKeyConfig( const OKeyConfigItem& );
160 void clearKeyConfig(); 167 void clearKeyConfig();
161 168
162 void addToBlackList( const OKeyPair& ); 169 void addToBlackList( const OKeyPair& );
163 void removeFromBlackList( const OKeyPair& ); 170 void removeFromBlackList( const OKeyPair& );
164 void clearBlackList(); 171 void clearBlackList();
165 OKeyPair::List blackList()const; 172 OKeyPair::List blackList()const;
166 173
167 void handleWidget( QWidget* ); 174 void handleWidget( QWidget* );
168 175
169 bool eventFilter( QObject*, QEvent* ); 176 bool eventFilter( QObject*, QEvent* );
170 177
171 /** 178 /**
172 * Sets the event mask flags aMask. 179 * Sets the event mask flags aMask.
173 * 180 *
174 * aMask is a combination of OKeyConfigManager::EventMask 181 * aMask is a combination of OKeyConfigManager::EventMask
175 * 182 *
176 * @see eventMask(), testEventMask(), addEventMask(), clearEventMask() 183 * @see eventMask(), testEventMask(), addEventMask(), clearEventMask()
177 */ 184 */
178 void setEventMask(uint aMask); 185 void setEventMask(uint aMask);
179 /** 186 /**
@@ -190,52 +197,48 @@ public:
190 * @param aMask one of OKeyConfigManager::EventMask 197 * @param aMask one of OKeyConfigManager::EventMask
191 * 198 *
192 * @see eventMask(), setEventMask(), addEventMask(), clearEventMask() 199 * @see eventMask(), setEventMask(), addEventMask(), clearEventMask()
193 */ 200 */
194 bool testEventMask(uint aMask); 201 bool testEventMask(uint aMask);
195 /** 202 /**
196 * Add the event mask flag aMask. 203 * Add the event mask flag aMask.
197 * 204 *
198 * @param aMask one of OKeyConfigManager::EventMask 205 * @param aMask one of OKeyConfigManager::EventMask
199 * 206 *
200 * @see eventMask(), setEventMask(), addEventMask(), clearEventMask() 207 * @see eventMask(), setEventMask(), addEventMask(), clearEventMask()
201 */ 208 */
202 void addEventMask(uint aMask); 209 void addEventMask(uint aMask);
203 /** 210 /**
204 * Clears the event mask flag aMask. 211 * Clears the event mask flag aMask.
205 * 212 *
206 * @param aMask is one of OKeyConfigManager::EventMask 213 * @param aMask is one of OKeyConfigManager::EventMask
207 * 214 *
208 * @see eventMask(), testEventMask(), addEventMask(), setEventMask() 215 * @see eventMask(), testEventMask(), addEventMask(), setEventMask()
209 */ 216 */
210 void clearEventMask(uint aMask); 217 void clearEventMask(uint aMask);
211 218
212 OKeyConfigItem::List keyConfigList()const; 219 OKeyConfigItem::List keyConfigList()const;
213 220
214 enum EventMask {
215 MaskPressed = 0x1,
216 MaskReleased = 0x2,
217 };
218signals: 221signals:
219 /** 222 /**
220 * The Signals are triggered on KeyPress and KeyRelease! 223 * The Signals are triggered on KeyPress and KeyRelease!
221 * You can check the isDown of the QKeyEvent 224 * You can check the isDown of the QKeyEvent
222 * @see QKeyEvent 225 * @see QKeyEvent
223 */ 226 */
224 void actionActivated( QWidget*, QKeyEvent*, const Opie::Core::OKeyConfigItem& ); 227 void actionActivated( QWidget*, QKeyEvent*, const Opie::Core::OKeyConfigItem& );
225 228
226 /** 229 /**
227 * This Signal correspondents to the OKeyConfigItem slot 230 * This Signal correspondents to the OKeyConfigItem slot
228 * and object 231 * and object
229 * 232 *
230 * @see OKeyConfigItem::slot 233 * @see OKeyConfigItem::slot
231 * @see OKeyConfigItem::object 234 * @see OKeyConfigItem::object
232 */ 235 */
233 void actionActivated( QWidget* par, QKeyEvent* key); 236 void actionActivated( QWidget* par, QKeyEvent* key);
234 237
235private: 238private:
236 OKeyConfigItem::List keyList( int ); 239 OKeyConfigItem::List keyList( int );
237 OKeyConfigItem::List m_keys; 240 OKeyConfigItem::List m_keys;
238 QValueList<QWidget*> m_widgets; 241 QValueList<QWidget*> m_widgets;
239 Opie::Core::OConfig *m_conf; 242 Opie::Core::OConfig *m_conf;
240 QString m_group; 243 QString m_group;
241 OKeyPair::List m_blackKeys; 244 OKeyPair::List m_blackKeys;