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: |
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:
| Constante | Valor | Descripción |
|---|---|---|
QRemoteObjectReplica::Uninitialized | 0 | Valor inicial de DynamicReplica, en el que no se sabe nada sobre la réplica antes de la conexión con la fuente. |
QRemoteObjectReplica::Default | 1 | Valor 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::Valid | 2 | Indica que la réplica está conectada, tiene valores de propiedad válidos y se puede interactuar con ella. |
QRemoteObjectReplica::Suspect | 3 | Estado de error que se produce si se pierde la conexión con la fuente tras su inicialización. |
QRemoteObjectReplica::SignatureMismatch | 4 | Estado 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.