Auf dieser Seite

QLowEnergyCharacteristicData Class

Die Klasse „QLowEnergyCharacteristicData“ dient zur Einrichtung von GATT-Dienstdaten. Mehr dazu...

Header: #include <QLowEnergyCharacteristicData>
CMake: find_package(Qt6 REQUIRED COMPONENTS Bluetooth)
target_link_libraries(mytarget PRIVATE Qt6::Bluetooth)
qmake: QT += bluetooth

Öffentliche Funktionen

QLowEnergyCharacteristicData()
QLowEnergyCharacteristicData(const QLowEnergyCharacteristicData &other)
~QLowEnergyCharacteristicData()
void addDescriptor(const QLowEnergyDescriptorData &descriptor)
QList<QLowEnergyDescriptorData> descriptors() const
bool isValid() const
int maximumValueLength() const
int minimumValueLength() const
QLowEnergyCharacteristic::PropertyTypes properties() const
QBluetooth::AttAccessConstraints readConstraints() const
void setDescriptors(const QList<QLowEnergyDescriptorData> &descriptors)
void setProperties(QLowEnergyCharacteristic::PropertyTypes properties)
void setReadConstraints(QBluetooth::AttAccessConstraints constraints)
void setUuid(const QBluetoothUuid &uuid)
void setValue(const QByteArray &value)
void setValueLength(int minimum, int maximum)
void setWriteConstraints(QBluetooth::AttAccessConstraints constraints)
void swap(QLowEnergyCharacteristicData &other)
QBluetoothUuid uuid() const
QByteArray value() const
QBluetooth::AttAccessConstraints writeConstraints() const
QLowEnergyCharacteristicData &operator=(const QLowEnergyCharacteristicData &other)
bool operator!=(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)
bool operator==(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)

Ausführliche Beschreibung

Ein Objekt dieser Klasse stellt eine Eigenschaft bereit, die über die Methode „ QLowEnergyServiceData::addCharacteristic()“ einem „ QLowEnergyServiceData “-Objekt hinzugefügt werden kann.

Siehe auch „ QLowEnergyServiceData “ und „ QLowEnergyController::addService “.

Dokumentation der Mitgliedsfunktionen

QLowEnergyCharacteristicData::QLowEnergyCharacteristicData()

Erstellt ein neues ungültiges Objekt dieser Klasse.

QLowEnergyCharacteristicData::QLowEnergyCharacteristicData(const QLowEnergyCharacteristicData &other)

Erstellt ein neues Objekt dieser Klasse, das eine Kopie von ` other` ist.

[noexcept] QLowEnergyCharacteristicData::~QLowEnergyCharacteristicData()

Zerstört dieses Objekt.

void QLowEnergyCharacteristicData::addDescriptor(const QLowEnergyDescriptorData &descriptor)

Fügt „ descriptor “ zur Liste der Deskriptoren dieses Merkmals hinzu, sofern es gültig ist.

Siehe auch setDescriptors().

QList<QLowEnergyDescriptorData> QLowEnergyCharacteristicData::descriptors() const

Gibt die Deskriptoren dieses Merkmals zurück.

Siehe auch „ setDescriptors()“.

bool QLowEnergyCharacteristicData::isValid() const

Gibt genau dann „true“ zurück, wenn dieses Merkmal gültig ist, d. h., wenn es eine UUID ungleich Null aufweist.

int QLowEnergyCharacteristicData::maximumValueLength() const

Gibt die maximale Länge in Byte zurück, die der Wert dieses Merkmals haben kann. Standardmäßig gibt es keine Begrenzung über die Einschränkungen des Datentyps hinaus.

int QLowEnergyCharacteristicData::minimumValueLength() const

Gibt die minimale Länge in Byte zurück, die der Wert dieses Merkmals annehmen kann. Der Standardwert ist Null.

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristicData::properties() const

Gibt die Eigenschaften dieses Merkmals zurück.

Siehe auch „ setProperties()“.

QBluetooth::AttAccessConstraints QLowEnergyCharacteristicData::readConstraints() const

Gibt die Einschränkungen zurück, die ein Client beachten muss, um den Wert dieses Merkmals lesen zu können. Wenn properties() nicht QLowEnergyCharacteristic::Read enthält, ist dieser Wert irrelevant. Standardmäßig gibt es keine Leseeinschränkungen.

Siehe auch ` setReadConstraints()`.

void QLowEnergyCharacteristicData::setDescriptors(const QList<QLowEnergyDescriptorData> &descriptors)

Setzt die Deskriptoren dieses Merkmals auf „ descriptors “. Es werden nur gültige Deskriptoren berücksichtigt.

Siehe auch descriptors() und addDescriptor().

void QLowEnergyCharacteristicData::setProperties(QLowEnergyCharacteristic::PropertyTypes properties)

Legt die Eigenschaften dieses Merkmals auf „ properties “ fest.

Siehe auch ` properties()`.

void QLowEnergyCharacteristicData::setReadConstraints(QBluetooth::AttAccessConstraints constraints)

Gibt an, dass Clients die Anforderung „ constraints “ erfüllen müssen, um den Wert dieses Merkmals lesen zu können.

Siehe auch readConstraints().

void QLowEnergyCharacteristicData::setUuid(const QBluetoothUuid &uuid)

Setzt die UUID dieses Merkmals auf uuid.

Siehe auch uuid().

void QLowEnergyCharacteristicData::setValue(const QByteArray &value)

Setzt den Wert dieses Merkmals auf „ value “.

Siehe auch „ value()“.

void QLowEnergyCharacteristicData::setValueLength(int minimum, int maximum)

Legt fest, dass „ minimum “ und „ maximum “ jeweils die kleinste und größte Länge darstellen, die der Wert dieser Eigenschaft annehmen kann. Die Einheit ist Byte. Sind „ minimum “ und „ maximum “ gleich, hat die Eigenschaft einen Wert mit fester Länge.

void QLowEnergyCharacteristicData::setWriteConstraints(QBluetooth::AttAccessConstraints constraints)

Gibt an, dass Clients die Anforderung „ constraints “ erfüllen müssen, um den Wert dieses Merkmals zu schreiben.

Siehe auch writeConstraints().

[noexcept] void QLowEnergyCharacteristicData::swap(QLowEnergyCharacteristicData &other)

Tauscht dieses Objekt mit „ other “ aus.

QBluetoothUuid QLowEnergyCharacteristicData::uuid() const

Gibt die UUID dieses Merkmals zurück.

Siehe auch „ setUuid()“.

QByteArray QLowEnergyCharacteristicData::value() const

Gibt den Wert dieses Merkmals zurück.

Siehe auch setValue().

QBluetooth::AttAccessConstraints QLowEnergyCharacteristicData::writeConstraints() const

Gibt die Einschränkungen zurück, die ein Client beachten muss, um den Wert dieses Merkmals zu schreiben. Wenn properties() weder QLowEnergyCharacteristic::Write noch QLowEnergyCharacteristic::WriteNoResponse noch QLowEnergyCharacteristic::WriteSigned enthält, ist dieser Wert irrelevant. Standardmäßig gibt es keine Schreibeinschränkungen.

Siehe auch ` setWriteConstraints()`.

QLowEnergyCharacteristicData &QLowEnergyCharacteristicData::operator=(const QLowEnergyCharacteristicData &other)

Erstellt eine Kopie von „ other “ und gibt den neuen Wert dieses Objekts zurück.

Verwandte Nicht-Mitglieder

bool operator!=(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)

Gibt „ true “ zurück, wenn „ a “ und „ b “ hinsichtlich ihres öffentlichen Zustands nicht gleich sind; andernfalls wird „ false “ zurückgegeben.

bool operator==(const QLowEnergyCharacteristicData &a, const QLowEnergyCharacteristicData &b)

Gibt „ true “ zurück, wenn „ a “ und „ b “ hinsichtlich ihres öffentlichen Zustands gleich sind; andernfalls wird „ false “ zurückgegeben.

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