QCanMessageDescription Class
Die Klasse „QCanMessageDescription“ beschreibt die Regeln zur Verarbeitung einer CAN-Nachricht und deren Darstellung in einem anwendungsdefinierten Format. Mehr...
| Header: | #include <QCanMessageDescription> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SerialBus) target_link_libraries(mytarget PRIVATE Qt6::SerialBus) |
| qmake: | QT += serialbus |
| Seit: | Qt 6.5 |
| Status: | Technologievorschau |
Diese Klasse befindet sich in der Technologievorschau und kann sich noch ändern.
Öffentliche Funktionen
| QCanMessageDescription() | |
| QCanMessageDescription(const QCanMessageDescription &other) | |
| QCanMessageDescription(QCanMessageDescription &&other) | |
| ~QCanMessageDescription() | |
| void | addSignalDescription(const QCanSignalDescription &description) |
| void | clearSignalDescriptions() |
| QString | comment() const |
| bool | isValid() const |
| QString | name() const |
| void | setComment(const QString &text) |
| void | setName(const QString &name) |
| void | setSignalDescriptions(const QList<QCanSignalDescription> &descriptions) |
| void | setSize(quint8 size) |
| void | setTransmitter(const QString &transmitter) |
| void | setUniqueId(QtCanBus::UniqueId id) |
| QCanSignalDescription | signalDescriptionForName(const QString &name) const |
| QList<QCanSignalDescription> | signalDescriptions() const |
| quint8 | size() const |
| QString | transmitter() const |
| QtCanBus::UniqueId | uniqueId() const |
| QCanMessageDescription & | operator=(QCanMessageDescription &&other) |
| QCanMessageDescription & | operator=(const QCanMessageDescription &other) |
Ausführliche Beschreibung
Eine CAN-Nachricht ist im Grunde eine „ QCanBusFrame “. Die Beschreibung einer CAN-Nachricht umfasst Folgendes:
- Nachrichten-ID.
- Nachrichtenname.
- Nachrichtenlänge in Byte.
- Quelle der Nachricht (Sender).
- Beschreibung der Signale in der Nachricht.
Die Klasse „QCanMessageDescription“ stellt Methoden zur Steuerung all dieser Parameter bereit.
Nachrichten-ID
Die Nachrichten-ID ist eine eindeutige Kennung, die dazu dient, beim Dekodieren der eingehenden „ QCanBusFrame “ oder beim Kodieren einer „ QCanBusFrame “ auf der Grundlage der bereitgestellten Daten die richtige Nachrichtenbeschreibung auszuwählen.
Weitere Informationen zur Beschreibung der eindeutigen Kennung finden Sie in der Dokumentation zu „ QCanUniqueIdDescription “.
Signalbeschreibung
Die Signalbeschreibung wird durch die Klasse „ QCanSignalDescription “ dargestellt. Die Klasse „QCanMessageDescription“ stellt lediglich eine Liste der Signale bereit, die zur Nachricht gehören.
Siehe auch „ QCanSignalDescription “ und „ QCanUniqueIdDescription “.
Dokumentation zu den Mitgliedsfunktionen
QCanMessageDescription::QCanMessageDescription()
Erstellt eine leere Nachrichtenbeschreibung.
QCanMessageDescription::QCanMessageDescription(const QCanMessageDescription &other)
Erstellt eine Nachrichtenbeschreibung mit den Werten, die von other kopiert wurden.
[constexpr noexcept default] QCanMessageDescription::QCanMessageDescription(QCanMessageDescription &&other)
Erstellt eine Nachrichtenbeschreibung, indem ein Objekt aus „ other “ verschoben wird.
Hinweis: Das aus xml-ph-0000@deepl.internal verschobene QCanMessageDescription-Objekt kann nur zerstört oder zugewiesen werden. Die Auswirkungen des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren sind undefiniert.
[constexpr noexcept default] QCanMessageDescription::~QCanMessageDescription()
Löscht diese Nachrichtenbeschreibung.
void QCanMessageDescription::addSignalDescription(const QCanSignalDescription &description)
Fügt dieser Nachrichtenbeschreibung eine neue Signalbeschreibung „ description “ hinzu.
Falls die Nachrichtenbeschreibung bereits eine Signalbeschreibung für ein Signal mit demselben Namen enthält, wird diese überschrieben.
Siehe auch signalDescriptions(), signalDescriptionForName(), setSignalDescriptions() und clearSignalDescriptions().
void QCanMessageDescription::clearSignalDescriptions()
Löscht alle Signalbeschreibungen dieser Nachricht.
Siehe auch signalDescriptions(), signalDescriptionForName(), addSignalDescription() und setSignalDescriptions().
QString QCanMessageDescription::comment() const
Gibt den Kommentar zur Nachricht zurück.
Dieser Parameter dient lediglich der zusätzlichen Beschreibung. Er wird bei der Kodierung oder Dekodierung der Nachricht nicht verwendet.
Siehe auch ` setComment()`.
bool QCanMessageDescription::isValid() const
Gibt „ true “ zurück, wenn die Nachrichtenbeschreibung gültig ist, andernfalls „ false “.
Eine gültige Nachrichtenbeschreibung muss mindestens eine Signalbeschreibung enthalten. Alle Signalbeschreibungen müssen ebenfalls gültig sein.
Siehe auch signalDescriptions() und QCanSignalDescription::isValid().
QString QCanMessageDescription::name() const
Gibt den Namen der CAN-Nachricht zurück.
Dieser Parameter dient lediglich der zusätzlichen Beschreibung. Er wird bei der Kodierung oder Dekodierung der Nachricht nicht verwendet.
Siehe auch „ setName()“.
void QCanMessageDescription::setComment(const QString &text)
Setzt den Kommentar für die Nachricht auf „ text “.
Dieser Parameter dient lediglich der zusätzlichen Beschreibung. Er wird bei der Kodierung oder Dekodierung der Nachricht nicht verwendet.
Siehe auch comment().
void QCanMessageDescription::setName(const QString &name)
Legt den Namen der CAN-Nachricht auf „ name “ fest.
Dieser Parameter dient lediglich der zusätzlichen Beschreibung. Er wird bei der Kodierung oder Dekodierung der Nachricht nicht verwendet.
Siehe auch „ name()“.
void QCanMessageDescription::setSignalDescriptions(const QList<QCanSignalDescription> &descriptions)
Legt die Beschreibungen der Signale fest, die zu dieser Nachrichtenbeschreibung gehören, auf „ descriptions “.
Hinweis: Eine Nachrichtenbeschreibung muss Signalbeschreibungen mit eindeutigen Signalnamen enthalten. Wenn die Liste „ descriptions “ also Einträge mit doppelten Namen enthält, wird nur der letzte Eintrag hinzugefügt.
Siehe auch signalDescriptions(), signalDescriptionForName(), addSignalDescription() und clearSignalDescriptions().
void QCanMessageDescription::setSize(quint8 size)
Legt die Größe der CAN-Nachricht in Byte auf „ size “ fest.
Siehe auch ` size()`.
void QCanMessageDescription::setTransmitter(const QString &transmitter)
Setzt den Senderknoten der Nachricht auf transmitter.
Dieser Parameter dient lediglich der zusätzlichen Beschreibung. Er wird bei der Kodierung oder Dekodierung der Nachricht nicht verwendet.
Siehe auch transmitter().
void QCanMessageDescription::setUniqueId(QtCanBus::UniqueId id)
Setzt die eindeutige Kennung der CAN-Nachricht auf „ id “.
Weitere Informationen zur eindeutigen Kennung finden Sie im Abschnitt „ Message ID “.
Siehe auch ` uniqueId()`.
QCanSignalDescription QCanMessageDescription::signalDescriptionForName(const QString &name) const
Gibt die Signalbeschreibung eines Signals mit dem Namen „ name “ zurück.
Wenn die Nachrichtenbeschreibung keine solche Signalbeschreibung enthält, wird ein standardmäßig erstelltes QCanSignalDescription -Objekt zurückgegeben.
Siehe auch „ signalDescriptions()“, „ addSignalDescription()“, „ setSignalDescriptions()“ und „ clearSignalDescriptions()“.
QList<QCanSignalDescription> QCanMessageDescription::signalDescriptions() const
Gibt die Liste der Signalbeschreibungen zurück, die zu dieser Nachrichtenbeschreibung gehören.
Siehe auch signalDescriptionForName(), addSignalDescription(), setSignalDescriptions() und clearSignalDescriptions().
quint8 QCanMessageDescription::size() const
Gibt die Größe der CAN-Nachricht in Byte zurück.
Siehe auch „ setSize()“.
QString QCanMessageDescription::transmitter() const
Gibt den Absenderknoten der Nachricht zurück.
Dieser Parameter dient lediglich der zusätzlichen Beschreibung. Er wird bei der Kodierung oder Dekodierung der Nachricht nicht verwendet.
Siehe auch ` setTransmitter()`.
QtCanBus::UniqueId QCanMessageDescription::uniqueId() const
Gibt die eindeutige Kennung der CAN-Nachricht zurück.
Weitere Informationen zur eindeutigen Kennung finden Sie im Abschnitt „ Message ID “.
Siehe auch „ setUniqueId()“.
[noexcept] QCanMessageDescription &QCanMessageDescription::operator=(QCanMessageDescription &&other)
Weist dieser Nachrichtenbeschreibung die Werte aus „ other “ per Move-Zuweisung zu.
Hinweis: Das Objekt „ QCanMessageDescription “, aus dem die Werte verschoben wurden, kann nur zerstört oder einer Zuweisung unterzogen werden. Die Auswirkungen des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren sind undefiniert.
QCanMessageDescription &QCanMessageDescription::operator=(const QCanMessageDescription &other)
Weist dieser Nachrichtenbeschreibung die Werte aus „ other “ zu.
© 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.
