Revision control
++ // Copyright (C) 2016 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
++
++ /*!
++ \example clientapp
++ \title Time Client Application
++ \examplecategory {Connectivity}
++ \ingroup qtremoteobjects-examples
++ \meta tag {remoteobjects}
++ \brief A client who holds a replica of a time object from a server and displays the time in a clock.
++
++ The Time Client Application opens a blue window with a message. When
++ you click once, it displays a clock. When you click again, two clocks,
++ then it repeats. The clock is defined in Clock.qml and uses the \c Time
++ QML-type, implemented in C++, to set the time of the clock using the time
++ on the server.
++
++ \image clientapp-example.webp
++ {Application window displaying two synchronized analog clocks}
++
++ \section1 Before Running the Time Client Application
++
++ To run this example, \l {Time Server Application} must already be running
++ on the same host as this application. It sets up a registry server and
++ hosts an instance of a subclass of the \c MinuteTimerSimpleSource class.
++ If it is not running, there will be an error message in the window.
++
++ \section1 Defining Remote Objects using a REP-file
++
++ The REP-file "timemodel.rep" in the parent directory of this application
++ is used to generate the header-files used by both applications. For this
++ application, the generated "rep_timemodel_replica.h" file defines
++ \c MinuteTimerReplica, the replica of \c MinuteTimer, and other related
++ classes.
++
++ \section1 The TimeModel Class
++
++ The \c TimeModel class in plugin.h and plugin.cpp implements the QML-type
++ \c Time. It contacts the registry server on localhost using the URL
++ "local:registry", acquires a replica, \c MinuteTimerReplica, and connects
++ to its signals. The properties are automatically updated.
++
++ \section1 The QML Types
++
++ The QML defined in "Clock.qml" draws a watch using the properties hours
++ and minutes.
++
++ The application opens a window with the contents "plugins.qml". It changes
++ between displaying different content using a Loader, cycling for each
++ click between "plugins0.qml", "plugins1.qml", and "plugins2.qml".
++
++ While "plugins0.qml" displays a blue screen with a message, the custom
++ QML-type \c Clock is used in "plugins1.qml", with the properties hours
++ and minutes set to the hour and minute properties of \c Time. The
++ "plugins2.qml" file is similar but displays two clocks.
++
++ \quotefromfile clientapp/plugins1.qml
++ \skipto /^import/
++ \printuntil
++
++ \sa {Time Server Application}
++ */