QNdefRecord Class
La clase QNdefRecord proporciona un registro NFC NDEF. Más información...
| Encabezado: | #include <QNdefRecord> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Nfc) target_link_libraries(mytarget PRIVATE Qt6::Nfc) |
| qmake: | QT += nfc |
| Heredado por: | QNdefNfcIconRecord, QNdefNfcSmartPosterRecord, QNdefNfcTextRecord y QNdefNfcUriRecord |
Tipos públicos
| enum | TypeNameFormat { Empty, NfcRtd, Mime, Uri, ExternalRtd, Unknown } |
Funciones públicas
| QNdefRecord() | |
| QNdefRecord(const QNdefRecord &other) | |
| ~QNdefRecord() | |
(since 6.2) void | clear() |
| QByteArray | id() const |
| bool | isEmpty() const |
| bool | isRecordType() const |
| QByteArray | payload() const |
| void | setId(const QByteArray &id) |
| void | setPayload(const QByteArray &payload) |
| void | setType(const QByteArray &type) |
| void | setTypeNameFormat(QNdefRecord::TypeNameFormat typeNameFormat) |
| QByteArray | type() const |
| QNdefRecord::TypeNameFormat | typeNameFormat() const |
| bool | operator!=(const QNdefRecord &other) const |
| QNdefRecord & | operator=(const QNdefRecord &other) |
| bool | operator==(const QNdefRecord &other) const |
Macros
| Q_DECLARE_ISRECORDTYPE_FOR_NDEF_RECORD(className, typeNameFormat, type) | |
| Q_DECLARE_NDEF_RECORD(className, typeNameFormat, type, initialPayload) |
Descripción detallada
QNdefRecord y sus clases derivadas se utilizan para analizar el contenido de un archivo « NDEF messages » y crear nuevos mensajes NDEF.
Utiliza typeNameFormat() y setTypeNameFormat() para obtener y establecer el formato del nombre del tipo del registro NDEF.
Utilice type() y setType() para obtener y establecer el tipo del registro NDEF.
Utiliza id() y setId() para obtener y establecer el identificador del registro NDEF.
Utiliza payload() y setPayload() para obtener y establecer la carga útil del registro NDEF. Se puede utilizar isEmpty() para comprobar si la carga útil está vacía.
QNdefRecord es una clase compartida implícitamente. Esto significa que se puede realizar una conversión eficiente entre QNdefRecord y clases de registros especializadas. La función de plantilla isRecordType() se puede utilizar para comprobar si una conversión es posible. El siguiente ejemplo muestra cómo comprobar si un QNdefRecord es un registro de texto NFC RTD y extraer la información de texto del mismo.
if (record.isRecordType<QNdefNfcTextRecord>()) {
QNdefNfcTextRecord textRecord(record);
qDebug() << textRecord.text();
}Creación de clases de registros NDEF especializadas
Las clases de registros NDEF especializadas se pueden crear fácilmente con las macros Q_DECLARE_NDEF_RECORD() y Q_DECLARE_ISRECORDTYPE_FOR_NDEF_RECORD(). El siguiente ejemplo muestra la declaración de clase del tipo de registro hipotético example.com:f, que encapsula una única propiedad de tipo int denominada foo.
class ExampleComF : public QNdefRecord
{
public:
Q_DECLARE_NDEF_RECORD(ExampleComF, QNdefRecord::ExternalRtd, "example.com:f",
QByteArray(sizeof(int), char(0)))
int foo() const;
void setFoo(int v);
};
Q_DECLARE_ISRECORDTYPE_FOR_NDEF_RECORD(ExampleComF, QNdefRecord::ExternalRtd, "example.com:f")El desarrollador solo tiene que proporcionar implementaciones para las funciones foo() y setFoo(), que analizan y establecen el contenido de la carga útil del registro NDEF.
Documentación sobre los tipos de miembro
enum QNdefRecord::TypeNameFormat
Esta enumeración describe el formato del nombre de tipo de un registro NDEF.
| Constante | Valor | Descripción |
|---|---|---|
QNdefRecord::Empty | 0x00 | Un registro NDEF vacío; el registro no contiene carga útil |
QNdefRecord::NfcRtd | 0x01 | El tipo de registro NDEF viene definido por una especificación RTD de NFC |
QNdefRecord::Mime | 0x02 | El tipo de registro NDEF sigue la estructura descrita en la RFC 2046 |
QNdefRecord::Uri | 0x03 | El tipo de registro NDEF sigue la estructura descrita en el RFC 3986 |
QNdefRecord::ExternalRtd | 0x04 | El tipo de registro NDEF sigue la estructura para nombres de tipos externos descrita en la especificación NFC RTD |
QNdefRecord::Unknown | 0x05 | Se desconoce el tipo del registro y debe tratarse de forma similar al contenido con tipo MIME «application/octet-stream» sin más contexto |
Documentación de las funciones miembro
QNdefRecord::QNdefRecord()
Crea un nuevo registro NDEF vacío.
QNdefRecord::QNdefRecord(const QNdefRecord &other)
Crea un nuevo registro NDEF que es una copia de other.
[noexcept] QNdefRecord::~QNdefRecord()
Elimina el registro NDEF.
[since 6.2] void QNdefRecord::clear()
Borrar el registro NDEF.
Una llamada a ` isEmpty()` devuelve ` true ` para un registro borrado. El registro ` type()` se establece en ` Empty`.
Esta función se introdujo en Qt 6.2.
QByteArray QNdefRecord::id() const
Devuelve el identificador del registro NDEF.
Véase también setId().
bool QNdefRecord::isEmpty() const
Devuelve « true » si el registro NDEF contiene una carga útil vacía; en caso contrario, devuelve « false ».
Esto equivale a llamar a payload().isEmpty().
template <typename T> bool QNdefRecord::isRecordType() const
Devuelve ` true ` si el registro NDEF es del tipo especificado; en caso contrario, devuelve ` false`.
QByteArray QNdefRecord::payload() const
Devuelve la carga útil del registro NDEF.
Véase también setPayload().
void QNdefRecord::setId(const QByteArray &id)
Establece el identificador del registro NDEF en id.
Véase también id().
void QNdefRecord::setPayload(const QByteArray &payload)
Establece la carga útil del registro NDEF en payload.
Véase también payload().
void QNdefRecord::setType(const QByteArray &type)
Establece el tipo del registro NDEF como « type ».
Véase también type().
void QNdefRecord::setTypeNameFormat(QNdefRecord::TypeNameFormat typeNameFormat)
Establece el formato del nombre del tipo del registro NDEF en « typeNameFormat ».
Véase también typeNameFormat().
QByteArray QNdefRecord::type() const
Devuelve el tipo del registro NDEF.
Véase también setType().
QNdefRecord::TypeNameFormat QNdefRecord::typeNameFormat() const
Devuelve el formato del nombre del tipo del registro NDEF.
Véase también setTypeNameFormat().
bool QNdefRecord::operator!=(const QNdefRecord &other) const
Devuelve « true » si este registro NDEF no es igual a « other »; en caso contrario, devuelve « false ».
QNdefRecord &QNdefRecord::operator=(const QNdefRecord &other)
Asigna este registro NDEF a other.
bool QNdefRecord::operator==(const QNdefRecord &other) const
Devuelve ` true ` si ` other ` y este registro NDEF son iguales. En caso contrario, devuelve ` false`.
Documentación de macros
Q_DECLARE_ISRECORDTYPE_FOR_NDEF_RECORD(className, typeNameFormat, type)
Esta macro declara una especialización de plantilla para la función ` QNdefRecord::isRecordType()`.
Esta macro debe utilizarse en el archivo de cabecera inmediatamente después de la definición de una clase de registro NDEF especializada.
className es el nombre de la clase especializada, typeNameFormat es el QNdefRecord::TypeNameFormat adecuado para el tipo personalizado y type es el tipo sin los prefijos NID ni NSS. Es decir, example.com:f, no urn:nfc:ext:example.com:f.
Consulte la sección sobre Creating specialized NDEF record classes para obtener más detalles.
Véase también Q_DECLARE_NDEF_RECORD().
Q_DECLARE_NDEF_RECORD(className, typeNameFormat, type, initialPayload)
Esta macro declara constructores por defecto y de copia para clases de registros NDEF especializadas.
className « typeNameFormat » es el nombre de la clase especializada, « » es el « QNdefRecord::TypeNameFormat » adecuado para el tipo personalizado y « type » es el tipo sin los prefijos NID ni NSS. Es decir, example.com:f, no urn:nfc:ext:example.com:f. initialPayload es la carga útil inicial de un registro vacío; debe ser un QByteArray o un tipo que pueda convertirse implícitamente en un QByteArray.
Consulte la sección sobre Creating specialized NDEF record classes para obtener más detalles.
Véase también Q_DECLARE_ISRECORDTYPE_FOR_NDEF_RECORD().
© 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.