feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc - Hid all information related to Qt Quick by using if defined(qtquick) tags.

Browse Source
This commit is contained in:
Leena Miettinen
2010-06-02 16:40:17 +02:00
parent 50ccecee2e
commit 9fb4e0f237
1 changed files with 86 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

94
doc/qtcreator.qdoc
View File

@@ -18,8 +18,9 @@
and developers to create applications for multiple desktop and mobile device
platforms.
For application designers, Qt Creator provides two integrated
visual editors, \QD and \QMLD, that you can use to design and develop
For application designers, Qt Creator provides an integrated
visual editor, \QD, \if defined(qtquick) and \QMLD \endif
that you can use to design and develop
application user interfaces.
For application developers,
@@ -49,7 +50,9 @@
\o \l{Building and Running an Example Application}
\o \l{Creating a Qt C++ Application}
\o \l{Creating a Mobile Application with Nokia Qt SDK}
\if defined(qtquick)
\o \l{Creating a Qt Quick Application}
\endif
\endlist
\o \l{Using the Editor}
\list
@@ -79,7 +82,9 @@
\o \l{Specifying Editor Settings}
\o \l{Specifying Dependencies}
\endlist
\if defined(qtquick)
\o \l{Developing Qt Quick Applications}
\endif
\o \l{Optimizing Applications for Mobile Devices}
\o \l{Using the Maemo Emulator}
\o \l{Debugging}
@@ -91,10 +96,14 @@
\o \l{Setting Up Debugger}
\o \l{Using Debugging Helpers}
\endlist
\if defined(qtquick)
\o \l{Debugging Qt Quick Applications}
\endif
\if defined(qtquick)
\list
\o \l{Using the QML Inspector}
\endlist
\endif
\endlist
\o \l{Using Version Control Systems}
\o \l{Adding Qt Designer Plugins}
@@ -121,8 +130,12 @@
\section1 Designing User Interfaces
\if defined(qtquick)
Qt Creator provides two integrated visual editors, \QD and \QMLD.
\endif
\QD is a tool for designing and building graphical user interfaces (GUIs) from
Qt widgets. You can compose and customize your widgets or dialogs and test
them using different styles and resolutions.
@@ -133,6 +146,8 @@
Furthermore, features like widget promotion and custom plugins allow you to use your
own widgets with \QD.
\if defined(qtquick)
UIs that use widgets are clearly structured and enforce a platform look and feel,
which makes them useful for traditional applications. However, they are static, and
do not fully make use of the large high-resolution screens, touch input, and significant
@@ -154,6 +169,8 @@
and interaction to specify user actions that change the states. You
can use Qt or JavaScript to implement the application logic.
\endif
\section1 Coding Applications
As an IDE, Qt Creator differs from a text editor in that it knows how to build and run
@@ -190,8 +207,12 @@
interface (GUI) application, Qt Creator generates an empty .ui file
that you can modify with the integrated \QD.
\if defined(qtquick)
If you choose to create a Qt Quick application, Qt Creator generates a .qml file
that you can modify with the \QMLD visual editor and the code editor.
\endif
*/
/*!
@@ -315,8 +336,14 @@
\list
\o \gui Welcome mode for opening recent sessions and projects.
\o \gui{\l{Using the Editor}{Edit}} mode for editing project and source files.
\if defined(qtquick)
\o \gui{\l{Developing Application UI}{Design}} mode for designing and developing
application user interfaces.
\else
\o \gui{\l{Using Qt Designer}{Design}} mode for designing and developing
application user interfaces.
\endif
\endif
\o \gui{\l{Debugging}{Debug}} mode for inspecting the state of your program while
debugging.
\o \gui{\l{Managing Projects}{Projects}} mode for configuring project building and
@@ -528,6 +555,8 @@
\l{Searching With the Locator}{navigation} shortcuts are available to help
speed up the process of developing your application.
\if defined(qtquick)
\section1 Developing Application UI
To help you design the user interface of your application, two visual
@@ -540,6 +569,8 @@
The integration includes project management and code completion.
\endif
\section1 Using Qt Designer
Qt Creator automatically opens all .ui files in \QD.
@@ -577,6 +608,8 @@
For more information on \QD, see
\l{http://doc.qt.nokia.com/4.7-snapshot/designer-manual.html}{Qt Designer Manual}.
\if defined(qtquick)
\section1 Using Qt Quick Designer
You can edit .qml files in the visual \QMLD editor or in the
@@ -618,6 +651,8 @@
\endlist
\endif
*/
@@ -738,11 +773,16 @@
Qt Creator understands the code as code, not just as plain text. This
allows it to help you to write well formatted code and to anticipate
what you are going to write and complete the code. The code completion
differs somewhat depending on whether you write Qt code or QML code.
what you are going to write and complete the code.
\if defined(qtquick) The code completion differs somewhat depending on whether you write Qt code or QML code.
\endif
\if defined(qtquick)
\section2 Completing Qt Code
\endif
As you write code, Qt Creator provides a list of context-sensitive
suggestions to the statement currently under your cursor.
@@ -818,6 +858,8 @@
\i A namespace
\endtable
\if defined(qtquick)
\section2 Completing QML Code
As you write QML code, Qt Creator suggests properties, IDs, and code
@@ -828,6 +870,8 @@
\image qmldesigner-code-completion.png "Completing QML code"
\endif
\section1 Using Bookmarks
To insert or delete a bookmark right-click the line number and select
@@ -1256,9 +1300,13 @@
\section1 Renaming Symbols
\if defined(qtquick)
The functions used to rename symbols depends on whether you are
writing C++ or QML code. For QML, you can only rename IDs.
\endif
To rename a specific symbol in a Qt project:
\list 1
\o In the editor, place the cursor on the symbol you would like to
@@ -1283,6 +1331,8 @@
The instances of the symbol are highlighted in code and you can edit the
symbol. All instances of the local symbol are changed as you type.
\if defined(qtquick)
To rename an ID in a Qt Quick project:
\list 1
@@ -1293,6 +1343,8 @@
\o In the \gui {Rename id} field, enter the new ID.
\endlist
\endif
*/
/*!
@@ -1400,7 +1452,9 @@
\title Creating a Project
You use wizards to create and import several types of projects and files, such
as Qt GUI or console applications and Qt Quick applications. You can also use
as Qt GUI or console applications.
\if defined(qtquick) and Qt Quick applications \endif
You can also use
wizards to add individual files to your projects. For example, you can create
the following types of files:
@@ -1409,9 +1463,13 @@
\o Qt resource files, which allow you to store binary files in the
application executable
\if defined(qtquick)
\o \QD forms and Qt QML files, which specify parts of application user
interfaces
\endif
\o C++ class, source, or header files
\endlist
@@ -2266,8 +2324,11 @@
Qt Creator automatically creates run configurations for your project.
To view and modify the settings, select \gui {Projects > Run}.
\if defined(qtquick)
The settings to specify depend on the type of the project: qmake project
or Qt Quick project.
\endif
Click \gui Add to add run settings for a project and \gui Remove to remove
the current settings.
@@ -2327,6 +2388,8 @@
\image qmldesigner-run-custom-exe.png "Run settings for custom executables"
\if defined(qtquick)
\section1 Specifying Run Settings for Qt Quick Projects
Select run settings in the \gui {Run configuration} field. The settings
@@ -2352,6 +2415,8 @@
\image qmldesigner-run-settings.png "Run settings for Qt Quick projects"
\endif
*/
@@ -2407,15 +2472,19 @@
\title Getting Started
This section contains examples that illustrate how to use Qt Creator and the
integrated design tools, \QD and \QMLD, to create, build, and run simple
This section contains examples that illustrate how to use Qt Creator
\if defined(qtquick) and the integrated design tools, \QD and \QMLD,
\endif
to create, build, and run simple
applications:
\list
\o \l{Building and Running an Example Application}
\o \l{Creating a Qt C++ Application}
\o \l{Creating a Mobile Application with Nokia Qt SDK}
\if defined(qtquick)
\o \l{Creating a Qt Quick Application}
\endif
\endlist
*/
@@ -3745,7 +3814,8 @@
\title Debugging
You can use the Qt Creator \gui Debug mode to inspect the state of your
Qt and Qt Quick projects while debugging.
Qt \if defined(qtquick) and Qt Quick \endif
projects while debugging.
Qt Creator does not include a debugger. It provides a debugger plugin that acts
as an interface between the Qt Creator core and external native debuggers
@@ -3755,6 +3825,8 @@
\image qtcreator-debugger-views.png "Native debugger views"
\if defined(qtquick)
Qt Creator includes a QML inspector plugin that you can use to debug QML.
\image qmldesigner-inspector.png "QML inspector views"
@@ -3777,6 +3849,8 @@
\gui QML. You can also press \key {Ctrl+L, 1} to switch to the native debugger and
\key {Ctrl+L, 2} to switch to the QML inspector.
\endif
*/
/*!
@@ -7108,9 +7182,13 @@
\o Debugging Helper does not work while performing On-Device Debugging.
\if defined(qtquick)
\o QML Preview (Run Project) only works if built against Qt with
Declarative UI.
\endif
\o Setting breakpoints in code that is compiled into the binary more
than once does not work.