QDBusServiceWatcher Class

Documentación de funciones miembro

[explicit] QDBusServiceWatcher::QDBusServiceWatcher(QObject *parent = nullptr)

Crea un objeto QDBusServiceWatcher. Ten en cuenta que hasta que no establezcas una conexión con setConnection(), este objeto no emitirá ninguna señal.

El parámetro parent se pasa a QObject para establecer el padre de este objeto.

QDBusServiceWatcher::QDBusServiceWatcher(const QString &service, const QDBusConnection &connection, QDBusServiceWatcher::WatchMode watchMode = WatchForOwnerChange, QObject *parent = nullptr)

Crea un objeto QDBusServiceWatcher y lo adjunta a la conexión connection. Además, esta función comienza inmediatamente a vigilar los cambios de watchMode en el servicio service.

El parámetro parent se pasa a QObject para establecer el padre de este objeto.

[virtual noexcept] QDBusServiceWatcher::~QDBusServiceWatcher()

Destruye el objeto QDBusServiceWatcher y libera los recursos asociados a él.

void QDBusServiceWatcher::addWatchedService(const QString &newService)

Añade newService a la lista de servicios a vigilar por este objeto. Esta función es más eficiente que setWatchedServices() y debería utilizarse siempre que sea posible para añadir servicios.

Elimina cualquier vinculación existente de watchedServices.

QDBusConnection QDBusServiceWatcher::connection() const

Devuelve el QDBusConnection al que está unido este objeto.

Véase también setConnection().

bool QDBusServiceWatcher::removeWatchedService(const QString &service)

Elimina el service de la lista de servicios vigilados por este objeto. Ten en cuenta que las notificaciones D-Bus son asíncronas, por lo que aún puede haber señales pendientes de entrega sobre service. Estas señales seguirán emitiéndose cuando se procesen los mensajes D-Bus.

Elimina cualquier vinculación existente de watchedServices.

Esta función devuelve true si se ha eliminado algún servicio.

[signal] void QDBusServiceWatcher::serviceOwnerChanged(const QString &serviceName, const QString &oldOwner, const QString &newOwner)

Esta señal se emite siempre que este objeto detecta que se ha producido un cambio de propietario en relación con el servicio serviceName. El parámetro oldOwner contiene el nombre del antiguo propietario y newOwner es el nuevo propietario. Tanto oldOwner como newOwner son nombres de conexión únicos.

Ten en cuenta que esta señal también se emite cuando el servicio serviceName ha sido registrado o desregistrado. Si se registró, oldOwner contendrá una cadena vacía, mientras que si no se registró, newOwner contendrá una cadena vacía.

Si sólo necesitas saber si el servicio está registrado o no, sin que se te notifique que la propiedad ha cambiado, considera usar los modos específicos para esas operaciones. Esta clase es más eficiente si utilizas los modos más específicos.

Véase también serviceRegistered() y serviceUnregistered().

[signal] void QDBusServiceWatcher::serviceRegistered(const QString &serviceName)

Esta señal se emite siempre que este objeto detecta que el servicio serviceName está disponible en el bus.

Véase también serviceUnregistered() y serviceOwnerChanged().

[signal] void QDBusServiceWatcher::serviceUnregistered(const QString &serviceName)

Esta señal se emite siempre que este objeto detecta que el servicio serviceName se ha dado de baja del bus y ya no está disponible.

Véase también serviceRegistered() y serviceOwnerChanged().

void QDBusServiceWatcher::setConnection(const QDBusConnection &connection)

Establece la conexión D-Bus a la que está vinculado este objeto en connection. Todos los servicios observados serán transferidos a esta conexión.

Ten en cuenta que los objetos QDBusConnection se cuentan por referencia: QDBusServiceWatcher mantendrá una referencia para esta conexión mientras exista. La conexión no se cierra hasta que el recuento de referencias cae a cero, por lo que esto asegurará que cualquier notificación se reciba mientras este objeto QDBusServiceWatcher exista.

Véase también connection().

void QDBusServiceWatcher::setWatchedServices(const QStringList &services)

Establece la lista de servicios D-Bus vigilados en services.

Tenga en cuenta que establecer la lista completa significa eliminar todas las reglas anteriores para vigilar servicios y añadir otras nuevas. Esta es una operación costosa y debería evitarse, si es posible. En su lugar, utilice addWatchedService() y removeWatchedService() si puede para manipular las entradas de la lista.

Elimina cualquier vinculación existente de watchedServices.

Véase también watchedServices().

QStringList QDBusServiceWatcher::watchedServices() const

Devuelve la lista de servicios D-Bus que están siendo vigilados.

Véase también setWatchedServices().