diff --git a/doc/images/qtcreator-application-output.png b/doc/images/qtcreator-application-output.png index 77e79007faeacd7140161525a679bd9b32b3c3f6..0792d19793869a1c4db76b89fc5a05c49326a5a2 100644 Binary files a/doc/images/qtcreator-application-output.png and b/doc/images/qtcreator-application-output.png differ diff --git a/doc/images/qtcreator-breakdown.png b/doc/images/qtcreator-breakdown.png index f901beb027285f18a9db36bd36560fe17660df0a..30d4f9c40ca608fce94eea4af96db1b8f241ec93 100644 Binary files a/doc/images/qtcreator-breakdown.png and b/doc/images/qtcreator-breakdown.png differ diff --git a/doc/images/qtcreator-build-issues.png b/doc/images/qtcreator-build-issues.png index 0cc675769f248f678d22c27e38a0bc73291cb600..e6c43cdb1be578339a6d222ef5a785fcbe19deab 100644 Binary files a/doc/images/qtcreator-build-issues.png and b/doc/images/qtcreator-build-issues.png differ diff --git a/doc/images/qtcreator-closesidebar.png b/doc/images/qtcreator-closesidebar.png index f04101bc0783e99774e2286851078c5a9cbf4576..c33e37f57a13434ce36919d9049ea9e4b3e19b88 100644 Binary files a/doc/images/qtcreator-closesidebar.png and b/doc/images/qtcreator-closesidebar.png differ diff --git a/doc/images/qtcreator-compile-pane.png b/doc/images/qtcreator-compile-pane.png index 18fb8c509d3f864c3b396d422eafd2972797a57c..457ddb90324459492fa8dbaa64743796ec3b6eb1 100644 Binary files a/doc/images/qtcreator-compile-pane.png and b/doc/images/qtcreator-compile-pane.png differ diff --git a/doc/images/qtcreator-filter.png b/doc/images/qtcreator-filter.png index ce06b31722242e88209e62f0ca56ebb7987b887c..ea6e9dba4aaf5d8e1c6bde1236c44bc314e6917a 100644 Binary files a/doc/images/qtcreator-filter.png and b/doc/images/qtcreator-filter.png differ diff --git a/doc/images/qtcreator-image-viewer.png b/doc/images/qtcreator-image-viewer.png index a6fd43272d1f8d0036ade51d722102d90c94f899..16364daf955d0b5799f58996875035cd75a664cb 100644 Binary files a/doc/images/qtcreator-image-viewer.png and b/doc/images/qtcreator-image-viewer.png differ diff --git a/doc/images/qtcreator-qt-quick-editors.png b/doc/images/qtcreator-qt-quick-editors.png index abafb79f17caef782e113ec28494a7a9ce816ff7..979f8cc4c6a02c602e764694b181e0a195ebc827 100644 Binary files a/doc/images/qtcreator-qt-quick-editors.png and b/doc/images/qtcreator-qt-quick-editors.png differ diff --git a/doc/images/qtcreator-search-pane.png b/doc/images/qtcreator-search-pane.png index 2dfa438c674aea1a90f0c784aaf9027409fcd669..13f99ed95c3192204d34fe586eef8397be8dc8ca 100644 Binary files a/doc/images/qtcreator-search-pane.png and b/doc/images/qtcreator-search-pane.png differ diff --git a/doc/images/qtcreator-search-results.png b/doc/images/qtcreator-search-results.png new file mode 100644 index 0000000000000000000000000000000000000000..e05d0f0464c9dba12d18c04664fcb507b8bfcef6 Binary files /dev/null and b/doc/images/qtcreator-search-results.png differ diff --git a/doc/images/qtcreator-show-subprojects.png b/doc/images/qtcreator-show-subprojects.png index 695a2f9c8950e7fe10fe9c4194b8bd1710584e45..c2800b382520b969c6b43ed3e30fc211a4ed9b92 100644 Binary files a/doc/images/qtcreator-show-subprojects.png and b/doc/images/qtcreator-show-subprojects.png differ diff --git a/doc/images/qtcreator-sidebar.png b/doc/images/qtcreator-sidebar.png index b234c632ca75cbaaccc06e8fce14b7a730f292e6..37a59fe51b79eee44ca80c4fd98f0c07044e5d01 100644 Binary files a/doc/images/qtcreator-sidebar.png and b/doc/images/qtcreator-sidebar.png differ diff --git a/doc/images/qtcreator-splitbar.png b/doc/images/qtcreator-splitbar.png index ed0bb48b70a26cb4dd33506f443b7e18210adc45..8b2247bee6bba9117652b9bad130014e3ad604a9 100644 Binary files a/doc/images/qtcreator-splitbar.png and b/doc/images/qtcreator-splitbar.png differ diff --git a/doc/images/qtcreator-synchronizefocus.png b/doc/images/qtcreator-synchronizefocus.png index dc14516a6c1df6e0a096c48f7722da50c43c088f..c898cbaf2cdaa87fc82545c31f2fce3ffdeaa995 100644 Binary files a/doc/images/qtcreator-synchronizefocus.png and b/doc/images/qtcreator-synchronizefocus.png differ diff --git a/doc/images/qtcreator-togglebutton.png b/doc/images/qtcreator-togglebutton.png index fd7f92c5411874a9a12cccab806d47e4e6182209..c8ab63f239f0525bc65a0fe8cb96a154d96c2785 100644 Binary files a/doc/images/qtcreator-togglebutton.png and b/doc/images/qtcreator-togglebutton.png differ diff --git a/doc/src/howto/creator-ui.qdoc b/doc/src/howto/creator-ui.qdoc index c9fbc84af1b95cc42617e6a13eb14f74eccc32e6..cf5e5fcb42e650c9effa17300cbc249193975a5b 100644 --- a/doc/src/howto/creator-ui.qdoc +++ b/doc/src/howto/creator-ui.qdoc @@ -33,34 +33,33 @@ \title User Interface - \image qtcreator-breakdown.png - When you start \QC, it opens to the \gui Welcome mode, where you can: \list - \o Read news from the Qt labs + \o Open recent sessions and projects + + \o Create and open projects \o Open tutorials and example projects - \o Create and open projects + \o Read news from the online community and Qt labs \o Send feedback to the development team - \o Open recent sessions and projects - \endlist - You can use the mode selector to change to another \QC mode. - The following image displays an example application in \gui Edit mode - and \gui Design mode. + \image qtcreator-breakdown.png - \image qtcreator-qt-quick-editors.png "Edit mode and Design mode" + You can use the mode selector (1) to change to another \QC mode. - \QC has been localized into several languages. If the system language is one - of the supported languages, it is automatically selected. To change the - language, select \gui {Tools > Options > Environment} and select a language - in the \gui Language field. The change takes effect after you restart \QC. + You can use the target selector (2) to select the + \l{glossary-development-target}{target} for running (3), debugging (4), or + building (5) the application. Output from these actions is displayed in the + output panes (7). + + You can use the locator (6) to to browse through projects, files, classes, + methods, documentation, and file systems. \section1 Modes @@ -70,6 +69,11 @@ modes, click the icons, or use the \l{keyboard-shortcuts} {corresponding keyboard shortcut}. + The following image displays an example application in \gui Edit mode (1) + and \gui Design mode (2). + + \image qtcreator-qt-quick-editors.png "Edit mode and Design mode" + You can use \QC in the following modes: \list @@ -109,7 +113,7 @@ \image qtcreator-sidebar.png - You can select the content of the sidebar in the sidebar menu: + You can select the content of the sidebar in the sidebar menu (1): \list @@ -138,14 +142,15 @@ \list \o To toggle the sidebar, click \inlineimage qtcreator-togglebutton.png - or press \key Alt+0 (\key Cmd+0 on Mac OS X). + (\gui {Hide Sidebar/Show Sidebar}) or press \key Alt+0 + (\key Cmd+0 on Mac OS X). \o To split the sidebar, click \inlineimage qtcreator-splitbar.png - . Select new content to view in the split view. + (\gui {Split}). Select new content to view in the split view. \o To close a sidebar view, click \inlineimage qtcreator-closesidebar.png - . + (\gui {Close}). \endlist @@ -175,16 +180,15 @@ \o To hide the categories and sort project files alphabetically, click \inlineimage qtcreator-filter.png - and select \gui{Simplify Tree}. + (\gui {Filter Tree}) and select \gui{Simplify Tree}. \o To hide source files which are automatically generated by the build - system, during a build, click \inlineimage qtcreator-filter.png - and select \gui{Hide Generated Files}. + system, select \gui {Filter Tree > Hide Generated Files}. \o To keep the position in the project tree synchronized with the file currently opened in the editor, click \inlineimage qtcreator-synchronizefocus.png - . + (\gui {Synchronize with Editor}). \o To see the absolute path of a file, move the mouse pointer over the file name. @@ -197,16 +201,14 @@ \gui {File System} view, which shows all the files in the file system. To keep the position in the tree synchronized with the file - opened in the editor, click - \inlineimage qtcreator-synchronizefocus.png - . + opened in the editor, select \gui {Synchronize with Editor}. \section2 Viewing the Class Hierarchy The \gui {Class View} shows the class hierarchy of the currently open projects. To organize the view by subprojects, click \inlineimage qtcreator-show-subprojects.png - . + (\gui {Show Subprojects}). \section2 Viewing QML Elements @@ -214,14 +216,11 @@ \list - \o To see a complete list of all bindings, click - \inlineimage qtcreator-filter.png - and select \gui{Show All Bindings}. + \o To see a complete list of all bindings, select \gui {Filter Tree > + Show All Bindings}. \o To keep the position in the view synchronized with the element - selected in the editor, click - \inlineimage qtcreator-synchronizefocus.png - . + selected in the editor, select \gui {Synchronize with Editor}. \endlist @@ -259,7 +258,8 @@ the \gui Find field and click the left and right arrows to search down and up in the pane. - To open the \gui{General Messages} and \gui{Version Control} panes, select + To open the \gui{General Messages} and \l{Using Version Control Systems} + {Version Control} panes, select \gui {Window > Output Panes}. \section2 Issues @@ -291,7 +291,7 @@ The pane filters out irrelevant output from the build tools and presents the issues in an organized way. To further filter the output by type, select - \inlineimage qtcreator-filter.png + \gui {Filter Tree} and then select a filter. \image qtcreator-build-issues.png @@ -305,9 +305,13 @@ \section2 Search Results - The \gui{Search Results} pane displays the results for global searches, - for example, searching within a current document, files on disk, or all - projects. + In the \gui{Search Results} pane, you can search through projects, files on + a file system or the currently open file: + + \image qtcreator-search-results.png "Search Results output pane" + + The search results are stored in the search history (1) from which you can + select earlier searches. The figure below shows an example search result for all occurrences of \c textfinder within the \c "/TextFinder" directory. @@ -319,8 +323,6 @@ The \gui{Application Output} pane displays the status of a program when it is executed, and the debug output. - The figure below shows an example output from qDebug(). - \image qtcreator-application-output.png \section2 Compile Output @@ -331,13 +333,21 @@ \image qtcreator-compile-pane.png + \section1 Changing Languages + + \QC has been localized into several languages. If the system language is one + of the supported languages, it is automatically selected. To change the + language, select \gui {Tools > Options > Environment} and select a language + in the \gui Language field. The change takes effect after you restart \QC. + \section1 Viewing Images \QC opens image files in the image viewer. \image qtcreator-image-viewer.png "Image viewer" - Use the toolbar buttons or \l{Keyboard Shortcuts}{keyboard shortcuts} to: + Use the toolbar buttons (1) or \l{Keyboard Shortcuts}{keyboard shortcuts} + to: \list