Revision control
Copy as Markdown
// 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}
*/