Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 103 insertions, 0 deletions

diff --git a/dnssd/query.h b/dnssd/query.h
new file mode 100644
index 000000000..793b18731
--- /dev/null
+++ b/dnssd/query.h
@@ -0,0 +1,103 @@
+/* This file is part of the KDE project
+ *
+ * Copyright (C) 2004 Jakub Stachowski <qbast@go2.pl>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public License
+ * along with this library; see the file COPYING.LIB.  If not, write to
+ * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
+ */
+
+#ifndef DNSSDQUERY_H
+#define DNSSDQUERY_H
+
+#include <qobject.h>
+#include <dnssd/remoteservice.h>
+
+
+namespace DNSSD
+{
+class QueryPrivate;
+
+/**
+This class provides way to search for specified service type in one domain. Depending on domain
+name, either multicast or unicast DNS will be used.
+ 
+@short Class that represents service query in one domain.
+@author Jakub Stachowski
+ */
+class KDNSSD_EXPORT Query : public QObject
+{
+	Q_OBJECT
+public:
+	/**
+	Creates new query. 
+
+	@param type Type of services to browse for
+	@param domain Domain name - if set to "local." multicast query will be performed,
+			otherwise unicast
+	 */
+	Query(const QString& type, const QString& domain);
+
+	virtual ~Query();
+
+	/**
+	Starts query. Ignored if query is already running
+	 */
+	virtual void startQuery();
+
+	/**
+	Returns TRUE if query is already running
+	 */
+	bool isRunning() const;
+
+	/**
+	Returns TRUE if all currently announced services has
+	been reported. It does not mean that no more services can
+	be found later and it is not related to isRunning()
+	 */
+	bool isFinished() const;
+
+	/**
+	Returns queried domain
+	 */
+	const QString& domain() const;
+
+signals:
+	/**
+	Emitted when new service has been discovered
+	 */
+	void serviceAdded(DNSSD::RemoteService::Ptr);
+
+	/**
+	Emitted when previously discovered service is not longer published
+	 */
+	void serviceRemoved(DNSSD::RemoteService::Ptr);
+
+	/**
+	Emitted when all announced services has been reported. 
+	 */
+	void finished();
+
+protected:
+	virtual void virtual_hook(int, void*);
+	virtual void customEvent(QCustomEvent* event);
+private:
+	QueryPrivate *d;
+private slots:
+	void timeout();
+};
+
+}
+
+#endif