// Copyright (C) 2025 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

// **********************************************************************
// 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.
// **********************************************************************

/*!
    \previouspage creator-faq.html
    \page creator-how-tos.html
    \nextpage creator-reference.html

    \title How to

    The following topics describe how to use \QC to perform a particular task.

    \section1 Adapt the UI

    \quotation
    \l {Adapting the UI}
    \endquotation

    Navigate the \QC UI or change its appearance and behavior.

    \details {How to adapt the UI}
    \generatelist creator-how-to-ui
    \enddetails

    \section1 Analyze

    \quotation
    \l {Analyzing code}
    \endquotation

    Use integrated code analysis tools to detect memory leaks, profile
    function execution, analyze CPU use, and eliminate unnecessary
    complexity of code. Other integrated tools provide code coverage and
    visualize trace events.

    \details {How to analyze code}
    \generatelist creator-how-to-analyze
    \enddetails

    \section1 Build and run

    \quotation
    \l {Building and running projects}
    \endquotation

    Use integrated cross-platform systems for build automation to compile your
    source code for different target platforms or with different compilers,
    debuggers, or Qt versions. Deploy applications to the target platforms
    and run them there.

    \details {How to build and run applications}
    \generatelist creator-how-to-build
    \enddetails

    \section2 Build with CMake

    \quotation
    \l {Building projects with CMake}
    \endquotation

    CMake controls the software compilation process by using simple configuration
    files, called \c CMakeLists.txt files.

    \details {How to build with CMake}
    \generatelist creator-how-to-build-with-cmake
    \enddetails

    \section2 Build with qmake

    \quotation
    \l {Building projects with qmake}
    \endquotation

    qmake automates the generation of Makefiles based on the information in a
    project file that has the extension \c .pro.

    \details {How to build with qmake}
    \generatelist creator-how-to-build-with-qmake
    \enddetails

    \section2 Manage kits

    \quotation
    \l {Managing kits}
    \endquotation

    \QC groups build and run specific settings as kits to make cross-platform
    development easier. Each kit consists of a set of values that define one
    environment, such as a device, toolchain, Qt version, and debugger command
    to use.

    \details {How to manage kits}
    \generatelist creator-how-to-manage-kits
    \enddetails

    \section2 Run projects

    \quotation
    \l {Running applications}
    \endquotation

    Run applications on local and remote desktop systems, as well as on
    embedded and mobile devices that you connect to the computer.

    \details {How to run applications}
    \generatelist creator-how-to-run
    \enddetails

    \section1 Configure \QC

    \quotation
    \l {Configuring \QC}
    \endquotation

    Use basic \QC features and preinstalled extensions and plugins. Install more
    extensions and plugins and configure external tools for use.

    \details {How to configure \QC}
    \generatelist creator-how-to-use
    \enddetails

    \section1 Create projects

    \quotation
    \l {Creating projects}
    \endquotation

    Create projects for developing applications and libraries using preset
    wizards or your own wizards. Then configure the projects for building and
    running the applications on target platforms.

    \details {How to create projects}
    \generatelist creator-how-to-projects-create
    \enddetails

    \section2 Add files

    \quotation
    \l {Adding files}
    \endquotation

    Add files to projects.

    \details {How to add files to projects}
    \generatelist creator-how-to-projects-files
    \enddetails

    \section2 Configure projects

    \quotation
    \l {Configuring projects locally}
    \endquotation

    Change the default configurations that installation programs and project
    wizards create and override global preferences for a particular project.

    \details {How to configure projects}
    \generatelist creator-how-to-projects-configure
    \enddetails

    \section1 Debug

    \quotation
    \l {Debugging}
    \endquotation

    Use debuggers to inspect the state of your application while it is running.

    \details {How to debug applications}
    \generatelist creator-how-to-debug
    \enddetails

    \section1 Design UIs

    \quotation
    \l {Designing UIs}
    \endquotation

    Design UIs with either \l{User Interfaces}{Qt Quick or Qt Widgets} using
    integrated visual editors in the \uicontrol Design mode.

    \details {How to design UIs}
    \generatelist creator-how-to-design
    \enddetails

    \section2 Design Qt Quick UIs

    \quotation
    \l {Designing Qt Quick UIs}
    \endquotation

    \QC automatically opens UI forms (\c .ui.qml) files in the integrated \QMLD,
    in \uicontrol Design mode.

    \details {How to design Qt Quick UIs}
    \generatelist creator-how-to-design-qtquick
    \enddetails

    \section3 Use UI components

    \quotation
    \l {Using UI components}
    \endquotation

    Import Qt QML modules to use instances of their QML types in applications.

    \details {How to use UI components}
    \generatelist creator-how-to-design-qtquick-components
    \enddetails

    \section3 Add animation

    \quotation
    \l {Adding animation}
    \endquotation

    Pick from a selection of animation techniques that are suitable for different
    purposes

    \details {How to animate UI components}
    \generatelist creator-how-to-design-qtquick-animation
    \enddetails

    \section3 Work with states

    \quotation
    \l {Working with states}
    \endquotation

    \details {How to apply states}
    \generatelist creator-how-to-design-qtquick-states
    \enddetails

    \section2 Design widget-based UIs

    \quotation
    \l {Designing widget-based UIs}
    \endquotation

    \QC automatically opens all \c .ui files in the integrated \QD, in \uicontrol Design
    mode.

    \details {How to design widget-based UIs}
    \generatelist creator-how-to-design-widgets
    \enddetails

    \section1 Develop for devices

    \quotation
    \l {Developing for devices}
    \endquotation

    Install the toolchain for building applications for the targeted
    embedded or mobile platform on the computer, and use \QOI to
    install Qt libraries that are built for the platform. Then add a
    kit with the toolchain and the Qt version for the device's architecture.
    When possible, \QOI creates suitable kits for you. Connect the devices
    to the computer to run, debug, and analyze applications on them.

    \section2 Android

    \quotation
    \l {Developing for Android}
    \endquotation

    Install \l {Qt for Android} and Android tools, and connect Android devices to
    the computer.

    \details {How to to develop for Android}
    \generatelist creator-how-to-android
    \enddetails

    \section2 Bare Metal

    \quotation
    \l {Developing for Bare Metal devices}
    \endquotation

    Run and debug applications on small Linux devices that are not supported
    by the remote Linux device plugin by using GDB or a hardware debugger.

    \details {How to develop for bare metal devices}
    \generatelist creator-how-to-bare-metal
    \enddetails

    \section2 \B2Q

    \quotation
    \l {Developing for \B2Q devices}
    \endquotation

    Run, debug, and analyze applications on \l{\B2Q: Documentation}{\B2Q}
    devices.

    \details {How to develop for \B2Q devices}
    \generatelist creator-how-to-b2qt
    \enddetails

    \section2 Docker

    \quotation
    \l {Developing for Docker}
    \endquotation

    Create \e {Docker devices} from \e {Docker images} and use them to build,
    run, and debug applications.

    \details {How to develop for Docker devices}
    \generatelist creator-how-to-docker
    \enddetails

    \section2 iOS

    \quotation
    \l {Developing for iOS}
    \endquotation

    Install \l {Qt for iOS} and Xcode, and connect iOS devices to the computer.

    \details {How to develop for iOS devices}
    \generatelist creator-how-to-ios
    \enddetails

    \section2 MCUs

    \quotation
    \l {Developing for MCUs}
    \endquotation

    Install \l {Qt for MCUs}, and connect microcontrollers to the computer.

    \details {How to develop for microcontrollers}
    \generatelist creator-how-to-mcu
    \enddetails

    \section2 QNX Neutrino

    \quotation
    \l {Developing for QNX Neutrino devices}
    \endquotation

    Install \l {Qt for QNX}, and connect QNX Neutrino devices to the computer.

    \details {How to develop for QNX Neutrino devices}
    \generatelist creator-how-to-qnx
    \enddetails

    \section2 Remote Linux

    \quotation
    \l {Developing for remote Linux devices}
    \endquotation

    Add kits for toolchains for building applications for generic Linux
    devices, and connect the devices to the computer.

    \details {How to develop for remote Linux devices}
    \generatelist creator-how-to-remote-linux
    \enddetails

    \target how-to-vxworks
    \section2 VxWorks

    \quotation
    \l {Developing for VxWorks}
    \endquotation

    Build \l {Qt for VxWorks}, and create VxWorks build and run kits.

    \details {How to build application for VxWorks}
    \generatelist creator-how-to-vxworks
    \enddetails

    \section2 WebAssembly

    \quotation
    \l {Building applications for the web}
    \endquotation

    Install \l{Qt for WebAssembly} to build applications for the web and run them
    in a web browser.

    \details {How to build application for the web}
    \generatelist creator-how-to-webassembly
    \enddetails

    \section2 Windows desktop

    \quotation
    \l {Developing for the Windows desktop}
    \endquotation

    Develop applications using the components and tools of the
    Windows App SDK.

    \details {How to develop for Windows desktop}
    \generatelist creator-how-to-winapp-sdks
    \enddetails

    \section1 Edit code

    \quotation
    \l {Editing code}
    \endquotation

    The code editor offers useful features for editing C++ and QML code, such
    as semantic highlighting, checking code syntax, code completion, and quick
    fixes. Some of these features are also for other programming languages, such
    as Python, for which a \e {language server} is available that provides
    information about the code to IDEs.

    \details {How to edit code}
    \generatelist creator-how-to-edit
    \enddetails

    \section2 Configure editors

    \quotation
    \l {Configuring editors}
    \endquotation

    Configure the code and text editor to suit your specific needs by
    changing the fonts, colors, highlighting, and indentation.

    \details {How to configure editors}
    \generatelist creator-how-to-configure-editors
    \enddetails

    \section2 Manage language servers

    \quotation
    \l {Managing language servers}
    \endquotation

    Configure language servers that \QC adds by default or add more of them.

    \details {How to manage language servers}
    \generatelist creator-how-to-lsp
    \enddetails

    \section2 Search

    \quotation
    \l {Searching}
    \endquotation

    Use the incremental and advanced search to search in currently open projects
    or files on the file system or use the locator to browse through projects,
    files, classes, functions, documentation, and file systems.

    \details {How to search}
    \generatelist creator-how-to-search
    \enddetails

    \section1 Edit state charts

    \quotation
    \l {Editing SCXML state charts}
    \endquotation

    Use a file wizard to create State Chart XML (SCXML) files with boilerplate
    code and edit them with an SCXML editor.

    \details {How to edit state charts}
    \generatelist creator-how-to-scxml
    \enddetails

    \section1 Edit UML-style models

    \quotation
    \l {Editing UML-style models}
    \endquotation

    Create Universal Modeling Language (UML) style models with structured and
    behavioral diagrams that offer different views to your system.

    \details {How to edit models and diagrams}
    \generatelist creator-how-to-models
    \enddetails

    \section1 Read documentation

    \quotation
    \l {Getting help}
    \endquotation

    \QC integrates the reference documentation for the Qt versions that you
    install. You can add documentation from other sources.

    \details {How to get help}
    \generatelist creator-how-to-get-help
    \enddetails

    \section1 Test

    \quotation
    \l {Testing}
    \endquotation

    Create and run \e {code based tests} and \e {build system based tests}.
    Code based testing offers special handling for particular testing
    frameworks that strongly ties to the underlying code models or
    specialized parsers. Build system based testing is independent from any
    testing frameworks. It retrieves information directly from the underlying
    build system and uses it or even the build system as such to execute the
    respective tests.

    \details {How to test applications}
    \generatelist creator-how-to-test
    \enddetails

    \section1 Use Git

    \quotation
    \l {Using Git}
    \endquotation

    Git is a fast decentralized version control system
    that is available for Windows, Linux, and \macos. You can use the
    \l {Gerrit Code Review} tool for projects that use Git.

    \details {How to use Git}
    \generatelist creator-how-to-git
    \enddetails

    \section2 Current file

    \details {How to handle changes in the current file}
    \generatelist creator-how-to-git-current-file
    \enddetails

    \section2 Current project

    \details {How to handle changes in the current project}
    \generatelist creator-how-to-git-current-project
    \enddetails

    \section2 Local repositories

    \details {How to manage local repositories}
    \generatelist creator-how-to-git-local-repository
    \enddetails

    \section2 Commits

    \details {How to handle commits}
    \generatelist creator-how-to-git-commits
    \enddetails

    \section2 Remote repositories

    \details {How to manage remote repositories}
    \generatelist creator-how-to-git-remote-repository
    \enddetails
*/

/*!
    \page creator-how-to-switch-to-edit-mode.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-edit

    \title Switch to Edit mode

    To move to the \uicontrol Edit mode and currently active file, select
    \key Esc.

    If you already are in the \uicontrol Edit mode:

    \list

        \li The first time you select \key Esc, the focus moves to the editor

        \li The second time you select \key Esc, secondary windows are closed

    \endlist

    \sa {Edit code}{How to: Edit code}, {Editing code}
*/

/*!
    \page creator-how-to-run-from-cli.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-use

    \title Run \QC from the command line

    You can start \QC and specify some options from the command line. For
    example, you can open a file to any line and column.

    To use command-line options, enter the following command in the
    directory that contains the \QC executable or specify the path to
    \QC as a part of the command:

    \badcode
    qtcreator [option] [filename[:line_number[:column_number]]]
    \endcode

    \note You can use either a colon (:) or a plus sign (+) as a separator
    between the filename and line number and the line number and the column
    number. You can also use a space between the separator and the line number.

    \section1 Examples of CLI commands

    The following are examples of the commands on supported platforms when you
    install \QC with \l{Get and Install Qt}{\QOI} to the default location. Change
    the paths as necessary.

    On Windows:

    \list

        \li \c {C:\Qt\Tools\QtCreator\bin\qtcreator -help}

        \li \c {C:\Qt\Tools\QtCreator\bin\qtcreator C:\TextFinder\textfinder.cpp:100:2}

        \li \c {C:\Qt\Tools\QtCreator\bin\qtcreator C:\TextFinder\textfinder.cpp +100+2}

    \endlist

    On Linux:

    \list

        \li \c {~/Qt/Tools/QtCreator/bin/qtcreator -help}

        \li \c {~/Qt/Tools/QtCreator/bin/qtcreator /src/TextFinder/textfinder.cpp:100:2}

        \li \c {~/Qt/Tools/QtCreator/bin/qtcreator /src/TextFinder/textfinder.cpp+100+2}

    \endlist

    On \macos:

    \list

        \li \c {~/Qt/Qt\ Creator.app/Contents/MacOS/Qt\ Creator -help}

    \endlist

    \section1 Open a project from a directory

    To open a project that is located in a particular directory, you can
    pass on the directory name as a command-line argument. \QC looks for
    a \l{Manage sessions}{session} that matches the directory name and
    loads it. Or it looks for a project file in the directory and opens it.

    For example, on Windows:

    \c {C:\qtcreator\bin>qtcreator.exe C:\Examples\alarms}

    \sa {Command-Line Options}
*/

/*!
    \page creator-how-to-locate-files-using-keyboard.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-edit

    \title Locate files using the keyboard

    Use the \uicontrol Locator to browse
    through projects, files, classes, functions, documentation, and file systems.

    \image {qtcreator-locator-open.webp} {List of found files in the locator}

    To quickly access files not directly mentioned in your project, you can
    create your own locator filters. That way you can locate files in a
    directory structure you have defined.

    To create locator filters, select \preferences >
    \uicontrol Environment > \uicontrol Locator > \uicontrol Add.

    \image {qtcreator-locator-customize.webp} {Locator tab in Environment preferences}

    \sa {Create locator filters}, {Edit code}{How to: Edit code}, {Editing code}
*/

/*!
    \page creator-how-to-perform-calculations.html
    \previouspage creator-how-to-move-between-open-files.html

    \ingroup creator-how-to-edit

    \title Perform calculations

    To do basic calculations in the locator:

    \list 1
        \li Select \key {Ctrl+K} (\key {Cmd+K} on \macos) to activate the locator.
        \li Enter \c =, followed by a space.
        \image {qtcreator-locator.webp} {List of locator filters}
        \li Perform calculations.
    \endlist

    Navigate through the entries and select \key {Enter} to copy the results to
    the clipboard

    \section1 Built-in functions

    Beside simple mathematical operations, like ((1 + 2) * 3), the following
    built-in functions exist:

    \table
        \header
            \li  Function
            \li  Purpose
        \row
            \li  abs(x)
            \li  Returns the absolute value of x
        \row
            \li  acos(x)
            \li  Returns the arccosine of x, in radians
        \row
            \li  asin(x)
            \li  Returns the arcsine of x, in radians
        \row
            \li  atan(x)
            \li  Returns the arctangent of x, in radians
        \row
            \li  atan2(x, y)
            \li  Returns the arctangent of the quotient of its arguments
        \row
            \li  bin(x)
            \li  Returns the binary representation of x
        \row
            \li  ceil(x)
            \li  Returns the value of x rounded up to the next integer
        \row
            \li  cos(x)
            \li  Returns the cosine of x (x is in radians)
        \row
            \li  exp(x)
            \li  Returns the value of E to the power of x
        \row
            \li  e()
            \li  Returns Euler's number E (2.71828...)
        \row
            \li  floor(x)
            \li  Returns the value of x rounded down to the next integer
        \row
            \li  hex(x)
            \li  Returns the hexadecimal representation of x
        \row
            \li  log(x)
            \li  Returns the natural logarithm (base E) of x
        \row
            \li  max([value1[, value2[, ...]]])
            \li  Returns the highest value of the given numbers
        \row
            \li  min([value1[, value2[, ...]]])
            \li  Returns the lowest value of the given numbers
        \row
            \li  oct(x)
            \li  Returns the octal representation of x
        \row
            \li  pi()
            \li  Returns PI (3.14159...)
        \row
            \li  pow(x, y)
            \li  Returns the value of x to the power of y
        \row
            \li  random()
            \li  Returns a random number between 0 and 1
        \row
            \li  round(x)
            \li  Returns the value of x rounded to the next integer
        \row
            \li  sin(x)
            \li  Returns the sine of x (x is in radians)
        \row
            \li  sqrt(x)
            \li  Returns the square root of x
        \row
            \li  tan(x)
            \li  Returns the tangent of x (x is in radians)
        \endtable

    \sa {Navigate with locator}, {Configure the locator}
*/

/*!
    \page creator-how-to-navigate-qml-code.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-edit

    \title Move in QML code

    Find QML methods and types, and move to the C++ implementation of a QML type.

    \section1 Locate QML methods

    To locate a QML method:

    \list 1
        \li Select \key {Ctrl+K} to activate the locator.
        \li Type m, followed by a space.
            \image {qtcreator-locator-m-filter.webp} {The m filter in the locator}
        \li Double-click a QML method in the list to move to it in the editor.
    \endlist

    \section1 Find QML types

    To find instances of a QML type in a project, place the cursor on
    the type and and do one of the following:

    \list
        \li Select \key {Ctrl+Shift+U}.
        \li Go to \uicontrol Tools > \uicontrol {QML/JS} >
            \uicontrol {Find References to Symbol Under Cursor}.
    \endlist

    \section1 Inspect QML and JavaScript

    To inspect QML and JavaScript properties, methods, and enums, place the
    cursor over them and go to \uicontrol Tools > \uicontrol {QML/JS} >
    \uicontrol {Inspect API for Element Under Cursor}.

    \section1 Move between QML and C++

    To move to the C++ implementation of a QML type in the code editor, place the
    cursor on the type and do one of the following:

    \list
        \li Select \key F2.
        \li Go to \uicontrol {Follow Symbol Under Cursor} in the context menu.
    \endlist

    \sa {Edit code}{How to: Edit code}, {Clangd}, {Editing code},
    {Navigate with locator}
*/

/*!
    \page creator-how-to-add-license-header-templates.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-projects-files

    \title Add a license header template for C++ code

    Specify a file that has a license header for C++ in \preferences >
    \uicontrol C++ > \uicontrol {File Naming} > \uicontrol {License template}.

    \image {qtcreator-options-cpp-files.png} {File Naming tab in C++ preferences}

    The license file may have special placeholders enclosed
    in \c{%%} that are replaced when generating a new file:

    \list 1

        \li \c %YEAR%: Year
        \li \c %MONTH%: Month
        \li \c %DAY%: Day of the month
        \li \c %DATE%: Date
        \li \c %USER%: Username
        \li \c %FILENAME%: File name
        \li \c %CLASS%: Class name (if applicable)
        \li \c %$VARIABLE%: Contents of environment variable \c{VARIABLE}.

    \endlist

    In addition, placeholders in the form %{..} are replaced by the
    value of the corresponding \QC variable.

    \sa {Use \QC variables}
*/

/*!
    \page creator-how-to-paste-text-from-clipboard-history.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-edit

    \title Paste text from clipboard history

    \QC stores copied text in clipboard history. To retrieve clips from the
    history, select \key {Ctrl+Shift+V} until the clip appears.
    The number of clips in the history is fixed to 10.

    \sa {Edit code}{How to: Edit code}, {Editing code}
*/

/*!
    \page creator-enclose-code-in-characters.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-edit

    \title Enclose code in brackets or quotes

    Select code and enter one of the following opening characters to add
    the matching closing character at the end of the selection:

    \list
        \li (
        \li {
        \li [
        \li <
        \li "
        \li '
    \endlist

    To specify whether to automatically insert matching characters,
    go to \preferences > \uicontrol {Text Editor} > \uicontrol Completion
    and select options in \uicontrol {Automatically Insert Matching Characters}.

    \image {qtcreator-preferences-texteditor-completion.webp} {Completion tab in Text Editor preferences}

    Also, \QC automatically inserts the closing character of a raw string literal
    prefix.

    \sa {Completion}, {Edit code}{How to: Edit code}, {Editing code}
*/

/*!
    \page creator-how-to-select-enclosing-block.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-edit

    \title Select the current code block

    To select the current block of C++ code in the code editor, select
    \key Ctrl+U.

    Select \key Ctrl+U a second time to extend the selection to the parent block.

    To undo the last selection, select \key {Ctrl+Alt+Shift+U}.

    \section1 Turn on smart block selection

    To turn on smart block selection, go to \preferences
    > \uicontrol {Text Editor} > \uicontrol Behavior and select
    \uicontrol {Enable smart selection changing}.

    \image {qtcreator-preferences-texteditor-behavior.webp} {Behavior tab in Text Editor preferences}

    \sa {Edit code}{How to: Edit code}, {Editing code}
*/

/*!
    \page creator-how-to-write-notes.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-edit

    \title Write down notes

    To write down notes without having to worry about deleting the file
    later, create a new empty text file and save it to a temporary directory
    on your machine.

    \image {qtcreator-scratch-buffer.webp} {Scratch file open in the text editor}

    To create a scratch file and open it in the text editor:

    \list
        \li Select \uicontrol File > \uicontrol {New File} > \uicontrol General >
            \uicontrol {Scratch Buffer}.
        \li Select \key {Ctrl+N}.
    \endlist

    Use the up and down arrow keys and the tab key to navigate in the editor.

    The operating system will eventually remove the file automatically. To keep
    the file, save it as a new file somewhere else. If you accidentally close the
    file, find it in \uicontrol File > \uicontrol {Recent Files}.
*/

/*!
    \page creator-how-to-set-recent-files.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-ui

    \title Set the number of recent files shown

    To set the number of files to list in \uicontrol File >
    \uicontrol {Recent Files}:

    \list 1
        \li Select \preferences > \uicontrol Environment > \uicontrol System.
            \image {qtcreator-preferences-environment-system.webp} {System tab in Environment preferences}
        \li In \uicontrol {Maximum number of entries in "Recent Files"}, set
            the number of files to show.
    \endlist

    \sa {Adapt the UI}{How to: Adapt the UI}, {Adapting the UI}
*/

/*!
    \page creator-how-to-search-and-replace-using-regexp.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-search

    \title Search and replace using a regular expression

    Search and replace across files using regular expressions in the
    \uicontrol {Search Results} view.

    Regular expressions used in \QC are modeled on Perl regular expressions.
    For more information about using regular expressions, see
    \l QRegularExpression.

    For example, to replace equality checks (\c {foo == bar}) with a function
    (\c {foo.equals(bar)}):

    \list 1
    \li Commit your changes to version control, as you cannot undo the
        replace action.
    \li Select \key {Ctrl+Shift+F} or go to \uicontrol Edit >
        \uicontrol {Find/Replace} > \uicontrol {Advanced Find} >
        \uicontrol {Open Advanced Find} to open \uicontrol {Search Results}.
        \image {qtcreator-search-reg-exp.webp} {Regular expression in Search Results view}
    \li In \uicontrol Scope, select whatever is appropriate for your search.
    \li Select \uicontrol {Use regular expressions}.
    \li Enter the following text in \uicontrol {Search for}:
        \badcode
        if \((.*) == (.*)\)
        \endcode
    \li Select \uicontrol {Search & Replace} to see a list of search results.
        \image {qtcreator-search-results-reg-exp.webp} {Search results for the regular expression}
    \li In \uicontrol {Replace with}, enter the following text:
        \badcode
        if (\1.strictlyEquals(\2))
        \endcode
    \li Select \uicontrol Replace to replace all instances of the text.
    \endlist

    \sa {Edit code}{How to: Edit code}, {Search}{How to: Search}, {Editing code}
*/

/*!
    \page creator-how-to-preview-images.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-edit
    \ingroup creator-how-to-ui
    \ingroup creator-how-to-design

    \title Preview images

    When you hover the mouse cursor over an image reference in C++ or QML code,
    \QC shows a thumbnail preview of the image in a tooltip. This helps you
    verify that you are using the correct image without leaving the editor.

    \image {qtcreator-image-preview.webp}{Preview of an image in an QML file}

    To open the image in an external image viewer, select the file path in
    the tooltip.

    \QC shows the image preview when the image is referenced via a resource file
    (\c .qrc) or directly by its absolute file path.

    \sa {Create resource files}, {Edit code}{How to: Edit code}, {Editing code},
    {Adapt the UI}{How to: Adapt the UI}, {Adapting the UI}
*/
