Counting Clicks for Qt Widgets: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
'''How to find the Number of Clicks received for Qt Widgets using QSettings, re-implementing eventFilter() method'''
'''How to find the Number of Clicks received for Qt Widgets using QSettings, re-implementing eventFilter() method'''


[[Category:Developing with Qt::General]]<br />[[Category:HowTo]]<br />[[Category:Snippets]]<br />[[Category:Tutorial]]
[[Category:Developing with Qt::General]]
[[Category:HowTo]]
[[Category:Snippets]]
[[Category:Tutorial]]


[toc align_right=&quot;yes&amp;quot; depth=&quot;3&amp;quot;]
[toc align_right="yes" depth="3"]


'''English''' | [[How_to_Use_QSettings_Bulgarian|Български]] | [[How_to_Use_QSettings_Spanish|Spanish]] | [[How_to_Use_QSettings_SimplifiedChinese|简体中文]] | [[How_to_Use_QSettings_Greek|Ελληνικά]] |<br />[[How_to_Use_QSettings_Russian|Русский]] | [[How_to_Use_QSettings_Persian|فارسی]]
'''English''' | [[How_to_Use_QSettings_Bulgarian|Български]] | [[How_to_Use_QSettings_Spanish|Spanish]] | [[How_to_Use_QSettings_SimplifiedChinese|简体中文]] | [[How_to_Use_QSettings_Greek|Ελληνικά]] |
[[How_to_Use_QSettings_Russian|Русский]] | [[How_to_Use_QSettings_Persian|فارسی]]


= How to Use QSettings =
= How to Use QSettings =
Line 11: Line 15:
== QSettings Overview ==
== QSettings Overview ==


&quot;QSettings&amp;quot;:http://doc.qt.io/qt-5.0/qtcore/qsettings.html class provides '''Persistent''' and '''platform-independent''' application settings. '''QSettings''' allows to save and load the previously stored settings(Values) in the form of INI text files, system registry on Windows, and in XML preferences files on Mac OS X.
"QSettings":http://doc.qt.io/qt-5.0/qtcore/qsettings.html class provides '''Persistent''' and '''platform-independent''' application settings. '''QSettings''' allows to save and load the previously stored settings(Values) in the form of INI text files, system registry on Windows, and in XML preferences files on Mac OS X.


QSettings's values are stored as '''QVariant''', allowing to save different types, such as '''QString''', '''QRect''', and '''QImage''', with the minimum of effort.
QSettings's values are stored as '''QVariant''', allowing to save different types, such as '''QString''', '''QRect''', and '''QImage''', with the minimum of effort.
Line 21: Line 25:
</code>Countclicks::Countclicks() : QObject(),settings(NULL)</code>
</code>Countclicks::Countclicks() : QObject(),settings(NULL)</code>


<code>settings = new QSettings(&quot;clickscount.ini&amp;quot;,QSettings::IniFormat);<code>
<code>settings = new QSettings("clickscount.ini",QSettings::IniFormat);<code>


the above three individual steps will construct a '''QSettings''' object for accessing the settings stored in the file called clickscount.ini,with the INI file format.
the above three individual steps will construct a '''QSettings''' object for accessing the settings stored in the file called clickscount.ini,with the INI file format.
Line 47: Line 51:
=== countclicks.h ===
=== countclicks.h ===


<code><br />#ifndef COUNTCLICKS_H<br />#define COUNTCLICKS_H<br />#include &lt;QObject&amp;gt;<br />#include &lt;QSettings&amp;gt;
<code>
#ifndef COUNTCLICKS_H
#define COUNTCLICKS_H
#include <QObject>
#include <QSettings>


class CountClicks : public QObject<br />{<br /> Q_OBJECT
class CountClicks : public QObject
{
Q_OBJECT


public:<br /> CountClicks();<br /> ~CountClicks();
public:
CountClicks();
~CountClicks();


protected:<br /> bool eventFilter(QObject *objectName, QEvent *event);
protected:
bool eventFilter(QObject *objectName, QEvent *event);


private:<br />//QSettings Object declaration<br /> QSettings *settings;<br />};<br />#endif // COUNTCLICKS_H<br /></code>
private:
//QSettings Object declaration
QSettings *settings;
};
#endif // COUNTCLICKS_H
</code>


=== countclicks.cpp ===
=== countclicks.cpp ===


<code><br />#include &lt;QMouseEvent&amp;gt;<br />#include &lt;QApplication&amp;gt;
<code>
#include <QMouseEvent>
#include <QApplication>


#include &quot;countclicks.h&amp;quot;
#include "countclicks.h"


CountClicks::CountClicks() : QObject(),settings(NULL)<br />{<br />}
CountClicks::CountClicks() : QObject(),settings(NULL)
{
}


CountClicks::~CountClicks()<br />{<br />}
CountClicks::~CountClicks()
{
}


bool CountClicks::eventFilter(QObject '''object, QEvent''' event)<br />{<br /> static int value = 0;
bool CountClicks::eventFilter(QObject '''object, QEvent''' event)
{
static int value = 0;


//Constructs a QSettings object for accessing the settings stored in the file called &quot;clickscount&amp;quot;, If the file doesn't already exist, it is created with the mentioned file format.Here it is INI text file format.<br />if (!settings)<br /> settings = new QSettings(&quot;clickscount.ini&amp;quot;,QSettings::IniFormat, this);
//Constructs a QSettings object for accessing the settings stored in the file called "clickscount", If the file doesn't already exist, it is created with the mentioned file format.Here it is INI text file format.
if (!settings)
settings = new QSettings("clickscount.ini",QSettings::IniFormat, this);


if (event-&gt;type() == QEvent::MouseButtonPress)<br />{<br /> //Groups are useful to avoid typing in the same setting paths over and over.The current settings are stored with the prefix &quot;countclicks&amp;quot; in the clickscount file.<br />settings-&gt;beginGroup(&quot;countclicks&amp;quot;);
if (event->type() == QEvent::MouseButtonPress)
{
//Groups are useful to avoid typing in the same setting paths over and over.The current settings are stored with the prefix "countclicks" in the clickscount file.
settings->beginGroup("countclicks");


//Returns the value for the given setting key. If the setting doesn't exist, defaultValue is returned.<br />int value = settings-&gt;value(object-&gt;objectName()).toInt();
//Returns the value for the given setting key. If the setting doesn't exist, defaultValue is returned.
int value = settings->value(object->objectName()).toInt();


value = ++value;
value = ++value;


//Sets the value of setting key to value. If the key already exists, the previous value is overwritten.<br />settings-&gt;setValue(object-&gt;objectName(),value);
//Sets the value of setting key to value. If the key already exists, the previous value is overwritten.
settings->setValue(object->objectName(),value);


//Resets the group to what it was before the corresponding beginGroup() call.If many settings are meant to be saved and restored with the same prefix, then prefixes beginGroup() and endGroup() are used.<br />settings-&gt;endGroup();
//Resets the group to what it was before the corresponding beginGroup() call.If many settings are meant to be saved and restored with the same prefix, then prefixes beginGroup() and endGroup() are used.
settings->endGroup();


// true is returned to stop it being handled furthermore by parent class.<br />return true;<br />}
// true is returned to stop it being handled furthermore by parent class.
return true;
}


else<br /> {<br /> // all the unhandled events are passed to the base class's eventFilter(QObject * , QEvent * ) function<br /> return QObject::eventFilter(object,event);<br /> }<br />}
else
{
// all the unhandled events are passed to the base class's eventFilter(QObject * , QEvent * ) function
return QObject::eventFilter(object,event);
}
}


</code>
</code>
Line 91: Line 132:
include the countclicks.h
include the countclicks.h


<code> #include &quot;countclicks.h&amp;quot; <code>
<code> #include "countclicks.h" <code>


Construct the object of CountClicks class.
Construct the object of CountClicks class.
Line 99: Line 140:
Filters MouseButtonPress events,and writes them to settings file if this object has been installed as an event filter for desired Qt widget like pushButton in any UserInterface.
Filters MouseButtonPress events,and writes them to settings file if this object has been installed as an event filter for desired Qt widget like pushButton in any UserInterface.


Not only MouseButtonPress events are filtered and numbered,but also events like '''QEvent::HoverEnter''','''QEvent::KeyPress'''<br />can also be filtered.
Not only MouseButtonPress events are filtered and numbered,but also events like '''QEvent::HoverEnter''','''QEvent::KeyPress'''
can also be filtered.


In the below step all events that are sent to pushButton object are filtered and only MouseButtonPress events are counted and stored for the next session by installing the event filter '''cc''' on pushButton.
In the below step all events that are sent to pushButton object are filtered and only MouseButtonPress events are counted and stored for the next session by installing the event filter '''cc''' on pushButton.


For example:
For example:

Revision as of 10:40, 25 February 2015

How to find the Number of Clicks received for Qt Widgets using QSettings, re-implementing eventFilter() method

[toc align_right="yes" depth="3"]

English | Български | Spanish | 简体中文 | Ελληνικά | Русский | فارسی

How to Use QSettings

QSettings Overview

"QSettings":http://doc.qt.io/qt-5.0/qtcore/qsettings.html class provides Persistent and platform-independent application settings. QSettings allows to save and load the previously stored settings(Values) in the form of INI text files, system registry on Windows, and in XML preferences files on Mac OS X.

QSettings's values are stored as QVariant, allowing to save different types, such as QString, QRect, and QImage, with the minimum of effort.

QSettings Object Declaration, Initialization and Construction

QSettings *settings;<code>

Countclicks::Countclicks() : QObject(),settings(NULL)

settings = new QSettings("clickscount.ini",QSettings::IniFormat);<code>

the above three individual steps will construct a '''QSettings''' object for accessing the settings stored in the file called clickscount.ini,with the INI file format.

== QSettings Class functions used in this example ==

* beginGroup(const QString &amp; prefix )

* setValue ( const QString &amp; key, const QVariant &amp; value )

* value ( const QString &amp; key, const QVariant &amp; defaultValue = QVariant() ) const

* endGroup ()

== Example ==

The following example shows how to create a class that handles the events if this class object has been installed as an event filter for the watched object.

CountClicks class is inherited from the QObject class.The protected boolean function is re-implemented.

bool eventFilter ( QObject * watched, QEvent * event ) [virtual]

In the current implementation of this class the event QEvent::MouseButtonPress which includes Qt::LeftButton,Qt::RightButton,Qt::MiddleButton is filtered and handled,so true is returned to stop it being handled furthermore, and all the unhandled events are passed to the base class's eventFilter(QObject watched, QEvent * event)* function.

countclicks.h

#ifndef COUNTCLICKS_H
#define COUNTCLICKS_H
#include <QObject>
#include <QSettings>

class CountClicks : public QObject
{
 Q_OBJECT

public:
 CountClicks();
 ~CountClicks();

protected:
 bool eventFilter(QObject *objectName, QEvent *event);

private:
//QSettings Object declaration
 QSettings *settings;
};
#endif // COUNTCLICKS_H

countclicks.cpp

#include <QMouseEvent>
#include <QApplication>

#include "countclicks.h"

CountClicks::CountClicks() : QObject(),settings(NULL)
{
}

CountClicks::~CountClicks()
{
}

bool CountClicks::eventFilter(QObject '''object, QEvent''' event)
{
 static int value = 0;

//Constructs a QSettings object for accessing the settings stored in the file called "clickscount", If the file doesn't already exist, it is created with the mentioned file format.Here it is INI text file format.
if (!settings)
 settings = new QSettings("clickscount.ini",QSettings::IniFormat, this);

if (event->type() == QEvent::MouseButtonPress)
{
 //Groups are useful to avoid typing in the same setting paths over and over.The current settings are stored with the prefix "countclicks" in the clickscount file.
settings->beginGroup("countclicks");

//Returns the value for the given setting key. If the setting doesn't exist, defaultValue is returned.
int value = settings->value(object->objectName()).toInt();

value = ++value;

//Sets the value of setting key to value. If the key already exists, the previous value is overwritten.
settings->setValue(object->objectName(),value);

//Resets the group to what it was before the corresponding beginGroup() call.If many settings are meant to be saved and restored with the same prefix, then prefixes beginGroup() and endGroup() are used.
settings->endGroup();

// true is returned to stop it being handled furthermore by parent class.
return true;
}

else
 {
 // all the unhandled events are passed to the base class's eventFilter(QObject * , QEvent * ) function
 return QObject::eventFilter(object,event);
 }
}

Usage of CountClicks EventFilter Class

include the countclicks.h

 #include "countclicks.h" <code>

Construct the object of CountClicks class.

CountClicks *cc = new CountClicks;

Filters MouseButtonPress events,and writes them to settings file if this object has been installed as an event filter for desired Qt widget like pushButton in any UserInterface.

Not only MouseButtonPress events are filtered and numbered,but also events like QEvent::HoverEnter,QEvent::KeyPress can also be filtered.

In the below step all events that are sent to pushButton object are filtered and only MouseButtonPress events are counted and stored for the next session by installing the event filter cc on pushButton.

For example: