Diffstat (limited to 'libopie2/opiecore/okeyfilter.h') (more/less context) (show whitespace changes)
-rw-r--r-- | libopie2/opiecore/okeyfilter.h | 54 |
1 files changed, 41 insertions, 13 deletions
diff --git a/libopie2/opiecore/okeyfilter.h b/libopie2/opiecore/okeyfilter.h index 3f9f744..a65bc48 100644 --- a/libopie2/opiecore/okeyfilter.h +++ b/libopie2/opiecore/okeyfilter.h @@ -26,52 +26,80 @@ _;:, .> :=|. This program is free software; you can Boston, MA 02111-1307, USA. */ /* QT */ #include <qwindowsystem_qws.h> #include <qvaluelist.h> namespace Opie { namespace Core { class ODevice; namespace Internal { class iPAQ; class SIMpad; } /** * A singleton which will manage all possible keyboard filters inside opie. * It makes sure that key handlers of odevice are checked first than the * keyfilters of software. * @short a keyfilter proxy * @see QWSServer::KeyboardFilter * @author Rajko Albrecht * @version 1.0 */ -class OKeyFilter:public QWSServer::KeyboardFilter +class OKeyFilter { friend class Opie::Core::ODevice; friend class Opie::Core::Internal::iPAQ; friend class Opie::Core::Internal::SIMpad; - static QValueList<QWSServer::KeyboardFilter*> filterList; - static QValueList<QWSServer::KeyboardFilter*> preFilterList; - - OKeyFilter(); - OKeyFilter(const OKeyFilter&):QWSServer::KeyboardFilter(){}; - protected: - void addPreHandler(QWSServer::KeyboardFilter*); - void remPreHandler(QWSServer::KeyboardFilter*); + /** + * Protected constructor - generate class via inst() + * @see inst() + */ + OKeyFilter(); + /** + * Protected constructor - generate class via inst() + * @see inst() + */ + OKeyFilter(const OKeyFilter&){}; + /** + * Append filter to the primary list. + * This is only allowed for friend classes from odevice + * @param aFilter a filter to append + * @see addHandler + */ + virtual void addPreHandler(QWSServer::KeyboardFilter*aFilter)=0; + /** + * Remove the specified filter from list and give back ownership. + * This is only allowed for friend classes from odevice + * @param aFilter a filter to remove + * @see remHandler + */ + virtual void remPreHandler(QWSServer::KeyboardFilter*aFilter)=0; public: virtual ~OKeyFilter(); - virtual bool filter( int unicode, int keycode, int modifiers, bool isPress, bool autoRepeat ); - - void addHandler(QWSServer::KeyboardFilter*); - void remHandler(QWSServer::KeyboardFilter*); + /** + * Append filter to the secondary list. + * @param aFilter a filter to append + * @see addPreHandler + */ + virtual void addHandler(QWSServer::KeyboardFilter*)=0; + /** + * Remove the specified filter from list and give back ownership. + * @param aFilter a filter to remove + * @see remPreHandler + */ + virtual void remHandler(QWSServer::KeyboardFilter*)=0; + /** + * Returns a handler to an instance of OKeyFilter + * @return a pointer to a working OKeyFilter + */ static OKeyFilter*inst(); }; } } |