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

/*!
    \page creator-qtquickdesigner-plugin.html
    \previouspage creator-reference.html

    \ingroup creator-reference-ui-design

    \title \QMLD

    \brief A visual editor for QML files (.qml) and \QDS UI files (.ui.qml).

    Use wizards to create Qt Quick projects that have boiler-plate code. Change
    the code in the \uicontrol Edit mode or use a separate visual editor,
    \l{\QDS documentation}{\QDS} to open and edit \l{UI files}
    (\c .ui.qml).

    Don't edit UI files in the \uicontrol Edit mode because it is easy
    to add code that \QDS does not support.

    \section1 Opening Files in \QDS

    If you installed \QDS with \QOI, and open a \c .ui.qml or a \c .qml file in \QC, it
    asks you whether you would like to open the file in \QDS instead. Select
    \uicontrol {Open in \QDS} to open the file in \QDS.

    To hide the question, select \uicontrol {Do Not Show Again}.

    To continue editing the file in \QC, close the message.

    To open the UI file in \QDS later, select \uicontrol {QDS} on the editor
    toolbar.

    \image {qtcreator-editor-toolbar-qml.webp} {Editor toolbar for a QML UI file}

    \section2 Setting the Path to \QDS

    If you installed \QDS using some other method than \QOI, set the path to the
    \QDS installation directory in \preferences > \uicontrol {Qt Quick} >
    \uicontrol {QML/JS Editing} > \uicontrol {\QDS}.

    \image {qtcreator-qml-js-editing.webp} {QML/JS Editing tab in Qt Quick preferences}

    To use \QOI to install \QDS, select \uicontrol {Install \QDS}.

    \section1 Editing Files in \QMLD

    Enable the \QMLD plugin in \QC for editing UI files. The functionality is
    restricted and not all \QDS features are supported.

    To use \QMLD, switch to the \uicontrol Design mode when a \c ui.qml or \c .qml
    file is open.

    \image {qtquick-designer.webp} {Qt Quick Designer}

    For more information about \l{Qt Qml}, \l{Qt Quick}, and \l{All QML Types}
    {QML types}, see the Qt reference documentation available online and
    in the \uicontrol Help mode.

    For more information about using \QMLD, see \l{\QDS documentation}.

    \sa {Create Qt Quick Applications}, {Create Qt Quick UI Prototypes},
    {Enable and disable plugins}
*/
