QBBButtonEventNotifier Class Reference

#include <qbbbuttoneventnotifier.h>

Inheritance diagram for QBBButtonEventNotifier:

Public Types
enum	ButtonId {   bid_minus = 0, bid_playpause, bid_plus, bid_power,   ButtonCount }
enum	ButtonState { ButtonUp, ButtonDown }

Public Slots
void	start ()
Public Slots inherited from QObject
void	deleteLater ()
	Schedules this object for deletion. More...

Public Functions
	QBBButtonEventNotifier (QObject *parent=0)
	~QBBButtonEventNotifier ()
Public Functions inherited from QObject
bool	blockSignals (bool b)
	If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More...
const QObjectList &	children () const
	Returns a list of child objects. More...
bool	connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
bool	disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0)
bool	disconnect (const QObject *receiver, const char *member=0)
void	dumpObjectInfo ()
	Dumps information about signal connections, etc. More...
void	dumpObjectTree ()
	Dumps a tree of children to the debug output. More...
QList< QByteArray >	dynamicPropertyNames () const
	Returns the names of all properties that were dynamically added to the object using setProperty(). More...
virtual bool	event (QEvent *)
	This virtual function receives events to an object and should return true if the event e was recognized and processed. More...
virtual bool	eventFilter (QObject *, QEvent *)
	Filters events if this object has been installed as an event filter for the watched object. More...
template<typename T >
T	findChild (const QString &aName=QString()) const
	Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More...
template<typename T >
QList< T >	findChildren (const QString &aName=QString()) const
	Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More...
template<typename T >
QList< T >	findChildren (const QRegExp &re) const
bool	inherits (const char *classname) const
	Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More...
void	installEventFilter (QObject *)
	Installs an event filter filterObj on this object. More...
bool	isWidgetType () const
	Returns true if the object is a widget; otherwise returns false. More...
void	killTimer (int id)
	Kills the timer with timer identifier, id. More...
virtual const QMetaObject *	metaObject () const
	Returns a pointer to the meta-object of this object. More...
void	moveToThread (QThread *thread)
	Changes the thread affinity for this object and its children. More...
QString	objectName () const
QObject *	parent () const
	Returns a pointer to the parent object. More...
QVariant	property (const char *name) const
	Returns the value of the object's name property. More...
Q_INVOKABLE	QObject (QObject *parent=0)
	Constructs an object with parent object parent. More...
void	removeEventFilter (QObject *)
	Removes an event filter object obj from this object. More...
void	setObjectName (const QString &name)
void	setParent (QObject *)
	Makes the object a child of parent. More...
bool	setProperty (const char *name, const QVariant &value)
	Sets the value of the object's name property to value. More...
void	setUserData (uint id, QObjectUserData *data)
bool	signalsBlocked () const
	Returns true if signals are blocked; otherwise returns false. More...
int	startTimer (int interval)
	Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More...
QThread *	thread () const
	Returns the thread in which the object lives. More...
QObjectUserData *	userData (uint id) const
virtual	~QObject ()
	Destroys the object, deleting all its child objects. More...

Private Slots
void	updateButtonStates ()

Private Functions
void	close ()
bool	parsePPS (const QByteArray &ppsData, QHash< QByteArray, QByteArray > *messageFields) const

Properties
QList< QByteArray >	mButtonKeys
int	mFd
QSocketNotifier *	mReadNotifier
ButtonState	mState [ButtonCount]

Additional Inherited Members
Signals inherited from QObject
void	destroyed (QObject *=0)
	This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More...
Static Public Functions inherited from QObject
static bool	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
	Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More...
static bool	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
static bool	disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
	Disconnects signal in object sender from method in object receiver. More...
static bool	disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
static uint	registerUserData ()
static QString	tr (const char *sourceText, const char *comment=0, int n=-1)
static QString	trUtf8 (const char *sourceText, const char *comment=0, int n=-1)
Static Public Variables inherited from QObject
static const QMetaObject	staticMetaObject
	This variable stores the meta-object for the class. More...
Protected Functions inherited from QObject
virtual void	childEvent (QChildEvent *)
	This event handler can be reimplemented in a subclass to receive child events. More...
virtual void	connectNotify (const char *signal)
	This virtual function is called when something has been connected to signal in this object. More...
virtual void	customEvent (QEvent *)
	This event handler can be reimplemented in a subclass to receive custom events. More...
virtual void	disconnectNotify (const char *signal)
	This virtual function is called when something has been disconnected from signal in this object. More...
	QObject (QObjectPrivate &dd, QObject *parent=0)
int	receivers (const char *signal) const
	Returns the number of receivers connected to the signal. More...
QObject *	sender () const
	Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More...
int	senderSignalIndex () const
virtual void	timerEvent (QTimerEvent *)
	This event handler can be reimplemented in a subclass to receive timer events for the object. More...
Protected Variables inherited from QObject
QScopedPointer< QObjectData >	d_ptr
Static Protected Variables inherited from QObject
static const QMetaObject	staticQtMetaObject
Related Functions inherited from QObject
T	qFindChildqFindChildren (const QObject *obj, const QString &name)()
QList< T >	qFindChildrenqFindChildren (const QObject *obj, const QString &name)()
QList< T >	qFindChildrenqFindChildren (const QObject *obj, const QRegExp &regExp)()
T *	qobject_cast (QObject *object)
	QObjectList
void *	qt_find_obj_child (QObject *parent, const char *type, const QString &name)
	Returns a pointer to the object named name that inherits type and with a given parent. More...

Detailed Description

Definition at line 52 of file qbbbuttoneventnotifier.h.

Enumerations

ButtonId

enum QBBButtonEventNotifier::ButtonId

Enumerator
bid_minus
bid_playpause
bid_plus
bid_power
ButtonCount

Definition at line 57 of file qbbbuttoneventnotifier.h.

                  {
        bid_minus = 0,
        bid_playpause,
        bid_plus,
        bid_power,
        ButtonCount
    };

ButtonState

enum QBBButtonEventNotifier::ButtonState

Enumerator
ButtonUp
ButtonDown

Definition at line 65 of file qbbbuttoneventnotifier.h.

                     {
        ButtonUp,
        ButtonDown
    };

Constructors and Destructors

QBBButtonEventNotifier()

QBBButtonEventNotifier::QBBButtonEventNotifier ( QObject *  parent = 0 )

explicit

Definition at line 65 of file qbbbuttoneventnotifier.cpp.

    : QObject(parent),
      mFd(-1),
      mReadNotifier(0)
{
    // Set initial state of buttons to ButtonUp and
    // fetch the new button ids
    int enumeratorIndex = QBBButtonEventNotifier::staticMetaObject.indexOfEnumerator("ButtonId");
    QMetaEnum enumerator = QBBButtonEventNotifier::staticMetaObject.enumerator(enumeratorIndex);
    for (int buttonId = bid_minus; buttonId < ButtonCount; ++buttonId) {
        mButtonKeys.append(enumerator.valueToKey(buttonId));
        mState[buttonId] = ButtonUp;
    }
}

~QBBButtonEventNotifier()

QBBButtonEventNotifier::~QBBButtonEventNotifier

(

)

Definition at line 80 of file qbbbuttoneventnotifier.cpp.

{
    close();
}

Functions

close()

void QBBButtonEventNotifier::close ( )

private

Definition at line 180 of file qbbbuttoneventnotifier.cpp.

Referenced by ~QBBButtonEventNotifier().

{
    delete mReadNotifier;
    mReadNotifier = 0;

    if (mFd != -1) {
        qt_safe_close(mFd);
        mFd = -1;
    }
}

parsePPS()

bool QBBButtonEventNotifier::parsePPS ( const QByteArray &  ppsData, QHash< QByteArray, QByteArray > *  messageFields  ) const

private

Definition at line 191 of file qbbbuttoneventnotifier.cpp.

Referenced by updateButtonStates().

{
    // tokenize pps data into lines
    QList<QByteArray> lines = ppsData.split('\n');

    // validate pps object
    if (lines.size() == 0 || !lines.at(0).contains(QByteArray("@status"))) {
        qWarning("QQNX: unrecognized pps object, data=%s", ppsData.constData());
        return false;
    }

    // parse pps object attributes and extract values
    for (int i = 1; i < lines.size(); i++) {

        // tokenize current attribute
        const QByteArray &attr = lines.at(i);

        qButtonDebug() << Q_FUNC_INFO << "attr=" << attr;

        int doubleColon = attr.indexOf(QByteArray("::"));
        if (doubleColon == -1) {
            // abort - malformed attribute
            continue;
        }

        QByteArray key = attr.left(doubleColon);
        QByteArray value = attr.mid(doubleColon + 2);
        messageFields->insert(key, value);
    }
    return true;
}

start

void QBBButtonEventNotifier::start ( )

slot

Definition at line 85 of file qbbbuttoneventnotifier.cpp.

{
    qButtonDebug() << Q_FUNC_INFO << "starting hardware button event processing";
    if (mFd != -1)
        return;

    // Open the pps interface
    errno = 0;
    mFd = qt_safe_open(ppsPath, O_RDONLY);
    if (mFd == -1) {
        qWarning("QQNX: failed to open buttons pps, errno=%d", errno);
        return;
    }

    mReadNotifier = new QSocketNotifier(mFd, QSocketNotifier::Read);
    QObject::connect(mReadNotifier, SIGNAL(activated(int)), this, SLOT(updateButtonStates()));

    qButtonDebug() << Q_FUNC_INFO << "successfully connected to Navigator. fd =" << mFd;
}

updateButtonStates

void QBBButtonEventNotifier::updateButtonStates ( )

privateslot

Definition at line 105 of file qbbbuttoneventnotifier.cpp.

Referenced by start().

{
    // Allocate buffer for pps data
    char buffer[ppsBufferSize];

    // Attempt to read pps data
    errno = 0;
    int bytes = qt_safe_read(mFd, buffer, ppsBufferSize - 1);
    qButtonDebug() << "Read" << bytes << "bytes of data";
    if (bytes == -1) {
        qWarning("QQNX: failed to read hardware buttons pps object, errno=%d", errno);
        return;
    }

    // We seem to get a spurious read notification after the real one. Ignore it
    if (bytes == 0)
        return;

    // Ensure data is null terminated
    buffer[bytes] = '\0';

    qButtonDebug() << Q_FUNC_INFO << "received PPS message:\n" << buffer;

    // Process received message
    QByteArray ppsData = QByteArray::fromRawData(buffer, bytes);
    QHash<QByteArray, QByteArray> fields;
    if (!parsePPS(ppsData, &fields))
        return;

    // Update our state and inject key events as needed
    for (int buttonId = bid_minus; buttonId < ButtonCount; ++buttonId) {
        // Extract the new button state
        QByteArray key = mButtonKeys.at(buttonId);
        ButtonState newState = (fields.value(key) == QByteArray("b_up") ? ButtonUp : ButtonDown);

        // If state has changed, update our state and inject a keypress event
        if (mState[buttonId] != newState) {
            qButtonDebug() << "Hardware button event: button =" << key << "state =" << fields.value(key);
            mState[buttonId] = newState;

            // Is it a key press or key release event?
            QEvent::Type type = (newState == ButtonDown) ? QEvent::KeyPress : QEvent::KeyRelease;

            Qt::Key key;
            switch (buttonId) {
                case bid_minus:
                    key = Qt::Key_VolumeDown;
                    break;

                case bid_playpause:
                    key = Qt::Key_Play;
                    break;

                case bid_plus:
                    key = Qt::Key_VolumeUp;
                    break;

                case bid_power:
                    key = Qt::Key_PowerDown;
                    break;

                default:
                    qButtonDebug() << "Unknown hardware button";
                    continue;
            }

            // No modifiers
            Qt::KeyboardModifiers modifier = Qt::NoModifier;

            // Post the event
            QWindowSystemInterface::handleKeyEvent(QApplication::activeWindow(), type, key, modifier);
        }
    }
}

Properties

mButtonKeys

QList<QByteArray> QBBButtonEventNotifier::mButtonKeys

private

Definition at line 86 of file qbbbuttoneventnotifier.h.

Referenced by QBBButtonEventNotifier(), and updateButtonStates().

mFd

int QBBButtonEventNotifier::mFd

private

Definition at line 83 of file qbbbuttoneventnotifier.h.

Referenced by close(), start(), and updateButtonStates().

mReadNotifier

QSocketNotifier* QBBButtonEventNotifier::mReadNotifier

private

Definition at line 84 of file qbbbuttoneventnotifier.h.

Referenced by close(), and start().

mState

ButtonState QBBButtonEventNotifier::mState[ButtonCount]

private

Definition at line 85 of file qbbbuttoneventnotifier.h.

Referenced by QBBButtonEventNotifier(), and updateButtonStates().

---

The documentation for this class was generated from the following files:

• /src/plugins/platforms/blackberry/qbbbuttoneventnotifier.h
• /src/plugins/platforms/blackberry/qbbbuttoneventnotifier.cpp