En esta página

QDBusAbstractAdaptor Class

La clase `QDBusAbstractAdaptor` es la clase base de las clases de adaptadores de D-Bus. Más información...

Encabezado: #include <QDBusAbstractAdaptor>
CMake: find_package(Qt6 REQUIRED COMPONENTS DBus)
target_link_libraries(mytarget PRIVATE Qt6::DBus)
qmake: QT += dbus
Heredado de: QObject

Funciones públicas

Funciones protegidas

QDBusAbstractAdaptor(QObject *obj)
bool autoRelaySignals() const
void setAutoRelaySignals(bool enable)

Macros

Descripción detallada

La clase `QDBusAbstractAdaptor` es el punto de partida para todos los objetos que pretenden proporcionar interfaces al mundo exterior mediante D-Bus. Esto se consigue asociando una o más clases derivadas de `QDBusAbstractAdaptor` a un ` QObject ` normal y, a continuación, registrando ese ` QObject ` con ` QDBusConnection::registerObject`. Los objetos `QDBusAbstractAdaptor` están pensados para ser envoltorios ligeros, que en su mayoría se limitan a retransmitir las llamadas al objeto real (su padre) y las señales procedentes de este.

Cada clase derivada de `QDBusAbstractAdaptor` debe definir la interfaz D-Bus que está implementando utilizando la macro ` Q_CLASSINFO ` en la definición de la clase. Ten en cuenta que solo se puede exponer una interfaz de esta manera.

QDBusAbstractAdaptor utiliza el mecanismo estándar de QObject de señales, ranuras y propiedades para determinar qué señales, métodos y propiedades se deben exportar al bus. Cualquier señal emitida por clases derivadas de QDBusAbstractAdaptor se retransmitirá automáticamente a través de cualquier conexión D-Bus en la que el objeto esté registrado.

Las clases derivadas de `QDBusAbstractAdaptor` deben crearse en el montón mediante el operador ` new ` y el usuario no debe eliminarlas (se eliminarán automáticamente cuando también se elimine el objeto al que están conectadas).

Véase también Uso de adaptadores y QDBusConnection.

Documentación de las funciones miembro

[explicit protected] QDBusAbstractAdaptor::QDBusAbstractAdaptor(QObject *obj)

Crea un objeto `QDBusAbstractAdaptor` con ` obj ` como objeto padre.

[virtual noexcept] QDBusAbstractAdaptor::~QDBusAbstractAdaptor()

Destruye el adaptador.

Advertencia: Los adaptadores se destruyen automáticamente cuando se destruye el objeto real al que hacen referencia. No elimines los adaptadores tú mismo.

[protected] bool QDBusAbstractAdaptor::autoRelaySignals() const

Devuelve « true » si está habilitada la transmisión automática de señales desde el objeto real (véase object()); en caso contrario, devuelve « false ».

Véase también setAutoRelaySignals().

[protected] void QDBusAbstractAdaptor::setAutoRelaySignals(bool enable)

Activa o desactiva la retransmisión automática de señales desde el objeto real (véase object()).

La retransmisión automática de señales consiste en la conexión entre señales del objeto padre que tienen exactamente la misma firma de método en ambas clases.

Si enable se establece en true, se conectan las señales; si se establece en false, se desconectan todas las señales.

Véase también autoRelaySignals().

Documentación de macros

Q_NOREPLY

La macro Q_NOREPLY se puede utilizar para indicar que se llame a un método sin esperar a que finalice su procesamiento antes de salir de QDBusInterface::call(). El método llamado no puede devolver ningún argumento de salida y, si lo hace, dichos argumentos se descartarán.

Puedes utilizar esta macro en tus propios adaptadores colocándola antes del valor de retorno de tu método (que debe ser «void») en la declaración de la clase, tal y como se muestra en el ejemplo:

Q_NOREPLY void myMethod();

Su presencia en la implementación del método (fuera de la declaración de la clase) es opcional.

Véase también «Uso deadaptadores Qt D-Bus ».

© 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.