diff --git a/doc/examples/batteryindicator/BatteryIndicator.desktop b/doc/examples/batteryindicator/BatteryIndicator.desktop deleted file mode 100644 index 84e6ad1429f..00000000000 --- a/doc/examples/batteryindicator/BatteryIndicator.desktop +++ /dev/null @@ -1,11 +0,0 @@ -[Desktop Entry] -Encoding=UTF-8 -Version=1.0 -Type=Application -Terminal=false -Name=BatteryIndicator -Exec=/opt/usr/bin/BatteryIndicator -Icon=BatteryIndicator -X-Window-Icon= -X-HildonDesk-ShowInToolbar=true -X-Osso-Type=application/x-executable diff --git a/doc/examples/batteryindicator/BatteryIndicator.png b/doc/examples/batteryindicator/BatteryIndicator.png deleted file mode 100644 index 707d5c4e85d..00000000000 Binary files a/doc/examples/batteryindicator/BatteryIndicator.png and /dev/null differ diff --git a/doc/examples/batteryindicator/BatteryIndicator.pro b/doc/examples/batteryindicator/BatteryIndicator.pro deleted file mode 100644 index dd26e70344f..00000000000 --- a/doc/examples/batteryindicator/BatteryIndicator.pro +++ /dev/null @@ -1,32 +0,0 @@ -# Add files and directories to ship with the application -# by adapting the examples below. -# file1.source = myfile -# dir1.source = mydir -DEPLOYMENTFOLDERS = # file1 dir1 - -# Avoid auto screen rotation -#DEFINES += ORIENTATIONLOCK - -# Needs to be defined for Symbian -#DEFINES += NETWORKACCESS - -symbian:TARGET.UID3 = 0xE5123A52 - -CONFIG += mobility -MOBILITY = systeminfo - -SOURCES += main.cpp mainwindow.cpp -HEADERS += mainwindow.h -FORMS += mainwindow.ui - -# Please do not modify the following two lines. Required for deployment. -include(deployment.pri) -qtcAddDeployment() - -OTHER_FILES += \ - debian/changelog \ - debian/compat \ - debian/control \ - debian/copyright \ - debian/README \ - debian/rules diff --git a/doc/examples/batteryindicator/BatteryIndicator.svg b/doc/examples/batteryindicator/BatteryIndicator.svg deleted file mode 100644 index 566acfada01..00000000000 --- a/doc/examples/batteryindicator/BatteryIndicator.svg +++ /dev/null @@ -1,93 +0,0 @@ - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - diff --git a/doc/examples/batteryindicator/debian/README b/doc/examples/batteryindicator/debian/README deleted file mode 100644 index 69fa63a59c5..00000000000 --- a/doc/examples/batteryindicator/debian/README +++ /dev/null @@ -1,6 +0,0 @@ -The Debian Package batteryindicator ----------------------------- - -Comments regarding the Package - - -- unknown <> Tue, 05 Oct 2010 12:01:24 +0200 diff --git a/doc/examples/batteryindicator/debian/changelog b/doc/examples/batteryindicator/debian/changelog deleted file mode 100644 index ff9ebf3ec70..00000000000 --- a/doc/examples/batteryindicator/debian/changelog +++ /dev/null @@ -1,5 +0,0 @@ -batteryindicator (0.0.1) unstable; urgency=low - - * Initial Release. - - -- unknown <> Tue, 05 Oct 2010 12:01:24 +0200 diff --git a/doc/examples/batteryindicator/debian/compat b/doc/examples/batteryindicator/debian/compat deleted file mode 100644 index 7f8f011eb73..00000000000 --- a/doc/examples/batteryindicator/debian/compat +++ /dev/null @@ -1 +0,0 @@ -7 diff --git a/doc/examples/batteryindicator/debian/control b/doc/examples/batteryindicator/debian/control deleted file mode 100644 index a414f056825..00000000000 --- a/doc/examples/batteryindicator/debian/control +++ /dev/null @@ -1,13 +0,0 @@ -Source: batteryindicator -Section: user/hidden -Priority: optional -Maintainer: unknown <> -Build-Depends: debhelper (>= 5), libqt4-dev -Standards-Version: 3.7.3 -Homepage: - -Package: batteryindicator -Architecture: any -Depends: ${shlibs:Depends}, ${misc:Depends} -Description: - diff --git a/doc/examples/batteryindicator/debian/copyright b/doc/examples/batteryindicator/debian/copyright deleted file mode 100644 index 3656176d071..00000000000 --- a/doc/examples/batteryindicator/debian/copyright +++ /dev/null @@ -1,40 +0,0 @@ -This package was debianized by unknown <> on -Tue, 05 Oct 2010 12:01:24 +0200. - -It was downloaded from - -Upstream Author(s): - - - - -Copyright: - - - - -License: - - This package is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. - - This package is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with this package; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA - -On Debian systems, the complete text of the GNU General -Public License can be found in `/usr/share/common-licenses/GPL'. - -The Debian packaging is (C) 2010, unknown <> and -is licensed under the GPL, see above. - - -# Please also look if there are files or directories which have a -# different copyright/license attached and list them here. diff --git a/doc/examples/batteryindicator/debian/rules b/doc/examples/batteryindicator/debian/rules deleted file mode 100644 index 69d5d226dd5..00000000000 --- a/doc/examples/batteryindicator/debian/rules +++ /dev/null @@ -1,91 +0,0 @@ -#!/usr/bin/make -f -# -*- makefile -*- -# Sample debian/rules that uses debhelper. -# This file was originally written by Joey Hess and Craig Small. -# As a special exception, when this file is copied by dh-make into a -# dh-make output file, you may use that output file without restriction. -# This special exception was added by Craig Small in version 0.37 of dh-make. - -# Uncomment this to turn on verbose mode. -#export DH_VERBOSE=1 - - - - - -configure: configure-stamp -configure-stamp: - dh_testdir - # Add here commands to configure the package. - - touch configure-stamp - - -build: build-stamp - -build-stamp: configure-stamp - dh_testdir - - # Add here commands to compile the package. - $(MAKE) - #docbook-to-man debian/batteryindicator.sgml > batteryindicator.1 - - touch $@ - -clean: - dh_testdir - dh_testroot - rm -f build-stamp configure-stamp - - # Add here commands to clean up after the build process. - $(MAKE) clean - - dh_clean - -install: build - dh_testdir - dh_testroot - dh_clean -k - dh_installdirs - - # Add here commands to install the package into debian/batteryindicator. - $(MAKE) INSTALL_ROOT="$(CURDIR)"/debian/batteryindicator install - - -# Build architecture-independent files here. -binary-indep: build install -# We have nothing to do by default. - -# Build architecture-dependent files here. -binary-arch: build install - dh_testdir - dh_testroot - dh_installchangelogs - dh_installdocs - dh_installexamples -# dh_install -# dh_installmenu -# dh_installdebconf -# dh_installlogrotate -# dh_installemacsen -# dh_installpam -# dh_installmime -# dh_python -# dh_installinit -# dh_installcron -# dh_installinfo - dh_installman - dh_link - # dh_strip - dh_compress - dh_fixperms -# dh_perl -# dh_makeshlibs - dh_installdeb - # dh_shlibdeps - dh_gencontrol - dh_md5sums - dh_builddeb - -binary: binary-indep binary-arch -.PHONY: build clean binary-indep binary-arch binary install configure diff --git a/doc/examples/batteryindicator/deployment.pri b/doc/examples/batteryindicator/deployment.pri deleted file mode 100644 index 853feec5f31..00000000000 --- a/doc/examples/batteryindicator/deployment.pri +++ /dev/null @@ -1,93 +0,0 @@ -# checksum 0x2bb3 version 0x10001 -# This file should not be edited. -# Future versions of Qt Creator might offer updated versions of this file. - -defineTest(qtcAddDeployment) { -for(deploymentfolder, DEPLOYMENTFOLDERS) { - item = item$${deploymentfolder} - itemsources = $${item}.sources - $$itemsources = $$eval($${deploymentfolder}.source) - itempath = $${item}.path - $$itempath= $$eval($${deploymentfolder}.target) - export($$itemsources) - export($$itempath) - DEPLOYMENT += $$item -} - -MAINPROFILEPWD = $$PWD - -symbian { - ICON = $${TARGET}.svg - TARGET.EPOCHEAPSIZE = 0x20000 0x2000000 - contains(DEFINES, ORIENTATIONLOCK):LIBS += -lavkon -leikcore -leiksrv -lcone - contains(DEFINES, NETWORKACCESS):TARGET.CAPABILITY += NetworkServices -} else:win32 { - !isEqual(PWD,$$OUT_PWD) { - copyCommand = @echo Copying application data... - for(deploymentfolder, DEPLOYMENTFOLDERS) { - source = $$eval($${deploymentfolder}.source) - pathSegments = $$split(source, /) - sourceAndTarget = $$MAINPROFILEPWD/$$source $$OUT_PWD/$$eval($${deploymentfolder}.target)/$$last(pathSegments) - copyCommand += && $(COPY_DIR) $$replace(sourceAndTarget, /, \\) - } - copydeploymentfolders.commands = $$copyCommand - first.depends = $(first) copydeploymentfolders - export(first.depends) - export(copydeploymentfolders.commands) - QMAKE_EXTRA_TARGETS += first copydeploymentfolders - } -} else:unix { - maemo5 { - installPrefix = /opt/usr - desktopfile.path = /usr/share/applications/hildon - } else { - installPrefix = /usr - desktopfile.path = /usr/share/applications - !isEqual(PWD,$$OUT_PWD) { - copyCommand = @echo Copying application data... - for(deploymentfolder, DEPLOYMENTFOLDERS) { - macx { - target = $$OUT_PWD/$${TARGET}.app/Contents/Resources/$$eval($${deploymentfolder}.target) - } else { - target = $$OUT_PWD/$$eval($${deploymentfolder}.target) - } - copyCommand += && $(MKDIR) $$target - copyCommand += && $(COPY_DIR) $$MAINPROFILEPWD/$$eval($${deploymentfolder}.source) $$target - } - copydeploymentfolders.commands = $$copyCommand - first.depends = $(first) copydeploymentfolders - export(first.depends) - export(copydeploymentfolders.commands) - QMAKE_EXTRA_TARGETS += first copydeploymentfolders - } - } - for(deploymentfolder, DEPLOYMENTFOLDERS) { - item = item$${deploymentfolder} - itemfiles = $${item}.files - $$itemfiles = $$eval($${deploymentfolder}.source) - itempath = $${item}.path - $$itempath = $${installPrefix}/share/$${TARGET}/$$eval($${deploymentfolder}.target) - export($$itemfiles) - export($$itempath) - INSTALLS += $$item - } - icon.files = $${TARGET}.png - icon.path = /usr/share/icons/hicolor/64x64/apps - desktopfile.files = $${TARGET}.desktop - target.path = $${installPrefix}/bin - export(icon.files) - export(icon.path) - export(desktopfile.files) - export(desktopfile.path) - export(target.path) - INSTALLS += desktopfile icon target -} - -export (ICON) -export (INSTALLS) -export (DEPLOYMENT) -export (TARGET.EPOCHEAPSIZE) -export (TARGET.CAPABILITY) -export (LIBS) -export (QMAKE_EXTRA_TARGETS) -} diff --git a/doc/examples/batteryindicator/main.cpp b/doc/examples/batteryindicator/main.cpp deleted file mode 100644 index 36b4105d27e..00000000000 --- a/doc/examples/batteryindicator/main.cpp +++ /dev/null @@ -1,61 +0,0 @@ -/*************************************************************************** -** -** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). -** All rights reserved. -** Contact: Nokia Corporation (qt-info@nokia.com) -** -** This file is part of the documentation of Qt Creator. -** -** You may use this file under the terms of the BSD license as follows: -** -** "Redistribution and use in source and binary forms, with or without -** modification, are permitted provided that the following conditions are -** met: -** * Redistributions of source code must retain the above copyright -** notice, this list of conditions and the following disclaimer. -** * Redistributions in binary form must reproduce the above copyright -** notice, this list of conditions and the following disclaimer in -** the documentation and/or other materials provided with the -** distribution. -** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor -** the names of its contributors may be used to endorse or promote -** products derived from this software without specific prior written -** permission. -** -** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." -** -****************************************************************************/ - -#include "mainwindow.h" - -#include - -int main(int argc, char *argv[]) -{ - QApplication app(argc, argv); - - MainWindow mainWindow; - mainWindow.setOrientation(MainWindow::Auto); - -//! [0] -#ifdef Q_OS_SYMBIAN - mainWindow.showFullScreen(); -#elif defined(Q_WS_MAEMO_5) - mainWindow.showMaximized(); -#else - mainWindow.show(); -#endif -//! [0] - - return app.exec(); -} diff --git a/doc/examples/batteryindicator/mainwindow.cpp b/doc/examples/batteryindicator/mainwindow.cpp deleted file mode 100644 index 232ef64694a..00000000000 --- a/doc/examples/batteryindicator/mainwindow.cpp +++ /dev/null @@ -1,115 +0,0 @@ -/*************************************************************************** -** -** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). -** All rights reserved. -** Contact: Nokia Corporation (qt-info@nokia.com) -** -** This file is part of the documentation of Qt Creator. -** -** You may use this file under the terms of the BSD license as follows: -** -** "Redistribution and use in source and binary forms, with or without -** modification, are permitted provided that the following conditions are -** met: -** * Redistributions of source code must retain the above copyright -** notice, this list of conditions and the following disclaimer. -** * Redistributions in binary form must reproduce the above copyright -** notice, this list of conditions and the following disclaimer in -** the documentation and/or other materials provided with the -** distribution. -** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor -** the names of its contributors may be used to endorse or promote -** products derived from this software without specific prior written -** permission. -** -** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." -** -****************************************************************************/ - -// checksum 0xd429 version 0x10001 -#include "mainwindow.h" -#include "ui_mainwindow.h" - -#include - -#if defined(Q_OS_SYMBIAN) && defined(ORIENTATIONLOCK) -#include -#include -#include -#include -#endif // Q_OS_SYMBIAN && ORIENTATIONLOCK - -//! [2] -MainWindow::MainWindow(QWidget *parent): - QMainWindow(parent), - ui(new Ui::MainWindow), - deviceInfo(NULL) -{ - ui->setupUi(this); - setupGeneral(); -} -//! [2] - -MainWindow::~MainWindow() -{ - delete ui; -} - -//! [1] -void MainWindow::setupGeneral() -{ - deviceInfo = new QSystemDeviceInfo(this); - - ui->batteryLevelBar->setValue(deviceInfo->batteryLevel()); - - connect(deviceInfo, SIGNAL(batteryLevelChanged(int)), - ui->batteryLevelBar, SLOT(setValue(int))); -} -//! [1] - -void MainWindow::setOrientation(Orientation orientation) -{ -#ifdef Q_OS_SYMBIAN - if (orientation != Auto) { -#if defined(ORIENTATIONLOCK) - const CAknAppUiBase::TAppUiOrientation uiOrientation = - (orientation == LockPortrait) ? CAknAppUi::EAppUiOrientationPortrait - : CAknAppUi::EAppUiOrientationLandscape; - CAknAppUi* appUi = dynamic_cast (CEikonEnv::Static()->AppUi()); - TRAPD(error, - if (appUi) - appUi->SetOrientationL(uiOrientation); - ); -#else // ORIENTATIONLOCK - qWarning("'ORIENTATIONLOCK' needs to be defined on Symbian when locking the orientation."); -#endif // ORIENTATIONLOCK - } -#elif defined(Q_WS_MAEMO_5) - Qt::WidgetAttribute attribute; - switch (orientation) { - case LockPortrait: - attribute = Qt::WA_Maemo5PortraitOrientation; - break; - case LockLandscape: - attribute = Qt::WA_Maemo5LandscapeOrientation; - break; - case Auto: - default: - attribute = Qt::WA_Maemo5AutoOrientation; - break; - } - setAttribute(attribute, true); -#else // Q_OS_SYMBIAN - Q_UNUSED(orientation); -#endif // Q_OS_SYMBIAN -} diff --git a/doc/examples/batteryindicator/mainwindow.h b/doc/examples/batteryindicator/mainwindow.h deleted file mode 100644 index a812ef84356..00000000000 --- a/doc/examples/batteryindicator/mainwindow.h +++ /dev/null @@ -1,80 +0,0 @@ -/*************************************************************************** -** -** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). -** All rights reserved. -** Contact: Nokia Corporation (qt-info@nokia.com) -** -** This file is part of the documentation of Qt Creator. -** -** You may use this file under the terms of the BSD license as follows: -** -** "Redistribution and use in source and binary forms, with or without -** modification, are permitted provided that the following conditions are -** met: -** * Redistributions of source code must retain the above copyright -** notice, this list of conditions and the following disclaimer. -** * Redistributions in binary form must reproduce the above copyright -** notice, this list of conditions and the following disclaimer in -** the documentation and/or other materials provided with the -** distribution. -** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor -** the names of its contributors may be used to endorse or promote -** products derived from this software without specific prior written -** permission. -** -** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." -** -****************************************************************************/ - -// checksum 0xa940 version 0x10001 -#ifndef MAINWINDOW_H -#define MAINWINDOW_H - -#include - -//! [1] -#include -//! [1] - -//! [2] -QTM_USE_NAMESPACE -//! [2] - -namespace Ui { - class MainWindow; -} - -class MainWindow : public QMainWindow -{ -public: - enum Orientation { - LockPortrait, - LockLandscape, - Auto - }; - - MainWindow(QWidget *parent = 0); - ~MainWindow(); - - void setOrientation(Orientation orientation); - -//! [3] -private: - Ui::MainWindow *ui; - void setupGeneral(); - - QSystemDeviceInfo *deviceInfo; -//! [3] -}; - -#endif // MAINWINDOW_H diff --git a/doc/examples/batteryindicator/mainwindow.ui b/doc/examples/batteryindicator/mainwindow.ui deleted file mode 100644 index 5b9ccdbf099..00000000000 --- a/doc/examples/batteryindicator/mainwindow.ui +++ /dev/null @@ -1,50 +0,0 @@ - - - MainWindow - - - - 0 - 0 - 200 - 320 - - - - MainWindow - - - - - - - 24 - - - - - - - - - 0 - 0 - 200 - 21 - - - - - - TopToolBarArea - - - false - - - - - - - - diff --git a/doc/src/overview/creator-getting-started.qdoc b/doc/src/overview/creator-getting-started.qdoc index a5e279e6500..8c61ee72bde 100644 --- a/doc/src/overview/creator-getting-started.qdoc +++ b/doc/src/overview/creator-getting-started.qdoc @@ -42,7 +42,6 @@ \if defined(qcmanual) \o \l{Creating a Qt Quick Application Using Qt Quick Components} \o \l{Creating a Qt Widget Based Application} - \o \l{Creating a Qt Widget Based Mobile Application} \endif \endlist diff --git a/doc/src/projects/creator-projects-overview.qdoc b/doc/src/projects/creator-projects-overview.qdoc index 013a5d0c3a5..6513b37993b 100644 --- a/doc/src/projects/creator-projects-overview.qdoc +++ b/doc/src/projects/creator-projects-overview.qdoc @@ -27,7 +27,7 @@ /*! \contentspage index.html - \previouspage creator-mobile-example.html + \previouspage creator-writing-program.html \page creator-project-managing.html \nextpage creator-project-creating.html diff --git a/doc/src/qtcreator.qdoc b/doc/src/qtcreator.qdoc index 57650106a10..c4e95d7021a 100644 --- a/doc/src/qtcreator.qdoc +++ b/doc/src/qtcreator.qdoc @@ -59,8 +59,6 @@ \o \l{Creating a Qt Quick Application} \o \l{Creating a Qt Quick Application Using Qt Quick Components} \o \l{Creating a Qt Widget Based Application} - \o \l{Creating a Qt Widget Based Mobile Application} - \endlist \o \l{Managing Projects} \list diff --git a/doc/src/widgets/qtdesigner-app-tutorial.qdoc b/doc/src/widgets/qtdesigner-app-tutorial.qdoc index fc33906bbc3..d68dcf728fe 100644 --- a/doc/src/widgets/qtdesigner-app-tutorial.qdoc +++ b/doc/src/widgets/qtdesigner-app-tutorial.qdoc @@ -29,7 +29,7 @@ \contentspage index.html \previouspage creator-qml-components-example.html \page creator-writing-program.html - \nextpage creator-mobile-example.html + \nextpage creator-project-managing.html \title Creating a Qt Widget Based Application diff --git a/doc/src/widgets/qtdesigner-mobile-app-tutorial.qdoc b/doc/src/widgets/qtdesigner-mobile-app-tutorial.qdoc deleted file mode 100644 index 2d2e7da20da..00000000000 --- a/doc/src/widgets/qtdesigner-mobile-app-tutorial.qdoc +++ /dev/null @@ -1,291 +0,0 @@ -/**************************************************************************** -** -** This file is part of Qt Creator -** -** Copyright (c) 2011 Nokia Corporation and/or its subsidiary(-ies). -** -** Contact: Nokia Corporation (qt-info@nokia.com) -** -** -** GNU Free Documentation License -** -** 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. -** -** If you have questions regarding the use of this file, please contact -** Nokia at qt-info@nokia.com. -** -****************************************************************************/ - -// ********************************************************************** -// NOTE: the sections are not ordered by their logical order to avoid -// reshuffling the file each time the index order changes (i.e., often). -// Run the fixnavi.pl script to adjust the links to the index order. -// ********************************************************************** - -/*! - \contentspage index.html - \previouspage creator-writing-program.html - \page creator-mobile-example.html - \nextpage creator-project-managing.html - - \title Creating a Qt Widget Based Mobile Application - - \note To complete this tutorial, you must install \QSDK. - The installation program installs and configures the necessary tool chains - for mobile application development. - - This tutorial describes how to use \QC to create a small Qt - application, Battery Indicator, that uses the System Information - Mobility API to fetch battery information from the device. - - The user interface for the application is designed using Qt widgets. This - enforces a platform look and feel for Symbian devices and Maemo 5 devices. - However, to achieve a platform look and feel for MeeGo Harmattan devices, - \l{Creating Qt Quick Applications}{create a Qt Quick Application} and use - the Qt Quick components for MeeGo. - - \image qtcreator-batteryindicator-screenshot.png - - \section1 Creating the Battery Indicator Project - - \note Create the project with the \gui{Help} mode active so that you can - follow these instructions while you work. - - \list 1 - - \o Select \gui{File > New File or Project > Qt Widget Project > Mobile - Qt Application > Choose}. - - \image qtcreator-new-mobile-project.png "New File or Project dialog" - - The \gui{Introduction and Project Location} dialog opens. - - \image qtcreator-mobile-intro-and-location.png "Introduction and Project Location dialog" - - \o In the \gui{Name} field, type \bold {BatteryIndicator}. - - \o In the \gui {Create in} field, enter the path for the project files. - For example, \c {C:\Qt\examples}, and then click \gui{Next}. - - The \gui{Target Setup} dialog opens. - - \image qtcreator-mobile-project-qt-versions.png "Target Setup dialog" - - \o Select \gui {Symbian Device}, \gui {Maemo5}, \gui Harmattan, and - \gui {Qt Simulator} targets, and click \gui{Next}. - - \note Targets are listed if you installed the appropriate - development environment, for example, as part of the \QSDK. You can - add targets later in the \gui Projects mode. - - The \gui {Mobile Options} dialog opens. - - \image qtcreator-mobile-project-app-options.png "Mobile Options dialog" - - \o In the \gui {Orientation behavior} field, determine how the - application behaves when the orientation of the device display - rotates between portrait and landscape, and then click \gui{Next}. - - \note This dialog opens only if you select \gui Maemo5 or - \gui {Symbian Device} target in the \gui {Target Setup} dialog. On - Harmattan, the Qt Quick Components for MeeGo provide native-looking - rotation. - - The \gui {Symbian Specific} dialog opens. - - \image qtcreator-mobile-project-symbian-options.png "Symbian Specific dialog" - - \note \QC contains a default program icon and generates an - \l{Application UID}, for testing the application on a device. You - only need to change the icon and UID if you deliver the application - for public use. - - \o Click \gui Next. - - The \gui {Maemo Specific} dialog opens. - - \image qtcreator-mobile-project-maemo-options.png "Maemo Specific dialog" - - \o In the \gui {Application icon} field, select the application - icon to use on Maemo 5 or Harmattan targets, or click \gui Next to - use the default icon. - - The \gui{Project Management} dialog opens. - - \image qtcreator-mobile-project-summary.png "Project Management dialog" - - \o Review the project settings, and click \gui{Finish} to create the - project. - - \endlist - - The BatteryIndicator project now contains the following files: - - \list - - \o BatteryIndicator.pro - \o main.cpp - \o BatteryIndicator.svg - \o BatteryIndicator.png - \o BatteryIndicator.desktop - \o deployment.pri - \o mainwindow.cpp - \o mainwindow.ui - \o mainwindow.h - \o templates for Debian deployment files - - \endlist - - \image qtcreator-mobile-project-contents.png "Project contents" - - The files come with the necessary boiler plate code that you must - modify, as described in the following sections. - - \section1 Declaring the Qt Mobility API - - To use the Qt Mobility APIs or develop applications for Symbian - devices, you must modify the .pro file to declare the Qt Mobility APIs - that you use. - - This example uses the System Info API, so you must declare it, as - illustrated by the following code snippet: - - \code - - CONFIG += mobility - MOBILITY = systeminfo - - \endcode - - Each Mobility API has its corresponding value that you have to add - as a value of MOBILITY to use the API. For a list of the APIs and the - corresponding values that you can assign to MOBILITY, see the - \l {http://doc.qt.nokia.com/qtmobility/quickstart.html}{Quickstart Example}. - - \section1 Designing the User Interface - - \list 1 - - \o In the \gui{Editor} mode, double-click the mainwindow.ui - file in the \gui{Projects} view to launch the integrated \QD. - - \o Drag and drop a \gui{Progress Bar} - (\l{http://doc.qt.nokia.com/4.7/qprogressbar.html}{QProgressBar}) - widget to the form. - - \image qtcreator-mobile-project-widgets.png "Adding widgets to the UI" - - \o In the \gui Properties pane, change the \gui objectName to - \bold batteryLevelBar. - - \o Right-click the \gui MainWindow object and select - \gui {Lay Out > Lay Out Horizontally} to ensure that the battery - indicator widget size is adjusted correctly on Maemo devices. - - \endlist - - \section1 Completing the Header File - - The mainwindow.h file contains some of the necessary #includes, a - constructor, a destructor, and the \c{Ui} object. You must include - the System Info header file, add a shortcut to the mobility name - space, and add a private function to update the battery level value in - the indicator when the battery power level changes. - - \list 1 - - \o In the \gui{Projects} view, double-click the \c{mainwindow.h} file - to open it for editing. - - \o Include the System Device Info header file, as illustrated by the - following code snippet: - - \snippet examples/batteryindicator/mainwindow.h 1 - - \o Add a shortcut to the mobility name space, as illustrated by the - following code snippet: - - \snippet examples/batteryindicator/mainwindow.h 2 - - \o Declare a private function in the \c{private} section, after the - \c{Ui::MainWindow} function, as illustrated by the following code - snippet: - - \snippet examples/batteryindicator/mainwindow.h 3 - - \endlist - - \section1 Completing the Source File - - Now that the header file is complete, move on to the source file, - mainwindow.cpp. - - \list 1 - - \o In the \gui{Projects} view, double-click the mainwindow.cpp file - to open it for editing. - - \o Create a QSystemDeviceInfo object and set its value. Then connect - the signal that indicates that battery level changed to the - \c setValue slot of the progress bar. This is illustrated by the - following code snippet: - - \snippet examples/batteryindicator/mainwindow.cpp 1 - - \o Use the constructor to set initial values and make sure that the - created object is in a defined state, as illustrated by the - following code snippet: - - \snippet examples/batteryindicator/mainwindow.cpp 2 - - \endlist - - \section1 Compiling and Running Your Program - - Now that you have all the necessary code, select \gui {Qt Simulator} - as the target and click the - \inlineimage qtcreator-run.png - button to build your program and run it in the Qt Simulator. - - In Qt Simulator, run the runOutOfBattery.qs example script - to see the value change in the Battery Indicator application. - Select \gui {Scripting > examples > runOutOfBattery.qs > Run}. - - \image qtcreator-mobile-simulated.png "Mobile example in Qt Simulator" - - \section1 Testing on a Symbian Device - - You also need to test the application on real devices. Before you can - start testing on Symbian devices, you must connect them to the development - PC by using a USB cable and install an on-device debugging agent on them. - - \list 1 - - \o Install the necessary software on the device. For more information, - see \l{Connecting Symbian Devices}. - - \o Start the CODA debugging agent on the device. - - \o Click the \gui {Target Selector} and select \gui {Symbian Device}. - - \o Click \gui Run to build the application for the Symbian device. - - \endlist - - \section1 Testing on the Maemo or MeeGo Harmattan Emulator - - The Maemo 5 (Fremantle) and MeeGo Harmattan emulator are installed as part - of the \QSDK. After they are installed, you can start them from \QC. - - The Maemo emulator emulates the Nokia N900 device environment. You can test - applications in conditions practically identical to running the application - on a Nokia N900 device with the software update release 1.3 (V20.2010.36-2). - - The MeeGo Harmattan emulator emulates the Nokia N9 device environment. - - For more information, see \l{Using Maemo or MeeGo Harmattan Emulator}. - -*/