QDBusServiceWatcher Class

멤버 함수 문서

[explicit] QDBusServiceWatcher::QDBusServiceWatcher(QObject *parent = nullptr)

QDBusServiceWatcher 객체를 생성합니다. setConnection()를 통해 연결을 설정하기 전까지는 이 객체가 어떠한 신호도 발생시키지 않는다는 점에 유의하십시오.

parent 매개변수는 QObject 에 전달되어 이 객체의 부모를 설정합니다.

QDBusServiceWatcher::QDBusServiceWatcher(const QString &service, const QDBusConnection &connection, QDBusServiceWatcher::WatchMode watchMode = WatchForOwnerChange, QObject *parent = nullptr)

QDBusServiceWatcher 객체를 생성하여 connection 연결에 연결합니다. 또한, 이 함수는 service 서비스에 대한 watchMode 변경 사항을 즉시 감시하기 시작합니다.

parent 매개변수는 QObject 에 전달되어 이 객체의 부모를 설정합니다.

[virtual noexcept] QDBusServiceWatcher::~QDBusServiceWatcher()

QDBusServiceWatcher 객체를 삭제하고, 해당 객체와 관련된 모든 리소스를 해제합니다.

void QDBusServiceWatcher::addWatchedService(const QString &newService)

이 객체가 모니터링할 서비스 목록에 newService 을 추가합니다. 이 함수는 setWatchedServices()보다 효율적이므로, 서비스를 추가할 때는 가능한 한 이 함수를 사용해야 합니다.

watchedServices 에 대한 기존 바인딩을 모두 제거합니다.

QDBusConnection QDBusServiceWatcher::connection() const

이 객체가 연결된 QDBusConnection 를 반환합니다.

setConnection()도 참조하십시오 .

bool QDBusServiceWatcher::removeWatchedService(const QString &service)

이 객체가 감시 중인 서비스 목록에서 service 를 제거합니다. D-Bus 알림은 비동기적으로 처리되므로, service 에 대한 신호가 아직 전달 대기 중일 수 있습니다. 이러한 신호는 D-Bus 메시지가 처리될 때마다 여전히 발생합니다.

watchedServices 에 대한 기존의 바인딩을 모두 제거합니다.

이 함수는 서비스가 제거된 경우 true 를 반환합니다.

[signal] void QDBusServiceWatcher::serviceOwnerChanged(const QString &serviceName, const QString &oldOwner, const QString &newOwner)

이 객체가 serviceName 서비스와 관련된 소유권 변경을 감지할 때마다 이 신호가 발송됩니다. oldOwner 매개변수에는 이전 소유자 이름이 포함되어 있으며, newOwner 는 새로운 소유자입니다. oldOwner 와 newOwner 는 모두 고유한 연결 이름입니다.

이 신호는 serviceName 서비스가 등록되거나 등록 해제될 때마다 발생한다는 점에 유의하십시오. 서비스가 등록된 경우 oldOwner 에는 빈 문자열이 포함되며, 등록이 해제된 경우 newOwner 에는 빈 문자열이 포함됩니다.

소유권 변경 알림 없이 단순히 서비스가 등록되었는지 또는 등록이 해제되었는지 확인하기만 원하는 경우, 해당 작업에 특화된 모드를 사용하는 것을 고려해 보십시오. 보다 구체적인 모드를 사용할 경우 이 클래스의 효율성이 더 높아집니다.

serviceRegistered() 및 serviceUnregistered()도 참조하십시오 .

[signal] void QDBusServiceWatcher::serviceRegistered(const QString &serviceName)

이 객체가 버스에서 serviceName 서비스가 사용 가능해졌음을 감지할 때마다 이 신호가 발생합니다.

serviceUnregistered() 및 serviceOwnerChanged()도 참조하십시오 .

[signal] void QDBusServiceWatcher::serviceUnregistered(const QString &serviceName)

이 객체가 serviceName 서비스가 버스에서 등록 해제되어 더 이상 사용할 수 없게 된 것을 감지할 때마다 이 신호가 발생합니다.

serviceRegistered() 및 serviceOwnerChanged()도 참조하십시오 .

void QDBusServiceWatcher::setConnection(const QDBusConnection &connection)

이 객체가 연결된 D-Bus 연결을 connection 로 설정합니다. 감시 중인 모든 서비스가 이 연결로 이전됩니다.

QDBusConnection 객체는 참조 카운트가 적용된다는 점에 유의하십시오. 즉, ` QDBusServiceWatcher `은 이 연결이 존재하는 동안 해당 연결에 대한 참조를 유지합니다. 참조 카운트가 0이 될 때까지 연결은 닫히지 않으므로, 이를 통해 이 ` QDBusServiceWatcher ` 객체가 존재하는 동안 모든 알림을 수신할 수 있습니다.

connection()도 참조하십시오 .

void QDBusServiceWatcher::setWatchedServices(const QStringList &services)

감시 대상 D-Bus 서비스 목록을 services 로 설정합니다.

목록 전체를 설정하면 기존 서비스 감시 규칙이 모두 제거되고 새로운 규칙이 추가된다는 점에 유의하십시오. 이는 리소스 소모가 큰 작업이므로 가능하면 피해야 합니다. 대신, 가능하면 addWatchedService() 및 removeWatchedService()를 사용하여 목록 내 항목을 조작하십시오.

watchedServices 에 대한 기존 바인딩을 모두 제거합니다.

watchedServices()도 참조하십시오 .

QStringList QDBusServiceWatcher::watchedServices() const

감시 중인 D-Bus 서비스 목록을 반환합니다.

setWatchedServices()도 참조하십시오 .