Qt 5.11 | Qt WebEngine | Qt WebEngine Widgets Examples | WebEngine Widgets Minimal Example

Qt 5.11.3 Reference Documentation

# WebEngine Widgets Minimal Example

Displays a web page using Qt WebEngine Widgets.

WebEngine Widgets Minimal Example demonstrates how to use QWebEngineView 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.

## Running the Example

To run the example from Qt Creator, open the Welcome mode and select the example from Examples. For more information, visit Building and Running an Example.

## The Code

In the `main` function we first set the Qt::AA_EnableHighDpiScaling. This lets the web view automatically scale on high-dpi displays.

Next, we instantiate a QApplication and a QWebEngineView. The URL to load is taken from the command-line in `commandLineUrlArgument` and loaded by calling QWebEngineView::setUrl. The view widget is given a reasonable default size, and shown. Finally, QApplication::exec() launches the main event loop.

      #include <QApplication>
      #include <QWebEngineView>

      QUrl commandLineUrlArgument()
      {
          const QStringList args = QCoreApplication::arguments();
          for (const QString &arg : args.mid(1)) {
              if (!arg.startsWith(QLatin1Char('-')))
                  return QUrl::fromUserInput(arg);
          }

## Requirements

The example requires a working internet connection to render the Qt Homepage. An optional system proxy should be picked up automatically. However, for proxies that require a username or password, you need to connect to QWebEnginePage::proxyAuthenticationRequired.

Qt WebEngine Widgets uses the Qt Quick Scene Graph to compose the page. Therefore, OpenGL support is required.

Files:

- webenginewidgets/minimal/main.cpp
- webenginewidgets/minimal/minimal.pro