Класс QDBusAbstractAdaptor
Класс QDBusAbstractAdaptor является базовым классом для классов адаптеров D-Bus. Подробнее...
| Заголовок: | #include <QDBusAbstractAdaptor> |
| qmake: | QT += dbus |
| С момента: | Qt 4.2 |
| Наследует: | QObject |
Этот класс был представлен в Qt 4.2.
Публичные функции
| 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 4.2.
См. такжеИспользование адаптеров Qt D-Bus.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qdbusabstractadaptor.html