En esta página

El sistema de tipos de Qt D-Bus

D-Bus cuenta con un sistema de tipos extensible basado en unos pocos tipos primitivos y en la composición de dichos tipos primitivos en matrices y estructuras. Qt D-Bus implementa la interfaz para ese sistema de tipos a través de la clase ` QDBusArgument `, lo que permite a los programas de usuario enviar y recibir prácticamente cualquier tipo de C++ a través del bus.

Tipos primitivos

QDBusArgument admite de forma nativa los tipos primitivos, que no requieren ninguna personalización especial para su envío o recepción. A continuación se enumeran, junto con la clase de C++ a la que corresponden:

Tipo QtTipo equivalente en D-Bus
ucharBYTE
boolBOOLEANO
shortINT16
ushortUINT16
intINT32
uintUINT32
qlonglongINT64
qulonglongUINT64
doubleDOUBLE
QStringSTRING
QDBusVariantVARIANT
QDBusObjectPathOBJECT_PATH
QDBusSignatureFIRMA

Además de los tipos primitivos, QDBusArgument también admite de forma nativa dos tipos no primitivos, debido a su uso generalizado en las aplicaciones Qt: QStringList y QByteArray.

Tipos compuestos

D-Bus especifica tres tipos de agregaciones de tipos primitivos que permiten crear tipos compuestos. Son ARRAY, STRUCT y los mapas o diccionarios.

Las matrices son conjuntos de cero o más elementos del mismo tipo, mientras que las estructuras son conjuntos de un número fijo de elementos, cada uno de cualquier tipo. Los mapas o diccionarios se implementan como matrices de pares de elementos, por lo que puede haber cero o más elementos en un mapa.

Ampliación del sistema de tipos

Para poder utilizar un tipo propio con Qt D-Bus, dicho tipo debe declararse como un metatipo de Qt mediante la macro Q_DECLARE_METATYPE() y registrarse con la función qDBusRegisterMetaType(). El sistema de registro detectará automáticamente los operadores de streaming operator>> y operator<<.

Qt D-Bus Proporciona especializaciones de plantillas para matrices y mapas destinadas a su uso con las clases contenedoras de Qt, como QMap y QList, por lo que no es necesario escribir las funciones de los operadores de streaming para ellas. Para las estructuras, Qt proporciona especializaciones genéricas que se asignan a y desde std::tuple. Para utilizar un tipo personalizado en su lugar o para otros tipos, los operadores deben implementarse explícitamente.

Consulta la documentación de QDBusArgument para ver ejemplos de estructuras, matrices y mapas.

El sistema de tipos en uso

Todos los tipos de Qt D-Bus (tanto primitivos como definidos por el usuario) pueden utilizarse para enviar y recibir mensajes de cualquier tipo a través del bus.

Advertencia: Nose debe utilizar ningún tipo que no figure en la lista anterior, ni siquiera « typedefs » a los tipos enumerados. Esto incluye también QList<QVariant> y QMap<QString,QVariant>.

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