Sur cette page

QNdefNfcSmartPosterRecord Class

La classe QNdefNfcSmartPosterRecord fournit un RTD-SmartPoster NFC. En savoir plus...

En-tête : #include <QNdefNfcSmartPosterRecord>
CMake : find_package(Qt6 REQUIRED COMPONENTS Nfc)
target_link_libraries(mytarget PRIVATE Qt6::Nfc)
qmake : QT += nfc
Depuis : Qt 5.2
Hérite de : QNdefRecord

Types publics

enum Action { UnspecifiedAction, DoAction, SaveAction, EditAction }

Fonctions publiques

QNdefNfcSmartPosterRecord()
QNdefNfcSmartPosterRecord(const QNdefRecord &other)
QNdefNfcSmartPosterRecord(const QNdefNfcSmartPosterRecord &other)
~QNdefNfcSmartPosterRecord()
QNdefNfcSmartPosterRecord::Action action() const
void addIcon(const QNdefNfcIconRecord &icon)
void addIcon(const QByteArray &type, const QByteArray &data)
bool addTitle(const QNdefNfcTextRecord &text)
bool addTitle(const QString &text, const QString &locale, QNdefNfcTextRecord::Encoding encoding)
bool hasAction() const
bool hasIcon(const QByteArray &mimetype = QByteArray()) const
bool hasSize() const
bool hasTitle(const QString &locale = QString()) const
bool hasTypeInfo() const
QByteArray icon(const QByteArray &mimetype = QByteArray()) const
qsizetype iconCount() const
QNdefNfcIconRecord iconRecord(qsizetype index) const
QList<QNdefNfcIconRecord> iconRecords() const
bool removeIcon(const QByteArray &type)
bool removeIcon(const QNdefNfcIconRecord &icon)
bool removeTitle(const QNdefNfcTextRecord &text)
bool removeTitle(const QString &locale)
void setAction(QNdefNfcSmartPosterRecord::Action act)
void setIcons(const QList<QNdefNfcIconRecord> &icons)
void setSize(quint32 size)
void setTitles(const QList<QNdefNfcTextRecord> &titles)
void setTypeInfo(const QString &type)
void setUri(const QNdefNfcUriRecord &url)
void setUri(const QUrl &url)
quint32 size() const
QString title(const QString &locale = QString()) const
qsizetype titleCount() const
QNdefNfcTextRecord titleRecord(qsizetype index) const
QList<QNdefNfcTextRecord> titleRecords() const
QString typeInfo() const
QUrl uri() const
QNdefNfcUriRecord uriRecord() const
QNdefNfcSmartPosterRecord &operator=(const QNdefNfcSmartPosterRecord &other)

Description détaillée

RTD-SmartPoster encapsule un Smart Poster.

Documentation sur les types de membres

enum QNdefNfcSmartPosterRecord::Action

Cette énumération décrit la marche à suivre qu'un appareil doit adopter concernant le contenu.

ConstanteValeurDescription
QNdefNfcSmartPosterRecord::UnspecifiedAction-1L'action n'est pas définie.
QNdefNfcSmartPosterRecord::DoAction0Effectuer l’action (envoyer le SMS, lancer le navigateur, passer l’appel téléphonique).
QNdefNfcSmartPosterRecord::SaveAction1Enregistrer pour plus tard (enregistrer le SMS dans la boîte de réception, ajouter l'URI aux favoris, enregistrer le numéro de téléphone dans les contacts).
QNdefNfcSmartPosterRecord::EditAction2Ouvrir pour modification (ouvrir un SMS dans l'éditeur de SMS, ouvrir l'URI dans un éditeur d'URI, ouvrir le numéro de téléphone pour le modifier).

Documentation des fonctions membres

QNdefNfcSmartPosterRecord::QNdefNfcSmartPosterRecord()

Crée une nouvelle affiche intelligente vide.

QNdefNfcSmartPosterRecord::QNdefNfcSmartPosterRecord(const QNdefRecord &other)

Crée une nouvelle affiche interactive qui est une copie de other.

QNdefNfcSmartPosterRecord::QNdefNfcSmartPosterRecord(const QNdefNfcSmartPosterRecord &other)

Crée une nouvelle affiche intelligente qui est une copie de other.

[noexcept] QNdefNfcSmartPosterRecord::~QNdefNfcSmartPosterRecord()

Détruit l'affiche intelligente.

QNdefNfcSmartPosterRecord::Action QNdefNfcSmartPosterRecord::action() const

Renvoie l'action issue de l'enregistrement d'action si celle-ci est disponible. Sinon, la valeur « UnspecifiedAction » est renvoyée.

Voir aussi setAction().

void QNdefNfcSmartPosterRecord::addIcon(const QNdefNfcIconRecord &icon)

Ajoute un enregistrement d'icône icon au « smart poster ». Si le « smart poster » contient déjà un enregistrement d'icône du même type, celui-ci est remplacé.

void QNdefNfcSmartPosterRecord::addIcon(const QByteArray &type, const QByteArray &data)

Ajoute à l'affiche interactive un enregistrement d'icône de type « type » et contenant les données « data ». Si l'affiche interactive contient déjà un enregistrement d'icône de ce type, celui-ci est remplacé.

bool QNdefNfcSmartPosterRecord::addTitle(const QNdefNfcTextRecord &text)

Tente d'ajouter un enregistrement de titre text à l'affiche intelligente. Si l'affiche intelligente ne contient pas déjà un enregistrement de titre avec la même locale que l'enregistrement de titre text, alors cet enregistrement est ajouté et la fonction renvoie true. Dans le cas contraire, elle renvoie false.

bool QNdefNfcSmartPosterRecord::addTitle(const QString &text, const QString &locale, QNdefNfcTextRecord::Encoding encoding)

Tente d'ajouter un nouvel enregistrement de titre avec le titre text, la locale locale et l'encodage encoding. Si le « smart poster » ne contient pas encore d'enregistrement de titre avec la locale locale, alors cet enregistrement est ajouté et la fonction renvoie true. Dans le cas contraire, elle renvoie false.

bool QNdefNfcSmartPosterRecord::hasAction() const

Renvoie « true » si l'affiche intelligente contient un enregistrement d'action ; sinon, renvoie « false ».

bool QNdefNfcSmartPosterRecord::hasIcon(const QByteArray &mimetype = QByteArray()) const

Renvoie « true » si le « smart poster » contient un enregistrement d’icône de type « mimetype ». Si « mimetype » est vide, alors « true » est renvoyé si le « smart poster » contient au moins un enregistrement d’icône. Dans tous les autres cas, « false » est renvoyé.

bool QNdefNfcSmartPosterRecord::hasSize() const

Renvoie « true » si l'affiche intelligente contient un enregistrement de taille ; sinon, renvoie « false ».

bool QNdefNfcSmartPosterRecord::hasTitle(const QString &locale = QString()) const

Renvoie « true » si le « smart poster » contient une fiche de titre utilisant la locale « locale ». Si « locale » est vide, alors « true » est renvoyé si le « smart poster » contient au moins une fiche de titre. Dans tous les autres cas, « false » est renvoyé.

bool QNdefNfcSmartPosterRecord::hasTypeInfo() const

Renvoie « true » si l'affiche intelligente contient un enregistrement de type ; sinon, renvoie « false ».

QByteArray QNdefNfcSmartPosterRecord::icon(const QByteArray &mimetype = QByteArray()) const

Renvoie les données de l'enregistrement d'icône associé si le « smart poster » contient un enregistrement d'icône de type MIME mimetype. Si le paramètre « mimetype » est omis ou vide, les données de l'enregistrement de la première icône sont renvoyées. Dans tous les autres cas, un tableau vide est renvoyé.

Avertissement : il est conseillé aux développeursd’applications de valider les données renvoyées avant de les traiter. Reportez-vous à la section « Considérations de sécurité relatives à Qt NFC » pour plus d’informations.

qsizetype QNdefNfcSmartPosterRecord::iconCount() const

Renvoie le nombre d'enregistrements d'icônes contenus dans le « smart poster ».

QNdefNfcIconRecord QNdefNfcSmartPosterRecord::iconRecord(qsizetype index) const

Renvoie l'enregistrement d'icône correspondant à l'index index au sein du Smart Poster, où index est une valeur comprise entre 0 et iconCount() - 1. Les valeurs situées en dehors de cette plage renvoient un enregistrement vide.

QList<QNdefNfcIconRecord> QNdefNfcSmartPosterRecord::iconRecords() const

Renvoie une copie de tous les enregistrements d'icônes contenus dans le « smart poster ».

bool QNdefNfcSmartPosterRecord::removeIcon(const QByteArray &type)

Tente de supprimer de l'affiche intelligente l'enregistrement d'icône de type « type ». Supprime l'enregistrement et renvoie « true » si l'affiche intelligente contient un enregistrement correspondant ; dans le cas contraire, « false » est renvoyé.

bool QNdefNfcSmartPosterRecord::removeIcon(const QNdefNfcIconRecord &icon)

Tente de supprimer l'enregistrement d'icône icon du « smart poster ». Supprime l'enregistrement et renvoie true si le « smart poster » contient un enregistrement correspondant ; dans le cas contraire, false est renvoyé.

bool QNdefNfcSmartPosterRecord::removeTitle(const QNdefNfcTextRecord &text)

Tente de supprimer l'enregistrement de titre text de l'affiche intelligente. Supprime l'enregistrement et renvoie true si l'affiche intelligente contient un enregistrement correspondant ; dans le cas contraire, false est renvoyé.

bool QNdefNfcSmartPosterRecord::removeTitle(const QString &locale)

Tente de supprimer de l'affiche intelligente une fiche de titre dont la locale est « locale ». Supprime la fiche et renvoie « true » si l'affiche intelligente contient une fiche correspondant à ces critères ; dans le cas contraire, la valeur « false » est renvoyée.

void QNdefNfcSmartPosterRecord::setAction(QNdefNfcSmartPosterRecord::Action act)

Définit l'historique des actions sur act

Voir aussi action().

void QNdefNfcSmartPosterRecord::setIcons(const QList<QNdefNfcIconRecord> &icons)

Ajoute la liste d'enregistrements d'icônes icons à l'affiche interactive. Les enregistrements existants sont écrasés.

Voir également hasIcon() et icon().

void QNdefNfcSmartPosterRecord::setSize(quint32 size)

Définit l'enregistrement size. La valeur contient la taille en octets de l'objet auquel l'URI fait référence.

Voir également size() et hasSize().

void QNdefNfcSmartPosterRecord::setTitles(const QList<QNdefNfcTextRecord> &titles)

Ajoute la liste d'enregistrements de titres « titles » à l'affiche intelligente. Les enregistrements existants sont écrasés.

void QNdefNfcSmartPosterRecord::setTypeInfo(const QString &type)

Définit l'enregistrement de type sur type. La fonction type décrit le type de l'objet référencé par uri().

Voir également typeInfo().

void QNdefNfcSmartPosterRecord::setUri(const QNdefNfcUriRecord &url)

Définit l'enregistrement URI sur url

Voir aussi uri().

void QNdefNfcSmartPosterRecord::setUri(const QUrl &url)

Crée un enregistrement URI et insère son contenu dans l'affiche interactive pour url

quint32 QNdefNfcSmartPosterRecord::size() const

Renvoie la taille indiquée dans l'enregistrement de taille, si celui-ci est disponible ; sinon, renvoie 0.

Cette valeur est facultative et contient la taille en octets de l’objet auquel l’URI fait référence. Elle peut être utilisée par le périphérique pour déterminer s’il est capable de prendre en charge l’objet.

Voir également setSize().

QString QNdefNfcSmartPosterRecord::title(const QString &locale = QString()) const

Renvoie le texte du titre associé à la locale locale s’il est disponible. Si locale est vide, le texte du titre du premier enregistrement disponible est renvoyé. Dans tous les autres cas, une chaîne vide est renvoyée.

qsizetype QNdefNfcSmartPosterRecord::titleCount() const

Renvoie le nombre d'enregistrements de titres contenus dans l'affiche intelligente.

QNdefNfcTextRecord QNdefNfcSmartPosterRecord::titleRecord(qsizetype index) const

Renvoie l'enregistrement de titre correspondant à l'index index au sein du « smart poster », où index est une valeur comprise entre 0 et titleCount() - 1. Les valeurs situées en dehors de cette plage renvoient un enregistrement vide.

QList<QNdefNfcTextRecord> QNdefNfcSmartPosterRecord::titleRecords() const

Renvoie une copie de tous les enregistrements de titres contenus dans le « smart poster ».

QString QNdefNfcSmartPosterRecord::typeInfo() const

Renvoie le type MIME décrivant le type des objets accessibles via la fonction ` uri()`.

Si le type n'est pas connu, le paramètre ` QString ` renvoyé est vide.

Voir aussi setTypeInfo() et hasTypeInfo().

QUrl QNdefNfcSmartPosterRecord::uri() const

Renvoie l'URI figurant dans l'enregistrement URI de l'affiche intelligente, s'il est défini. Sinon, un URI vide est renvoyé.

Avertissement : il est conseillé aux développeursd’applications de valider l’URI renvoyée avant de l’utiliser. Consultez la section « Considérations de sécurité » de Qt NFC pour plus d’informations.

Voir également setUri().

QNdefNfcUriRecord QNdefNfcSmartPosterRecord::uriRecord() const

Renvoie l'URI de l'affiche intelligente s'il est défini. Sinon, un URI vide est renvoyé.

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

Assigne l'enregistrement « smart poster » « other » à cet enregistrement et renvoie une référence à cet enregistrement.

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