summaryrefslogtreecommitdiffstats
path: root/examples/webenginequick/minimal/doc/src/minimal.qdoc
blob: aed74a7f5b11dadb5f345ffe50c3ebd341fed924 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \example webenginequick/minimal
    \title WebEngine Qt Quick Minimal Example
    \ingroup webengine-examples
    \brief Displays a web page using the Qt Quick integration of \QWE.

    \image minimal-example.png

    \e {WebEngine Qt Quick Minimal Example} demonstrates how to use the
    \l{WebEngineView} item to render a web page. It shows the minimum amount of
    code needed to load and display an HTML page, and can be used as a basis for
    further experimentation.

    \include examples-run.qdocinc

    \section1 C++ Code

    In \c main.cpp we use only the QGuiApplication and QQmlApplicationEngine
    classes. We also include \c qtwebengineglobal.h to be able to use
    \l{QtWebEngineQuick::initialize}.

    \quotefromfile webenginequick/minimal/main.cpp
    \skipto #include
    \printto main

    In the \c main function we first set the
    \l{QCoreApplication::organizationName} property. This affects the locations
    where \QWE stores persistent and cached data (see also
    \l{WebEngineProfile::cachePath} and
    \l{WebEngineProfile::persistentStoragePath}).

    Next, we call \l{QtWebEngineQuick::initialize}, which makes sure that OpenGL
    contexts can be shared between the main process and the dedicated renderer
    process (\c QtWebEngineProcess). This method needs to be called before
    any OpenGL context is created.

    Then we create a QQmlApplicationEngine, and tell it to load \c main.qml
    from the \l{The Qt Resource System}{Qt Resource System}.

    Finally, QGuiApplication::exec() launches the main event loop.

    \printuntil }

    \section1 QML Code

    In \c main.qml we create the top level window, set a sensible default size
    and make it visible. The window will be filled by a WebEngineView item
    loading the \l{Qt Homepage}.

    \quotefromfile webenginequick/minimal/main.qml
    \skipto import
    \printuntil }
    \printline }

    \section1 Requirements

    The example requires a working internet connection to render the
    \l{Qt Homepage}.
    An optional system proxy should be picked up automatically.
*/