/****************************************************************************
**
** Copyright (C) 2021 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Creator documentation.
**
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
**
****************************************************************************/

/*!
    \page qtquick-iso-icon-browser.html
    \previouspage studio-3d-scene-environment.html
    \nextpage quick-converting-ui-projects.html

    \title Browsing ISO 7000 Icons

    \commercial

    You can add icons from an ISO 7000 icon library that is installed with \QC
    to Qt Quick applications (commercial only). You can use the
    \uicontrol {ISO Icon Browser} to add a \l {Picture} component and select the
    icon to use for the component. You can change the default color of the icon.

    \image qtcreator-iso-icon-browser.png

    \section1 Using ISO Icons in Applications

    \list 1

        \li Create a new Qt Quick Application or open an application in \QC.

        \li Open the \l{UI Files}{UI file} (.ui.qml) in \l {Form Editor}.

        \li Select \l Library > \uicontrol Components > \inlineimage plus.png
            > \uicontrol {QtQuick.Extras} to import the \l {Qt Quick Extras}
            module.

        \li Drag and drop a \uicontrol Picture component from \uicontrol Library
            to \l {Form Editor}.

        \li Right-click the picture component and select \uicontrol {Choose Icon}
            to open the \uicontrol {ISO Icon Browser}.

        \li To find icons, select a criterion for filtering icons and enter a
            search string.

        \li Select an icon in the list, and then select \uicontrol OK to add
            the icon.

        \li To view the icon you added, press \key {Ctrl+R} (or \key {Cmd+R})
            to run the application.

        \li To adjust the icon color, select the icon on the canvas, and then
            select \uicontrol {Edit Color} in the context menu.

    \endlist

    \QC generates a Qt resource file called \c iso-icons.qrc that adds the
    icons as a part of your project for delivery with your application.

    */
