diff --git a/doc/qtcreator.qdoc b/doc/qtcreator.qdoc index 30cbaa88eee..567cf7daafe 100644 --- a/doc/qtcreator.qdoc +++ b/doc/qtcreator.qdoc @@ -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.