/*

 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

 * All rights reserved.

 *

 * This program is free software: you can redistribute it and/or modify

 * it under the terms of the GNU Lesser General Public License as published by

 * the Free Software Foundation, version 2.1 of the License.

 * 

 * This program 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 Lesser General Public License for more details.

 *

 * You should have received a copy of the GNU Lesser General Public License

 * along with this program.  If not, 

 * see "http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html/".

 *

 * Description:

 *

 */

#ifndef XQKEYCAPTURE_H

#define XQKEYCAPTURE_H

#include <qnamespace.h>

#include <QString>

#include <QObject>

#include <QList>

#include <w32std.h>

#ifdef XQKEYCAPTURE_LIBRARY

#define XQKEYCAPTURE_EXPORT Q_DECL_EXPORT

#else

#define XQKEYCAPTURE_EXPORT Q_DECL_IMPORT

#endif

class KeyCapturePrivate;

typedef QList<Qt::Key> XQKeyCaptureKeyList; 

typedef QList<TUint> XQKeyCaptureNativeKeyList; 

class XQKEYCAPTURE_EXPORT XqKeyCapture {

public:

    enum LongFlags {

    LongShortEventImmediately = ELongCaptureShortEventImmediately,

    LongRepeatEvents = ELongCaptureRepeatEvents,

    LongNormal = ELongCaptureNormal,

    LongWaitShort = ELongCaptureWaitShort,

    LongWaitNotApplicable = 0

    };

public:

    XqKeyCapture();

    ~XqKeyCapture();

    bool captureKey(Qt::Key aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool captureKey(TUint aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool captureLongKey(Qt::Key aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier,

        XqKeyCapture::LongFlags aLongType = XqKeyCapture::LongNormal);

    bool captureLongKey(TUint aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier,

        XqKeyCapture::LongFlags aLongType = XqKeyCapture::LongNormal);

    bool captureKeyUpAndDowns(Qt::Key aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool captureKeyUpAndDowns(TUint aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool captureKey(XQKeyCaptureKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool captureKey(XQKeyCaptureNativeKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool captureLongKey(XQKeyCaptureKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier,

            XqKeyCapture::LongFlags aLongType = XqKeyCapture::LongNormal);

    bool captureLongKey(XQKeyCaptureNativeKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier,

            XqKeyCapture::LongFlags aLongType = XqKeyCapture::LongNormal);

    bool captureKeyUpAndDowns(XQKeyCaptureKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool captureKeyUpAndDowns(XQKeyCaptureNativeKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool cancelCaptureKey(Qt::Key aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool cancelCaptureKey(TUint aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool cancelCaptureLongKey(Qt::Key aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier,

        XqKeyCapture::LongFlags aLongType = XqKeyCapture::LongNormal);

    bool cancelCaptureLongKey(TUint aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier,

        XqKeyCapture::LongFlags aLongType = XqKeyCapture::LongNormal);

    bool cancelCaptureKeyUpAndDowns(Qt::Key aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool cancelCaptureKeyUpAndDowns(TUint aKey,

        Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

        Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool cancelCaptureKey(XQKeyCaptureKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool cancelCaptureKey(XQKeyCaptureNativeKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool cancelCaptureLongKey(XQKeyCaptureKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier,

            XqKeyCapture::LongFlags aLongType = XqKeyCapture::LongNormal);

    bool cancelCaptureLongKey(XQKeyCaptureNativeKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier,

            XqKeyCapture::LongFlags aLongType = XqKeyCapture::LongNormal);

    bool cancelCaptureKeyUpAndDowns(XQKeyCaptureKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    bool cancelCaptureKeyUpAndDowns(XQKeyCaptureNativeKeyList list, 

            Qt::KeyboardModifiers aModifiersMask = Qt::NoModifier,

            Qt::KeyboardModifiers aModifier = Qt::NoModifier);

    QString errorString() const;

    int errorId() const;

private:

    KeyCapturePrivate* d;

};

#endif /* XQKEYCAPTURE_H */