Sur cette page

QLowEnergyCharacteristicData Class

La classe QLowEnergyCharacteristicData est utilisée pour configurer les données de service du GATT. Plus d'informations...

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 QLowEnergyServiceData::addCharacteristic().

Voir également QLowEnergyServiceData et QLowEnergyController::addService.

Documentation des fonctions membres

QLowEnergyCharacteristicData::QLowEnergyCharacteristicData()

Crée un nouvel objet invalide de cette classe.

QLowEnergyCharacteristicData::QLowEnergyCharacteristicData(const QLowEnergyCharacteristicData &other)

Construit 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, s'il est valide.

Voir également setDescriptors().

QList<QLowEnergyDescriptorData> QLowEnergyCharacteristicData::descriptors() const

Renvoie les descripteurs de cette caractéristique.

Voir également setDescriptors().

bool QLowEnergyCharacteristicData::isValid() const

Retourne vrai si et seulement si cette caractéristique est valide, c'est-à-dire qu'elle a un UUID non nul.

int QLowEnergyCharacteristicData::maximumValueLength() const

Renvoie la longueur maximale en octets que la valeur de cette caractéristique peut avoir. 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 nécessaires pour qu'un client puisse lire la valeur de cette caractéristique. Si properties() n'inclut pas QLowEnergyCharacteristic::Read, cette valeur n'est pas pertinente. 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 à 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 à properties.

Voir également properties().

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

Indique que les clients doivent remplir la condition constraints pour lire la valeur de cette caractéristique.

Voir également readConstraints().

void QLowEnergyCharacteristicData::setUuid(const QBluetoothUuid &uuid)

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

Voir également uuid().

void QLowEnergyCharacteristicData::setValue(const QByteArray &value)

Fixe la valeur de cette caractéristique à value.

Voir également value().

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

Indique que minimum et maximum sont respectivement la plus petite et la plus grande longueur que peut avoir la valeur de cette caractéristique. L'unité est l'octet. Si minimum et maximum sont égaux, la caractéristique a une valeur de longueur fixe.

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

Indique que les clients doivent remplir la condition constraints pour écrire la valeur de cette caractéristique.

Voir également writeConstraints().

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

Remplace cet objet par other.

QBluetoothUuid QLowEnergyCharacteristicData::uuid() const

Renvoie l'UUID de cette caractéristique.

Voir également setUuid().

QByteArray QLowEnergyCharacteristicData::value() const

Renvoie la valeur de cette caractéristique.

Voir également setValue().

QBluetooth::AttAccessConstraints QLowEnergyCharacteristicData::writeConstraints() const

Renvoie les contraintes nécessaires pour qu'un client puisse écrire la valeur de cette caractéristique. Si properties() n'inclut pas QLowEnergyCharacteristic::Write, QLowEnergyCharacteristic::WriteNoResponse et QLowEnergyCharacteristic::WriteSigned, cette valeur n'est pas pertinente. Par défaut, il n'y a pas de contraintes 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.

Non-membres apparentés

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

Renvoie true si a et b ne sont pas égaux en ce qui concerne leur état public, sinon renvoie false.

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

Renvoie true si a et b sont égaux en ce qui concerne 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.