qtmobileextensions/src/keycapture/xqkeycapture.h
changeset 14 6fbed849b4f4
parent 5 453da2cfceef
child 15 1f895d8a5b2b
equal deleted inserted replaced
11:06b8e2af4411 14:6fbed849b4f4
    24 
    24 
    25 #include <qnamespace.h>
    25 #include <qnamespace.h>
    26 #include <QString>
    26 #include <QString>
    27 #include <QObject>
    27 #include <QObject>
    28 #include <QList>
    28 #include <QList>
       
    29 #include <QFlag>
    29 
    30 
    30 #include <w32std.h>
    31 #include <w32std.h>
    31 
    32 
    32 #ifdef XQKEYCAPTURE_LIBRARY
    33 #ifdef XQKEYCAPTURE_LIBRARY
    33 #define XQKEYCAPTURE_EXPORT Q_DECL_EXPORT
    34 #define XQKEYCAPTURE_EXPORT Q_DECL_EXPORT
    38 class KeyCapturePrivate;
    39 class KeyCapturePrivate;
    39 
    40 
    40 typedef QList<Qt::Key> XQKeyCaptureKeyList; 
    41 typedef QList<Qt::Key> XQKeyCaptureKeyList; 
    41 typedef QList<TUint> XQKeyCaptureNativeKeyList; 
    42 typedef QList<TUint> XQKeyCaptureNativeKeyList; 
    42 
    43 
    43 class XQKEYCAPTURE_EXPORT XqKeyCapture {
    44 class XQKEYCAPTURE_EXPORT XQKeyCapture {
    44 
    45 
    45 public:
    46 public:
    46     enum LongFlags {
    47     enum LongFlags {
    47     LongShortEventImmediately = ELongCaptureShortEventImmediately,
    48     LongShortEventImmediately = ELongCaptureShortEventImmediately,
    48     LongRepeatEvents = ELongCaptureRepeatEvents,
    49     LongRepeatEvents = ELongCaptureRepeatEvents,
    49     LongNormal = ELongCaptureNormal,
    50     LongNormal = ELongCaptureNormal,
    50     LongWaitShort = ELongCaptureWaitShort,
    51     LongWaitShort = ELongCaptureWaitShort,
    51     LongWaitNotApplicable = 0
    52     LongWaitNotApplicable = 0
    52     };
    53     };
    53     
    54 		
       
    55     enum CapturingFlag {
       
    56       CaptureNone = 0x0,
       
    57       CaptureBasic = 0x1,
       
    58       CaptureCallHandlingExt = 0x2
       
    59     };
       
    60     Q_DECLARE_FLAGS(CapturingFlags, CapturingFlag)
       
    61     
       
    62 public:
       
    63     XQKeyCapture();
       
    64 
       
    65     ~XQKeyCapture();
       
    66 
       
    67     bool captureKey(Qt::Key aKey,
       
    68         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
    69         Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
    70     
       
    71     bool captureKey(TUint aKey,
       
    72         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
    73         Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
    74 
       
    75     bool captureLongKey(Qt::Key aKey,
       
    76         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
    77         Qt::KeyboardModifiers aModifier = Qt::NoModifier,
       
    78         XQKeyCapture::LongFlags aLongType = XQKeyCapture::LongNormal);
       
    79 
       
    80     bool captureLongKey(TUint aKey,
       
    81         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
    82         Qt::KeyboardModifiers aModifier = Qt::NoModifier,
       
    83         XQKeyCapture::LongFlags aLongType = XQKeyCapture::LongNormal);
       
    84 
       
    85     bool captureKeyUpAndDowns(Qt::Key aKey,
       
    86         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
    87         Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
    88     
       
    89     bool captureKeyUpAndDowns(TUint aKey,
       
    90         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
    91         Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
    92 
       
    93     bool captureKey(XQKeyCaptureKeyList list, 
       
    94             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
    95             Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
    96     
       
    97     bool captureKey(XQKeyCaptureNativeKeyList list, 
       
    98             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
    99             Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   100     
       
   101     bool captureLongKey(XQKeyCaptureKeyList list, 
       
   102             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   103             Qt::KeyboardModifiers aModifier = Qt::NoModifier,
       
   104             XQKeyCapture::LongFlags aLongType = XQKeyCapture::LongNormal);
       
   105     
       
   106     bool captureLongKey(XQKeyCaptureNativeKeyList list, 
       
   107             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   108             Qt::KeyboardModifiers aModifier = Qt::NoModifier,
       
   109             XQKeyCapture::LongFlags aLongType = XQKeyCapture::LongNormal);
       
   110     
       
   111     bool captureKeyUpAndDowns(XQKeyCaptureKeyList list, 
       
   112             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   113             Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   114     
       
   115     bool captureKeyUpAndDowns(XQKeyCaptureNativeKeyList list, 
       
   116             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   117             Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   118 		
       
   119     bool cancelCaptureKey(Qt::Key aKey,
       
   120         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   121         Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   122 
       
   123     bool cancelCaptureKey(TUint aKey,
       
   124         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   125         Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   126 
       
   127     bool cancelCaptureLongKey(Qt::Key aKey,
       
   128         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   129         Qt::KeyboardModifiers aModifier = Qt::NoModifier,
       
   130         XQKeyCapture::LongFlags aLongType = XQKeyCapture::LongNormal);
       
   131 
       
   132     bool cancelCaptureLongKey(TUint aKey,
       
   133         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   134         Qt::KeyboardModifiers aModifier = Qt::NoModifier,
       
   135         XQKeyCapture::LongFlags aLongType = XQKeyCapture::LongNormal);
       
   136 
       
   137     bool cancelCaptureKeyUpAndDowns(Qt::Key aKey,
       
   138         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   139         Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   140 
       
   141     bool cancelCaptureKeyUpAndDowns(TUint aKey,
       
   142         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   143         Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   144     
       
   145     bool cancelCaptureKey(XQKeyCaptureKeyList list, 
       
   146             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   147             Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   148     
       
   149     bool cancelCaptureKey(XQKeyCaptureNativeKeyList list, 
       
   150             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   151             Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   152     
       
   153     bool cancelCaptureLongKey(XQKeyCaptureKeyList list, 
       
   154             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   155             Qt::KeyboardModifiers aModifier = Qt::NoModifier,
       
   156             XQKeyCapture::LongFlags aLongType = XQKeyCapture::LongNormal);
       
   157     
       
   158     bool cancelCaptureLongKey(XQKeyCaptureNativeKeyList list, 
       
   159             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   160             Qt::KeyboardModifiers aModifier = Qt::NoModifier,
       
   161             XQKeyCapture::LongFlags aLongType = XQKeyCapture::LongNormal);
       
   162     
       
   163     bool cancelCaptureKeyUpAndDowns(XQKeyCaptureKeyList list, 
       
   164             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   165             Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   166     
       
   167     bool cancelCaptureKeyUpAndDowns(XQKeyCaptureNativeKeyList list, 
       
   168             Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
       
   169             Qt::KeyboardModifiers aModifier = Qt::NoModifier);
       
   170 
       
   171 	bool captureRemoteKeys(CapturingFlags flags = CaptureNone);
       
   172     
       
   173     bool cancelCaptureRemoteKeys(CapturingFlags flags = CaptureNone);
       
   174 			
       
   175     QString errorString() const;
       
   176 
       
   177     int errorId() const;
       
   178 
       
   179 private:
       
   180     KeyCapturePrivate* d;
       
   181 
       
   182 };
       
   183 
       
   184 /*
       
   185 @deprecated
       
   186 */
       
   187 
       
   188 class XQKEYCAPTURE_EXPORT XqKeyCapture {
       
   189 
       
   190 public:
       
   191     enum LongFlags {
       
   192     LongShortEventImmediately = ELongCaptureShortEventImmediately,
       
   193     LongRepeatEvents = ELongCaptureRepeatEvents,
       
   194     LongNormal = ELongCaptureNormal,
       
   195     LongWaitShort = ELongCaptureWaitShort,
       
   196     LongWaitNotApplicable = 0
       
   197     };
       
   198 	
    54 public:
   199 public:
    55     XqKeyCapture();
   200     XqKeyCapture();
    56 
   201 
    57     ~XqKeyCapture();
   202     ~XqKeyCapture();
    58 
   203 	
    59     bool captureKey(Qt::Key aKey,
   204     bool captureKey(Qt::Key aKey,
    60         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
   205         Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,
    61         Qt::KeyboardModifiers aModifier = Qt::NoModifier);
   206         Qt::KeyboardModifiers aModifier = Qt::NoModifier);
    62     
   207     
    63     bool captureKey(TUint aKey,
   208     bool captureKey(TUint aKey,
   167 private:
   312 private:
   168     KeyCapturePrivate* d;
   313     KeyCapturePrivate* d;
   169 
   314 
   170 };
   315 };
   171 
   316 
       
   317 Q_DECLARE_OPERATORS_FOR_FLAGS(XQKeyCapture::CapturingFlags)
       
   318 
   172 #endif /* XQKEYCAPTURE_H */
   319 #endif /* XQKEYCAPTURE_H */