1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
/***************************************************************************
**
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (directui@nokia.com)
**
** This file is part of libmeegotouch.
**
** If you have questions regarding the use of this file, please contact
** Nokia at directui@nokia.com.
**
** This library is free software; you can redistribute it and/or
** modify it under the terms of the GNU Lesser General Public
** License version 2.1 as published by the Free Software Foundation
** and appearing in the file LICENSE.LGPL included in the packaging
** of this file.
**
****************************************************************************/
#ifndef MBUTTONVIEW_H
#define MBUTTONVIEW_H
#include <mwidgetview.h>
#include <mbuttonmodel.h>
#include <mbuttonstyle.h>
class MButtonViewPrivate;
class MButtonViewTest;
class MButton;
class QGraphicsSceneResizeEvent;
/*!
\class MButtonView
\brief View class for standard push buttons.
\ingroup views
\section MButtonViewOverview Overview
<TABLE border="0">
<TR>
<TD> \image html push_button.png </TD>
<TD> \image html push_button_down.png </TD>
</TR>
</TABLE>
MButtonView is used to visualize push buttons and toggle
buttons. The view draws a fixed background and an icon, text or both
on top of it. If the view is for a checkable button, it uses a different
background and different text color for the checked state.
The outlook of button can be changed using the styling attributes defined
in MButtonStyle and MWidgetStyle. MWidgetStyle::backgroundImage,
MWidgetStyle::backgroundColor and MWidgetStyle::backgroundOpacity
can be used to change appearance of the button itself. If background image
is not defined then the background is drawn with solid color. The icon
and text position and outlook can be changed through MButtonStyle.
Following rules apply:
- Only text is visible.
- Text can be freely positioned using MButtonStyle::verticalTextAlign,
MButtonStyle::horizontalTextAlign, MButtonStyle::textMarginLeft,
MButtonStyle::textMarginRight, MButtonStyle::textMarginTop and
MButtonStyle::textMarginBottom attributes.
- Only icon is visible.
- Icon can be freely positioned using MButtonStyle::iconSize and
MButtonStyle::iconAlign attributes.
- Text and icon are both visible.
- Space taken by the icon is calculated first and then the rest of
available space is used for the text. The space taken by the text
is adjustable with text margin attributes.
- If icon is aligned to left, then the text goes to right or if icon is
aligned to top then the text goes automatically below that.
A button can be in one of the following functional states:
- Enabled: default state. Button can be tapped to perform an action.
- Disabled: tapping the button doesn't perform any action.
- Disabled state is not indicated in any specific way, button is
shown normally (i.e. no dimming etc.)
\section MButtonViewInteractions Interactions
The Push Button does not support long press functionality, so it makes
no difference how long the button is held down. If user presses a button
and drags while it is in a pannable area, then button follows the finger
and tactile feedback is cancel. When releasing the finger after panning,
the button interaction is not activated.
- <b>Press down</b>: Highlights the button.
- <b>Tap</b> (button down + button up): Performs an action defined
by application.
- <b>Tap down and drag finger out of the button and release finger</b>:
Cancels the button press.
- <b>Tap down and drag finger to scroll UI</b>: Cancels the button
press.
\section MButtonViewOpenIssues Open issues
- There should be a informative banner telling why the button is disabled,
unless the reason is very self evident.
- The Button labels should follow the truncation rules of the Label widget.
\sa MButton MButtonView MButtonStyle
*/
class M_EXPORT MButtonView : public MWidgetView
{
Q_OBJECT
M_VIEW(MButtonModel, MButtonStyle)
public:
/*!
\brief Constructs the view.
\param Pointer to the controller.
*/
MButtonView(MButton *controller);
/*!
\brief Destructs the view.
*/
virtual ~MButtonView();
//! \reimp
virtual void resizeEvent(QGraphicsSceneResizeEvent *event);
//! \reimp_end
protected:
//! \reimp
virtual void drawContents(QPainter *painter, const QStyleOptionGraphicsItem *option) const;
virtual void applyStyle();
virtual void mousePressEvent(QGraphicsSceneMouseEvent *event);
virtual void mouseMoveEvent(QGraphicsSceneMouseEvent *event);
virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent *event);
virtual void setupModel();
virtual void cancelEvent(MCancelEvent *event);
virtual QSizeF sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const;
//! \reimp_end
/*!
\brief Draws the button icon (toggled or normal depending on the state
of the button) into the given \a iconRect.
*/
virtual void drawIcon(QPainter *painter, const QRectF &iconRect) const;
//! \internal
MButtonView(MButtonViewPrivate &dd, MButton *controller);
//! \internal_end
protected Q_SLOTS:
//! \reimp
virtual void updateData(const QList<const char *>& modifications);
//! \reimp_end
private:
Q_DISABLE_COPY(MButtonView)
Q_DECLARE_PRIVATE(MButtonView)
#ifdef UNIT_TEST
friend class Ut_MButtonView;
#endif
};
#endif
|
