added all files
[ffqwlibrary] / libffqw-n810-1.0 / sources / ffabstractcombobox.h
diff --git a/libffqw-n810-1.0/sources/ffabstractcombobox.h b/libffqw-n810-1.0/sources/ffabstractcombobox.h
new file mode 100644 (file)
index 0000000..eabb0b9
--- /dev/null
@@ -0,0 +1,191 @@
+/*
+         GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+http://www.gnu.org/licenses/gpl-3.0.txt
+*/
+/**
+ * @file ffabstractcombobox.h
+ * @brief Contains a necessary class declaration.
+ *
+ * @author ComArch S.A.
+ * @date 2009.10.9
+ * @version 1.0
+ */
+
+#ifndef FFABSTRACTCOMBOBOX_H
+#define FFABSTRACTCOMBOBOX_H
+
+#include <QApplication>
+#include <QDialog>
+#include <QDesktopWidget>
+#include <QWidget>
+#include <QtGlobal>
+#include <QGridLayout>
+
+#include "ffabstractbutton.h"
+#include "ffscrollarea.h"
+
+class FFComboPopUp;
+
+//const int SCROLLBAR_SIZE = 5;///< Default scrollbar's size
+
+/**
+ * @author ComArch S.A.
+ * @date 2009.10.09
+ * @version 1.0
+ *
+ * @brief A class inherited by specific comboboxes
+ */
+class FFAbstractComboBox : public QWidget
+{
+       Q_OBJECT
+       friend class FFComboPopUp;
+
+public:
+       FFAbstractComboBox(FFAbstractButton* activator, QWidget* parent = 0);
+       virtual ~FFAbstractComboBox();
+
+       virtual void addItem(QVariant item) = 0;
+       virtual void removeItem(int index);
+       virtual void setCurrentItem(int index);
+
+       FFAbstractButton*        activator();
+       int                      cols();
+       QList<FFAbstractButton*> items();
+       QPen                     pen();
+       int                      spacing();
+
+       void setCols(int cols);
+       void setSpacing(int spacing);
+
+protected:
+       FFAbstractButton* activator_; ///< activator shows actual combobox's value and activate popup window
+       QPen pen_; ///< contain actual pen
+       QList<FFAbstractButton*> items_; ///<list of items
+
+       void insertItem(FFAbstractButton* item, bool autoRecreate=true);
+       virtual void setActivatorSpecs(FFAbstractButton* item) = 0;
+       virtual QVariant activatorSpecs() = 0;
+
+private:
+       QGridLayout*  mainLayout; ///< layout of combobox
+       FFComboPopUp* popUp; ///< popup window showing all items
+       int           cols_; ///< number of columns
+
+private slots:
+
+
+signals:
+       void reset();
+       void activated(QVariant spec);
+       void activated(int index);
+       void itemsChanged(FFAbstractButton* button);
+};
+
+/**
+ * @author ComArch S.A.
+ * @date 2009.10.09
+ * @version 1.0
+ *
+ * @brief A class is used by comboboxes to show all items
+ */
+class FFComboPopUp : public QDialog
+{
+       Q_OBJECT
+
+       friend class FFAbstractComboBox;
+
+public:
+
+protected:
+       void showEvent(QShowEvent* event);
+
+private:
+       FFComboPopUp(QWidget* parent);
+       FFAbstractComboBox* parentCB; ///<pointer to parent widget
+
+       QGridLayout*      popUpLayout; ///< layout of popup window
+       FFScrollArea*     scrollArea; ///< scrolling widget
+       QWidget*          scrollAreaWidget; ///< widget inserted on ffscrollarea
+       QGridLayout*      scrollAreaLayout; ///< layout of scrolling widget
+       FFAbstractButton* backButton; ///< button which hide popup window
+
+private slots:
+       void recreatePopUp();
+       void registerNewItem(FFAbstractButton* newItem);
+       void accept();
+
+signals:
+       void selected(FFAbstractButton* selectedButton);
+
+};
+
+#endif // FFABSTRACTCOMBOBOX_H