En esta página

QRemoteObjectReplica Class

Una clase que interactúa con (pero no implementa) una API de Qt en la red de objetos remotos. Más información...

Encabezado: #include <QRemoteObjectReplica>
CMake: find_package(Qt6 REQUIRED COMPONENTS RemoteObjects)
target_link_libraries(mytarget PRIVATE Qt6::RemoteObjects)
qmake: QT += remoteobjects
Heredado de: QObject
Heredado por:

QRemoteObjectDynamicReplica y QRemoteObjectRegistry

Tipos públicos

enum State { Uninitialized, Default, Valid, Suspect, SignatureMismatch }

Propiedades

Funciones públicas

bool isInitialized() const
bool isReplicaValid() const
QRemoteObjectNode *node() const
virtual void setNode(QRemoteObjectNode *node)
QRemoteObjectReplica::State state() const
bool waitForSource(int timeout = 30000)

Señales

void initialized()
void notified()
void stateChanged(QRemoteObjectReplica::State state, QRemoteObjectReplica::State oldState)

Descripción detallada

Una réplica de objeto remoto es un proxy de QObject para otro QObject (denominado «objeto fuente» ). Una vez inicializada, una réplica puede considerarse una «copia latente» del objeto fuente. Es decir, cada cambio en un Q_PROPERTY del objeto fuente, o cada señal emitida por este, se actualizará o emitirá en todos los objetos réplica. La latencia se debe a la programación de procesos por parte de cualquier sistema operativo implicado y a la latencia de la comunicación de red. Siempre que la réplica se haya inicializado y la comunicación no se interrumpa, se garantiza la recepción y el orden de los cambios.

Las propiedades ` isInitialized ` y ` state ` (y las señales correspondientes ` initialized()` y `stateChanged()`) permiten determinar el estado de una réplica.

Aunque Qt Remote Objects (QtRO) se encarga de la inicialización y la sincronización de los objetos «Replica», hay numerosos pasos que tienen lugar en segundo plano y que pueden fallar, algo que no ocurre en las aplicaciones Qt de un solo proceso. Consulte la sección «Solución de problemas» para obtener consejos sobre cómo gestionar este tipo de incidencias al utilizar una red de objetos remotos.

Documentación sobre tipos de miembros

enum QRemoteObjectReplica::State

Este tipo de enumeración especifica los distintos códigos de estado asociados a los estados de QRemoteObjectReplica:

ConstanteValorDescripción
QRemoteObjectReplica::Uninitialized0Valor inicial de DynamicReplica, en el que no se sabe nada sobre la réplica antes de la conexión con la fuente.
QRemoteObjectReplica::Default1Valor inicial de la réplica estática, en el que están disponibles los valores predeterminados establecidos en el archivo .rep, de modo que se pueden utilizar si es necesario.
QRemoteObjectReplica::Valid2Indica que la réplica está conectada, tiene valores de propiedad válidos y se puede interactuar con ella.
QRemoteObjectReplica::Suspect3Estado de error que se produce si se pierde la conexión con la fuente tras su inicialización.
QRemoteObjectReplica::SignatureMismatch4Estado de error que se produce si se establece una conexión con la fuente, pero la fuente y la réplica no se derivan del mismo archivo .rep (solo es posible en el caso de réplicas estáticas).

Documentación de propiedades

node : QRemoteObjectNode*

Esta propiedad contiene un puntero al nodo del que se obtuvo este objeto.

Funciones de acceso:

QRemoteObjectNode *node() const
virtual void setNode(QRemoteObjectNode *node)

[read-only] state : State

Devuelve el estado de la réplica.

Esta propiedad contiene el QRemoteObjectReplica::State de la réplica.

Funciones de acceso:

QRemoteObjectReplica::State state() const

Señal del notificador:

void stateChanged(QRemoteObjectReplica::State state, QRemoteObjectReplica::State oldState)

Documentación de las funciones de miembro

[signal] void QRemoteObjectReplica::initialized()

Esta señal se emite una vez que se ha inicializado la réplica. Una réplica inicializada tiene todos los valores de las propiedades establecidos, pero aún no ha emitido ninguna notificación de cambio de propiedad.

Véase también isInitialized() y stateChanged().

bool QRemoteObjectReplica::isInitialized() const

Devuelve « true » si esta réplica se ha inicializado con datos del objeto «Source ». En caso contrario, devuelve « false ».

Véase también state().

bool QRemoteObjectReplica::isReplicaValid() const

Devuelve « true » si esta réplica se ha inicializado y tiene una conexión válida con el servidor « node » que aloja la fuente. En caso contrario, devuelve « false ».

Véase también isInitialized().

[signal] void QRemoteObjectReplica::notified()

Esta señal se emite una vez que se ha inicializado la réplica y se han emitido todas las notificaciones de cambio de propiedad.

A veces resulta útil responder a los cambios de propiedades como si fueran eventos. Por ejemplo, es posible que quieras mostrar una notificación al usuario cuando se produzca un determinado cambio de propiedad. Sin embargo, esta notificación al usuario también se activaría cuando una réplica pasara por primera vez a ser « QRemoteObjectReplica::Valid », ya que todas las señales de cambio de propiedad se emiten en ese momento. Esto no siempre es deseable, y notified permite al desarrollador distinguir entre estos dos casos.

QRemoteObjectReplica::State QRemoteObjectReplica::state() const

Devuelve el estado actual de la réplica ( state ).

Nota: Funcióngetter para la propiedad «state».

Véase también « isInitialized ».

[signal] void QRemoteObjectReplica::stateChanged(QRemoteObjectReplica::State state, QRemoteObjectReplica::State oldState)

Esta señal se emite cada vez que el estado de una réplica cambia entre QRemoteObjectReplica::State.

El cambio de estado se representa con « state » y « oldState ».

Nota: Señalde notificador para la propiedad « state ».

Véase también state() y initialized().

bool QRemoteObjectReplica::waitForSource(int timeout = 30000)

Llamada bloqueante que espera a que la réplica se inicialice o hasta que expire el tiempo de espera de « timeout » (en ms). Devuelve « true » si la réplica está inicializada cuando finaliza la llamada; en caso contrario, devuelve « false ».

Si timeout es -1, esta función no agotará el tiempo de espera.

Véanse también isInitialized() y initialized().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.