Spec-Zone.ru › Qt 5.14

Класс 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.14/qdbusabstractadaptor.html

Spec-Zone.ru

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