Sur cette page

QLowEnergyCharacteristicData Class

La classe QLowEnergyCharacteristicData sert à configurer les données de service GATT. En savoir plus...

En-tête : #include <QLowEnergyCharacteristicData>
CMake : find_package(Qt6 REQUIRED COMPONENTS Bluetooth)
target_link_libraries(mytarget PRIVATE Qt6::Bluetooth)
qmake : QT += bluetooth

Fonctions publiques

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)

Description détaillée

Un objet de cette classe fournit une caractéristique à ajouter à un objet ` QLowEnergyServiceData ` via la méthode ` QLowEnergyServiceData::addCharacteristic()` ().

Voir également QLowEnergyServiceData et QLowEnergyController::addService.

Documentation des fonctions membres

QLowEnergyCharacteristicData::QLowEnergyCharacteristicData()

Crée un nouvel objet non valide de cette classe.

QLowEnergyCharacteristicData::QLowEnergyCharacteristicData(const QLowEnergyCharacteristicData &other)

Crée un nouvel objet de cette classe qui est une copie de other.

[noexcept] QLowEnergyCharacteristicData::~QLowEnergyCharacteristicData()

Détruit cet objet.

void QLowEnergyCharacteristicData::addDescriptor(const QLowEnergyDescriptorData &descriptor)

Ajoute « descriptor » à la liste des descripteurs de cette caractéristique, si celui-ci est valide.

Voir également setDescriptors().

QList<QLowEnergyDescriptorData> QLowEnergyCharacteristicData::descriptors() const

Renvoie les descripteurs de cette caractéristique.

Voir également setDescriptors().

bool QLowEnergyCharacteristicData::isValid() const

Renvoie « true » si et seulement si cette caractéristique est valide, c'est-à-dire si son UUID n'est pas nul.

int QLowEnergyCharacteristicData::maximumValueLength() const

Renvoie la longueur maximale, en octets, que peut avoir la valeur de cette caractéristique. Par défaut, il n'y a pas de limite au-delà des contraintes du type de données.

int QLowEnergyCharacteristicData::minimumValueLength() const

Renvoie la longueur minimale, en octets, que peut avoir la valeur de cette caractéristique. La valeur par défaut est zéro.

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristicData::properties() const

Renvoie les propriétés de cette caractéristique.

Voir également setProperties().

QBluetooth::AttAccessConstraints QLowEnergyCharacteristicData::readConstraints() const

Renvoie les contraintes requises pour qu'un client puisse lire la valeur de cette caractéristique. Si la fonction properties() ne contient pas l'option QLowEnergyCharacteristic::Read, cette valeur n'a aucune importance. Par défaut, il n'y a pas de contraintes de lecture.

Voir également setReadConstraints().

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

Définit les descripteurs de cette caractéristique sur descriptors. Seuls les descripteurs valides sont pris en compte.

Voir également descriptors() et addDescriptor().

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

Définit les propriétés de cette caractéristique sur « properties ».

Voir également properties().

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

Indique que les clients doivent respecter la spécification constraints pour pouvoir lire la valeur de cette caractéristique.

Voir également readConstraints().

void QLowEnergyCharacteristicData::setUuid(const QBluetoothUuid &uuid)

Définit l'UUID de cette caractéristique sur uuid.

Voir également uuid().

void QLowEnergyCharacteristicData::setValue(const QByteArray &value)

Définit la valeur de cette caractéristique sur « value ».

Voir également value().

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

Spécifie que minimum et maximum correspondent respectivement à la longueur minimale et maximale que peut prendre la valeur de cette caractéristique. L'unité est l'octet. Si minimum et maximum sont égales, la caractéristique a une valeur de longueur fixe.

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

Spécifie que les clients doivent respecter la norme constraints pour pouvoir écrire la valeur de cette caractéristique.

Voir également writeConstraints().

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

Permute cet objet avec other.

QBluetoothUuid QLowEnergyCharacteristicData::uuid() const

Renvoie l'UUID de cette caractéristique.

Voir aussi setUuid().

QByteArray QLowEnergyCharacteristicData::value() const

Renvoie la valeur de cette caractéristique.

Voir aussi setValue().

QBluetooth::AttAccessConstraints QLowEnergyCharacteristicData::writeConstraints() const

Renvoie les contraintes nécessaires pour qu'un client puisse écrire la valeur de cette caractéristique. Si la fonction properties() ne contient ni QLowEnergyCharacteristic::Write, ni QLowEnergyCharacteristic::WriteNoResponse, ni QLowEnergyCharacteristic::WriteSigned, cette valeur n'a aucune importance. Par défaut, il n'y a aucune contrainte d'écriture.

Voir également setWriteConstraints().

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

Fait de cet objet une copie de other et renvoie la nouvelle valeur de cet objet.

Éléments non membres associés

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

Renvoie « true » si « a » et « b » ne sont pas égaux au niveau de leur état public ; sinon, renvoie « false ».

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

Renvoie ` true ` si ` a ` et ` b ` sont égales au niveau de leur état public ; sinon, renvoie ` false`.

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