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
|
/***************************************************************************
**
** 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 MAPPLICATIONMENUVIEW_H
#define MAPPLICATIONMENUVIEW_H
#include "mscenewindowview.h"
#include <mapplicationmenustyle.h>
#include "mapplicationmenumodel.h"
#include <mnamespace.h>
class MApplicationMenu;
class MApplicationMenuViewPrivate;
/*!
\class MApplicationMenuView
\brief View class for MApplicationMenu.
\ingroup views
\section MApplicationMenuViewOverview Overview
MApplicationMenuView is used to visualize actions placed into the MApplicationMenu.
MApplicationMenuView appears once the user clicks on the application menu title area. It is opened on
top of the current application view. Background of the view is dimmed/blurred when application
menu is open. The outlook of application menu can be changed using the styling attributes defined in
MApplicationMenuStyle and MSceneWindowStyle.
The following action widgets are supported for this particular view:
- Button, Icon button variant
- Combobox
\subsection MApplicationMenuViewCommands Commands
- There are two main types of commands: view style commands and action commands
- The view style commands set the style/order/presentation of the contents of the view, while
still staying inside the same view. Examples of style commands include a setting for list/grid
style presentation for the current view, or setting abc/recent/favourites sorting order for
the contents of the view
- Style commands are grouped and mutually exclusive, so only one can be selected at any time.
- Action commands can open new views or dialogs, essentially leaving the current view and presenting
a new UI, in the same task or then in a new task
- The view can contain only view style commands, only action commands, or both of them
- The view style and action commands are grouped together and presented separately; the view
style commands always first (on the top of the menu)
- In portrait mode, the commands are presented one item per row, vertically from top to bottom
- In landscape mode, the commands are presented in two items per row, horizontally from left to
right, then from top to bottom.
- The user should be able to turn the device orientation after opening the menu, which will redraw
the menu in the new orientation.
- Maximum number of action commands is 8, and in presence of style commands, maximum number of
action commands reduces to 6.
\section MApplicationMenuInteractions Interactions
- The view can be closed by tapping anywhere outside the menu (anywhere in the dimmed area)
- The view can also be closed from the top of screen (from the application menu title, or the top right corner)
- Selecting an action command from the application menu closes the menu
- Selecting a view style command closes the application menu and sets the view and its contents in
the newly selected style.
\sa MApplicationMenu MApplicationMenuModel MApplicationMenuStyle
*/
class M_EXPORT MApplicationMenuView : public MSceneWindowView
{
Q_OBJECT
M_VIEW(MApplicationMenuModel, MApplicationMenuStyle)
protected:
MApplicationMenuViewPrivate *const d_ptr;
public:
/*!
\brief Constructs MApplicationMenuView with a pointer to the controller
*/
MApplicationMenuView(MApplicationMenu *controller);
/*!
* \brief Destructs MApplicationMenuView
*/
virtual ~MApplicationMenuView();
//! \reimp
virtual void drawBackground(QPainter *painter, const QStyleOptionGraphicsItem *option) const;
virtual void drawContents(QPainter *painter, const QStyleOptionGraphicsItem *option) const;
//! \reimp_end
protected:
//! \reimp
virtual void applyStyle();
//! \reimp_end
MApplicationMenuView(MApplicationMenuViewPrivate &dd, MApplicationMenu *controller);
private:
Q_DISABLE_COPY(MApplicationMenuView)
Q_DECLARE_PRIVATE(MApplicationMenuView)
#ifdef UNIT_TEST
friend class Pt_MApplicationMenu;
#endif
};
#endif
|
