Класс QDBusAbstractAdaptor
Класс QDBusAbstractAdaptor является базовым классом для классов адаптеров D-Bus. Подробнее...
| Заголовок: | #include <QDBusAbstractAdaptor> |
| CMake: | find_package(Qt6 COMPONENTS Dbus REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Dbus) |
| qmake: | QT += dbus |
| Наследует: | QObject |
Открытые функции
| virtual | ~QDBusAbstractAdaptor() |
Защищенные функции
| QDBusAbstractAdaptor(QObject *obj) | |
| bool | autoRelaySignals() const |
| void | setAutoRelaySignals(bool enable) |
Макросы
| Q_NOREPLY |
Подробное описание
Класс QDBusAbstractAdaptor является отправной точкой для всех объектов, намеревающихся предоставить интерфейсы внешнему миру с использованием D-Bus. Это достигается путем присоединения одного или нескольких классов, производных от QDBusAbstractAdaptor, к обычному объекту QObject и последующей регистрации этого QObject с помощью QDBusConnection::registerObject. Объекты QDBusAbstractAdaptor предназначены для создания легких обёртки, в основном просто перенаправляющих вызовы в реальный объект (его родитель) и сигналы от него.
Каждый класс, производный от QDBusAbstractAdaptor, должен определять интерфейс D-Bus, который он реализует, используя макрос Q_CLASSINFO в определении класса. Обратите внимание, что таким образом может быть экспортирован только один интерфейс.
QDBusAbstractAdaptor использует стандартный механизм QObject сигналов, слотов и свойств, чтобы определить, какие сигналы, методы и свойства экспортировать в шину. Любой сигнал, отправленный классами, производными от QDBusAbstractAdaptor, будет автоматически перенаправлен через любые подключения D-Bus, на которых зарегистрирован объект.
Классы, производные от QDBusAbstractAdaptor, должны создаваться в куче с помощью оператора new и не должны удаляться пользователем (они будут удалены автоматически, когда будет удален подключенный к ним объект).
См. также Использование адаптеров и QDBusConnection.
Документация по функциям-членам
[protected] QDBusAbstractAdaptor::QDBusAbstractAdaptor(QObject *obj)
Создаёт QDBusAbstractAdaptor с obj в качестве родительского объекта.
[virtual] QDBusAbstractAdaptor::~QDBusAbstractAdaptor()
Удаляет адаптер.
Предупреждение: Адаптеры удаляются автоматически при уничтожении реального объекта, на который они ссылаются. Не удаляйте адаптеры самостоятельно.
[protected] bool QDBusAbstractAdaptor::autoRelaySignals() const
Возвращает true, если автоматическая перенаправка сигналов от реального объекта (см. object()) включена, в противном случае возвращает false.
См. также setAutoRelaySignals().
[protected] void QDBusAbstractAdaptor::setAutoRelaySignals(bool enable)
Переключает автоматическую перенаправку сигналов от реального объекта (см. object()).
Автоматическая перенаправка сигналов заключается в соединении сигналов-сигналов сигналов родителя, имеющих точно такой же сигнатурный метод в обоих классах.
Если enable установлено в true, соединить сигналы; если установлено в false, отключить все сигналы.
См. также autoRelaySignals().
Документация по макросам
Q_NOREPLY
Макрос Q_NOREPLY можно использовать для маркирования метода, который должен вызываться, но не ожидать завершения его обработки перед возвратом из QDBusInterface::call(). Вызванный метод не может возвращать какие-либо выходные аргументы, и если он это делает, любые такие аргументы будут отброшены.
Вы можете использовать этот макрос в собственных адаптерах, поместив его перед значением возврата вашего метода (которое должно быть «void») в объявлении класса, как показано в примере:
Q_NOREPLY void myMethod();
Его присутствие в реализации метода (вне объявления класса) необязательно.
См. также Использование адаптеров Qt D-Bus.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qdbusabstractadaptor.html
