QRemoteObjectReplica露

PyQt5.QtRemoteObjects.QRemoteObjectReplica

Inherits from QObject.

Inherited by QRemoteObjectDynamicReplica, QRemoteObjectRegistry.

Description露

A class interacting with (but not implementing) a Qt API on the Remote Object network.

A Remote Object Replica is a QObject proxy for another QObject (called the Source object). Once initialized, a replica can be considered a 鈥渓atent copy鈥 of the Source object. That is, every change to a Q_PROPERTY on the Source, or signal emitted by the Source will be updated/emitted by all Replica objects. Latency is introduced by process scheduling by any OSes involved and network communication latency. As long as the replica has been initialized and the communication is not disrupted, receipt and order of changes is guaranteed.

The isInitialized() and state() properties (and corresponding initialized/stateChanged signals) allow the state of a Replica to be determined.

While Qt Remote Objects (QtRO) handles the initialization and synchronization of Replica objects, there are numerous steps happening behind the scenes which can fail and that aren鈥檛 encountered in single process Qt applications. See Troubleshooting for advice on how to handle such issues when using a remote objects network.

Enums露

State

This enum type specifies the various state codes associated with QRemoteObjectReplica states:

Member

Value

Description
Default

1

initial value of static replica, where any defaults set in the .rep file are available so it can be used if necessary.
SignatureMismatch

4

error state that occurs if a connection to the source is made, but the source and replica are not derived from the same .rep (only possible for static Replicas).
Suspect

3

error state that occurs if the connection to the source is lost after it is initialized.
Uninitialized

0

initial value of DynamicReplica, where nothing is known about the replica before connection to source.
Valid

2

indicates the replica is connected, has good property values and can be interacted with.

Methods露

isInitialized() → bool

TODO

isReplicaValid() → bool

TODO

node() → QRemoteObjectNode

See also

setNode().

setNode(QRemoteObjectNode)

See also

node().

state() → State

TODO

waitForSource(timeout: int = 30000) → bool

TODO

Signals露

initialized()

TODO

stateChanged(State, State)

TODO