summaryrefslogtreecommitdiffstats
path: root/src/controls/doc/src/qtquickcontrols-platformnotes.qdoc
blob: 70f1a1bb5265c5a0da6904292a8326b44baa6c98 (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
/****************************************************************************
**
** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file.  Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: http://www.gnu.org/copyleft/fdl.html.
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
    \page qtquickcontrols-platformnotes.html
    \title Qt Quick Controls Platform Notes
    \brief Platform specific notes for Qt Quick Controls.

    This page contains platform specific notes for creating applications
    that use \l{Qt Quick Controls}.

    \section1 Android

    Qt 5.4 introduced a native Android style for Qt Quick Controls.

    \image qtquickcontrols-android.png

    \note The Android style requires Android 3.0 (API level 11) or later.

    No special actions are required to use the Android style. It is
    automatically selected and deployed on Android. See \l{Getting Started
    with Qt for Android} and \l{Deploying an Application on Android} for
    more details on the Android essentials.

    \section2 Action Bar

    The \l{http://developer.android.com/guide/topics/ui/actionbar.html}
    {Action Bar} is a special Android control that provides many key features
    including various navigation modes, actions, an options menu, a back
    button, and also displays the application icon and title.

    Unlike \l{Qt Widgets}, Qt Quick Controls do not use the native action
    bar on Android. ToolBar and MenuBar are offered as a cross-platform
    replacement. They are unified to a single "action bar" when assigned to
    the appropriate ApplicationWindow properties.

    The advantage of a non-native ToolBar is that it can contain any child
    items declared in QML. Just to name a few possibilities:
    \list
    \li ToolButton actions,
    \li A TextField as a search field,
    \li A ComboBox for navigation, and
    \li A ProgressBar for displaying progress.
    \endlist
*/