backup...
[situare] / src / ui / userinfo.h
1 /*
2    Situare - A location system for Facebook
3    Copyright (C) 2010  Ixonos Plc. Authors:
4
5        Jukka Saastamoinen - jukka.saastamoinen@ixonos.com
6        Jussi Laitinen - jussi.laitinen@ixonos.com
7        Katri Kaikkonen - katri.kaikkonen@ixonos.com
8        Henri Lampela - henri.lampela@ixonos.com
9
10    Situare is free software; you can redistribute it and/or
11    modify it under the terms of the GNU General Public License
12    version 2 as published by the Free Software Foundation.
13
14    Situare is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17    GNU General Public License for more details.
18
19    You should have received a copy of the GNU General Public License
20    along with Situare; if not, write to the Free Software
21    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301,
22    USA.
23 */
24
25 #ifndef USERINFO_H
26 #define USERINFO_H
27
28 #include <QWidget>
29 #include "updatelocation/updatelocationdialog.h"
30
31 class ImageButton;
32
33 /**
34 * @brief UserInfo shows user's data in expandable item.
35 *
36 * @class UserInfo userinfo.h "ui/userinfo.h"
37 */
38 class UserInfo : public QWidget
39 {
40     Q_OBJECT
41 public:
42     /**
43     * @brief Constructor
44     *
45     * @param parent Parent
46     */
47     UserInfo(QWidget *parent=0);
48
49 /*******************************************************************************
50 * BASE CLASS INHERITED AND REIMPLEMENTED MEMBER FUNCTIONS
51 *******************************************************************************/
52 protected:
53     /**
54     * @brief Set current mouse position to mouse event position.
55     *
56     * @param event QMouseEvent mouse press event
57     */
58     void mousePressEvent(QMouseEvent *event);
59
60     /**
61     * @brief Call toggleHeight if mouse position is unchanged.
62     *
63     * Check if current mouse position is same as mouse release position.
64     * @param event QMouseEvent mouse release event
65     */
66     void mouseReleaseEvent(QMouseEvent *event);
67
68     /**
69     * @brief This function is called when the widget is drawn
70     *
71     * @param aPaintEvent Pointer to paint event
72     */
73     void paintEvent(QPaintEvent *aPaintEvent);
74
75 /******************************************************************************
76 * MEMBER FUNCTIONS AND SLOTS
77 ******************************************************************************/
78 public:
79     /**
80     * @brief Sets the users current address
81     *
82     * @param address Reference to users current address
83     */
84     void setAddress(const QString &address);
85
86     /**
87     * @brief Sets the users current coordinates
88     *
89     * @param coordinates Reference to users current coordinates
90     */
91     void setCoordinates(const QPointF &coordinates);
92
93     /**
94     * @brief Sets the message text
95     *
96     * @param text Reference to user message
97     */
98     void setMessageText(const QString &text);
99
100     /**
101     * @brief Sets the user picture
102     *
103     * @param image Reference to user picture
104     */
105     void setProfileImage(const QPixmap &image);
106
107     /**
108     * @brief Sets the time of updated message
109     *
110     * @param time Reference to time when message was sent.
111     */
112     void setTime(const QString &time);
113
114    /**
115     * @brief Sets the user name
116     *
117     * @param name Reference to user name
118     */
119     void setUserName(const QString &name);
120
121 private:
122     /**
123     * @brief Set shortened or full-length text to labels.
124     *
125     * @param expanded true if full-length text is set, false otherwise
126     */
127     void setText(bool expanded);
128
129     /**
130     * @brief Set shortened texts from User data.
131     *
132     * Text length is defined by MAXIMUM_CHARS.
133     */
134     QString shortenText(const QLabel *label, const QString &text, int textMaxWidth);
135
136 private slots:
137     /**
138     * @brief Slot for find button click
139     */
140     void findButtonClicked();
141
142     /**
143     * @brief Slot function to forward messageUpdate launch signal
144     *
145     */
146     void messageUpdate();    
147
148 /******************************************************************************
149 * SIGNALS
150 ******************************************************************************/
151 signals:
152     /**
153     * @brief Signal for finding user.
154     *
155     * @param coordinates user geo coordinates
156     */
157     void findUser(const QPointF &coordinates);
158
159     /**
160     * @brief Signal for refreshing user data.
161     *
162     */
163     void refreshUserData();
164
165     /**
166     * @brief Signal for requesting reverseGeo from SituareEngine
167     *
168     */
169     void requestReverseGeo();
170
171     /**
172     * @brief Signals, when address data is ready
173     *
174     * @param address Street address
175     */
176     void reverseGeoReady(const QString &address);
177
178     /**
179     * @brief Signal for requestLocationUpdate from SituareEngine via MainWindow class
180     *
181     * @param status Status message
182     * @param publish Publish on Facebook
183     */
184     void statusUpdate(const QString &status, const bool &publish);
185     void messageUpdatedToSituare();
186     void messageSendingFailed(const QString &error);
187
188 /******************************************************************************
189 * DATA MEMBERS
190 ******************************************************************************/
191 private:
192     bool m_expanded;                    ///< Item expanded state
193     QLabel *m_locationLabel;            ///< Location label
194     QLabel *m_nameLabel;                ///< Name label
195     QLabel *m_statusTextLabel;          ///< Status text label
196     QLabel *m_updatedLabel;             ///< Updated label
197     QPixmap m_backgroundBottomImage;    ///< Bottom background image
198     QPixmap m_backgroundMiddleImage;    ///< Middle background image
199     QPixmap m_backgroundTopImage;       ///< Top background image
200     QPoint m_mousePosition;             ///< Current mouse press position
201     QPointF m_coordinates;              ///< User current coordinates
202     QString m_address;                  ///< Address from where the new message was sent.
203     QString m_messageText;              ///< User's message
204     QString m_time;                     ///< Time when the new message was sent
205     QString m_userName;                 ///< User's name
206     ImageButton *m_findButton;          ///< User find button
207 };
208
209 #endif // USERINFO_H