Spec-Zone.ru › Qt 5.15

Класс 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API