summaryrefslogtreecommitdiffstats
path: root/kopete/protocols/irc/libkirc/kircmessageredirector.h
blob: e6fbda8090a2da9e4cd5814db940580a59c0f1ae (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
/*
    kircmessageredirector.h - IRC Client

    Copyright (c) 2004      by Michel Hermier <michel.hermier@wanadoo.fr>

    Kopete    (c) 2004      by the Kopete developers <kopete-devel@kde.org>

    *************************************************************************
    *                                                                       *
    * This program is free software; you can redistribute it and/or modify  *
    * it under the terms of the GNU General Public License as published by  *
    * the Free Software Foundation; either version 2 of the License, or     *
    * (at your option) any later version.                                   *
    *                                                                       *
    *************************************************************************
*/

#ifndef KIRC_MESSAGEREDIRECTOR_H
#define KIRC_MESSAGEREDIRECTOR_H

#include <tqobject.h>
#include <tqstring.h>

namespace KIRC
{

class Engine;

class Message;

class MessageRedirector
	: public TQObject
{
	Q_OBJECT
  TQ_OBJECT

public:
	enum {
		Unknown = -1,
		Unlimited = -2
	};

	MessageRedirector(KIRC::Engine *engine,
		int argsSize_min = KIRC::MessageRedirector::Unknown,
		int argsSize_max = KIRC::MessageRedirector::Unknown,
		const TQString &helpMessage = TQString());

	/**
	 * Connects the given object member signal/slot to this message redirector.
	 * The member signal slot should be looking like:
	 * TQT_SIGNAL(mysignal(KIRC::Message &msg))
	 * or
	 * TQT_SIGNAL(myslot(KIRC::Message &msg))
	 */
	bool connect(TQObject *object, const char *member);

	/**
	 * Attempt to send the message.
	 * @return a not empty TQStringList on errors or no slots connected.
	 * 	The returned string list contains all the errors.
	 */
	TQStringList operator()(KIRC::Message &msg);

	void error(TQString &errorMessage);

	TQString helpMessage();

signals:
	void redirect(KIRC::Message &);

private:
	/**
	 * Check that the given message as the correct number of args
	 * and do some message format checks.
	 */
	bool checkValidity(const KIRC::Message &msg);

	TQStringList m_errors;

	int m_argsSize_min;
	int m_argsSize_max;
	TQString m_helpMessage;
};

}

#endif