blob: 495889b5ccb156b259e55cdcd9d7e1721088cd2e (
plain)
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
|
/***************************************************************************
**
** 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 MCHECKBOXVIEW_H
#define MCHECKBOXVIEW_H
#include <mbuttonview.h>
#include <mbuttonmodel.h>
#include <mcheckboxstyle.h>
class MCheckboxViewPrivate;
/*!
\class MCheckboxView
\brief View class for a checkbox button.
\ingroup views
\section MCheckboxViewOverview Overview
<TABLE border="0">
<TR>
<TD> \image html checkbox_off.png </TD>
<TD> \image html checkbox_on.png </TD>
<TD> \image html checkbox_on_down.png </TD>
</TR>
</TABLE>
Checkbox is a variant of button that allows users to set a state of a
variable or setting which has two values, On and Off. Checkbox essentially
does the same thing as the Switch variant.
\section MCheckboxViewInteractions Interactions
Users can change the state of checkbox by tapping on it (or the accompanying
text label). If the state of the checkbox is On, it is changed to Off.
If the state of the checkbox is On, it is changed to Off. If the checkbox
is disabled the tapping has not effect.
- <b>Press down</b>: Highlights the checkbox.
- <b>Tap</b> (button down + button up): Toggles the state of
the checkbox.
- <b>Tap down and drag finger out of the checkbox and release finger</b>:
Cancels the press and does not change the state.
- <b>Tap down and drag finger to scroll UI</b>: Cancels the press
and does not change the state.
\section MCheckboxViewOpenIssues Open issues
- Checkbox should include a text label describing the setting or variable
in question. This label has the same interactions as the Checkbox button itself.
\sa MButton MButtonView MCheckboxStyle
*/
class M_EXPORT MCheckboxView : public MButtonView
{
Q_OBJECT
M_VIEW(MButtonModel, MCheckboxStyle)
public:
/*!
\brief Constructs the view.
\param Pointer to the controller.
*/
MCheckboxView(MButton *controller);
/*!
\brief Destructs the view.
*/
virtual ~MCheckboxView();
protected:
//! \reimp
virtual void drawContents(QPainter *painter, const QStyleOptionGraphicsItem *option) const;
//! \reimp_end
private:
Q_DISABLE_COPY(MCheckboxView)
Q_DECLARE_PRIVATE(MCheckboxView)
};
#endif
|
