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
|
/***************************************************************************
**
** 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 MPROGRESSINDICATORBARVIEW_H
#define MPROGRESSINDICATORBARVIEW_H
#include "mwidgetview.h"
#include <mprogressindicatormodel.h>
#include <mprogressindicatorstyle.h>
class MProgressIndicatorBarViewPrivate;
class MProgressIndicatorBarViewTest;
class MProgressIndicator;
class QGraphicsSceneResizeEvent;
/*!
\class MProgressIndicatorBarView
\brief Progress bar view for MProgressIndicator.
\ingroup views
\tableofcontents
\section ProgressIndicatorBarViewOverview Overview
Progress bars are used when duration of the process is (or will be) known. Progress bar with known
duration will give haptic feedback when operation is finished. It can be placed anywhere in UI and also
on top of other UI components to indicate ongoing processes. For the cases when duration is not
immediately known, the progress bar can be temporarily in unknown duration state until the duration
becomes known. Use to indicate e.g. uploading, downloading
<TABLE border="0">
<TR><TD> \image html progressbar1.png</TD>
<TD> A progress bar in basic state, filled until 100% reached.</TD></TR>
<TR><TD> \image html progressbar2.png</TD>
<TD> A progress bar in unknown duration state, animated indefinitely until duration becomes known.</TD></TR>
</TABLE>
\section ProgressIndicatorBarViewInteractions Interactions
Progress bar is always non-interactive.
\section ProgressIndicatorBarViewOpenIssues Open issues
\li Progress indicator shape, visualization, animation, size and possible subcomponents such
as label and error notification? Nothing yet decided by UI/Graphics team, so far only concepting
has been done.
\li Layout: where to display the current status (%, time, data bytes) of the progress indication?
\li Graphics
\sa MProgressIndicator MProgressIndicatorModel MProgressIndicatorStyle
*/
class M_EXPORT MProgressIndicatorBarView : public MWidgetView
{
Q_OBJECT
M_VIEW(MProgressIndicatorModel, MProgressIndicatorStyle)
public:
/*!
\brief Constructor
\param controller Pointer to the progressindicator's controller
*/
MProgressIndicatorBarView(MProgressIndicator *controller);
/*!
\brief Destructor
*/
virtual ~MProgressIndicatorBarView();
private Q_SLOTS:
void animationTimeout();
void visibilityChangedSlot();
protected:
//! \reimp
virtual void drawContents(QPainter *painter, const QStyleOptionGraphicsItem *option) const;
virtual void setupModel();
//! \reimp_end
MProgressIndicatorBarViewPrivate *const d_ptr;
protected Q_SLOTS:
//! \reimp
virtual void updateData(const QList<const char *>& modifications);
//! \reimp_end
private:
Q_DISABLE_COPY(MProgressIndicatorBarView)
Q_DECLARE_PRIVATE(MProgressIndicatorBarView)
#ifdef M_TEST_CLASS
M_TEST_CLASS
#endif
};
#endif // MPROGRESSINDICATORBARVIEW_H
|