En esta página

QProtobufMessage Class

Clase base para todos los mensajes de Protobuf. Más información...

Cabecera: #include <QProtobufMessage>
CMake: find_package(Qt6 REQUIRED COMPONENTS Protobuf)
target_link_libraries(mytarget PRIVATE Qt6::Protobuf)
Desde: Qt 6.5
Heredado por:

QtProtobuf::Any

Funciones públicas

(since 6.8) bool deserialize(QAbstractProtobufSerializer *serializer, QByteArrayView data)
QVariant property(QAnyStringView propertyName) const
(since 6.8) const QtProtobufPrivate::QProtobufPropertyOrdering *propertyOrdering() const
(since 6.8) QByteArray serialize(QAbstractProtobufSerializer *serializer) const
bool setProperty(QAnyStringView propertyName, const QVariant &value)
(since 6.6) bool setProperty(QAnyStringView propertyName, QVariant &&value)
(since 6.7) QList<QByteArray> unknownFieldData(qint32 field) const
(since 6.7) QList<qint32> unknownFieldNumbers() const

Miembros públicos estáticos

QProtobufMessagePointer constructByName(const QString &messageType)

Funciones protegidas

QProtobufMessage(QProtobufMessage &&other)
QProtobufMessagePointer
(since 6.11) To qprotobufmessage_cast(QProtobufMessage *from)
(since 6.11) To qprotobufmessage_cast(const QProtobufMessage *from)

Descripción detallada

Proporciona acceso a las propiedades de un mensaje, utilizando setProperty() y property(), sin depender del tipo de mensaje.

Documentación de las funciones de miembro

[constexpr noexcept protected default] QProtobufMessage::QProtobufMessage(QProtobufMessage &&other)

Crea una instancia de ` QProtobufMessage` mediante la construcción «move».

[static] QProtobufMessagePointer QProtobufMessage::constructByName(const QString &messageType)

Crea un objeto ` QProtobufMessage ` utilizando ` messageType`. Devuelve un puntero al objeto creado ` QProtobufMessage`.

Esta función intenta crear un mensaje con un tipo que coincida con messageType. Si messageType es desconocido, la función devuelve nullptr. Si el mensaje no se encuentra en el registro, la función devuelve nullptr. Se otorga al autor de la llamada la propiedad del mensaje creado.

[since 6.8] bool QProtobufMessage::deserialize(QAbstractProtobufSerializer *serializer, QByteArrayView data)

Deserializa este mensaje Protobuf a partir de un ` QByteArray ` data utilizando serializer. Devuelve ` true ` si la deserialización se ha realizado correctamente; en caso contrario, devuelve ` false`.

Esta función se introdujo en Qt 6.8.

Véase también serialize().

QVariant QProtobufMessage::property(QAnyStringView propertyName) const

Obtén el valor de la propiedad « propertyName ».

Si no se conoce el valor de ` propertyName `, el valor devuelto ` QVariant ` no es válido.

Véase también setProperty().

[since 6.8] const QtProtobufPrivate::QProtobufPropertyOrdering *QProtobufMessage::propertyOrdering() const

Devuelve el puntero al orden de las propiedades del mensaje Protobuf derivado.

Esta función se introdujo en Qt 6.8.

[since 6.8] QByteArray QProtobufMessage::serialize(QAbstractProtobufSerializer *serializer) const

Serializa este mensaje protobuf en un objeto ` QByteArray ` utilizando ` serializer`.

Esta función se introdujo en Qt 6.8.

Véase también deserialize().

bool QProtobufMessage::setProperty(QAnyStringView propertyName, const QVariant &value)

Establece la propiedad « propertyName » con el valor almacenado en « value ».

Si « propertyName » no es un campo conocido, se ignora el valor y la función devuelve « false ».

Devuelve ` false ` si no se consigue almacenar ` value ` en la propiedad. En caso contrario, devuelve ` true`.

Véase también ` property()`.

[since 6.6] bool QProtobufMessage::setProperty(QAnyStringView propertyName, QVariant &&value)

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.6.

[since 6.7] QList<QByteArray> QProtobufMessage::unknownFieldData(qint32 field) const

Devuelve los valores desconocidos de « field » ordenados tal y como se recibieron por la red.

Esta función se introdujo en Qt 6.7.

[since 6.7] QList<qint32> QProtobufMessage::unknownFieldNumbers() const

Devuelve los números de campo que QtProtobuf no conocía durante la deserialización.

Esta función se introdujo en Qt 6.7.

Elementos no miembros relacionados

[alias] QProtobufMessagePointer

Sinónimo de std::unique_ptr<QProtobufMessage, QProtobufMessageDeleter>. Utilízalo para gestionar el ciclo de vida de los objetos QProtobufMessage asignados dinámicamente, como los creados al llamar a QProtobufMessage::constructByName.

[since 6.11] template <typename To> To qprotobufmessage_cast(QProtobufMessage *from)

[since 6.11] template <typename To> To qprotobufmessage_cast(const QProtobufMessage *from)

Devuelve el objeto ` from ` dado, convertido al tipo de puntero ` To ` si el objeto es de tipo ` To ` (o una subclase); en caso contrario, devuelve ` nullptr`. Si ` from ` es ` nullptr`, esta función también devuelve ` nullptr`.

El argumento de plantilla ` To ` debe ser un puntero a una clase que herede de ` QProtobufMessage ` y esté declarada con la macro ` Q_PROTOBUF_OBJECT `.

Ejemplo:

QProtobufMessage *message = new myproject::MySpecificMessage();

// Cast to its own type (success)
auto *specific = qprotobufmessage_cast<myproject::MySpecificMessage *>(message);
// specific is a valid pointer

// Cast to an unrelated type (failure)
auto *another = qprotobufmessage_cast<myproject::AnotherMessage *>(message);
// another is nullptr

Esta función se comporta de forma similar a la función estándar de C++ ` dynamic_cast()`, con la ventaja de que no requiere compatibilidad con RTTI y funciona más allá de los límites de las bibliotecas dinámicas.

Advertencia: Si el tipo al que apunta ` To ` no está declarado con la macro ` Q_PROTOBUF_OBJECT `, el valor de retorno de esta función es indefinido.

Estas funciones se introdujeron en Qt 6.11.

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