summaryrefslogtreecommitdiffstats
path: root/quanta/parts/kafka/nodeenhancer.h
blob: 6e8bc44c9164e7ad2420833e5600568ab8b8fb5d (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
/***************************************************************************
                             nodeenhancer.h
                             -------------------

    copyright            : (C) 2003, 2004 - Nicolas Deschildre
    email                : ndeschildre@kdewebdev.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 NODEENHANCER_H
#define NODEENHANCER_H

class KConfig;
class Node;
namespace DOM
{
	class Node;
}

/**
 * Base class which define an interface to enhance DOM::Nodes
 * i.e. to modify the corresponding DOM::Node of a Node.
 * The aim is to modify the kafka view to provide visual aids
 * like a error system which highlight syntax error, and so on...
 * Defining this in XML files could be a nice idea once kafka
 * support all the DTDs.
 */

class NodeEnhancer
{
public:
	NodeEnhancer(){}
	virtual ~NodeEnhancer(){}

	/**
	 * This function modify the DOM::Node of the node.
	 * The DOM::Node must be built before calling this
	 * function.
	 * @param node The Node we want to enhance.
	 * @param parentDNode the tqparent DOM::Node of the root DOM::Node of node.
	 * @param nextDNode the DOM::Node next to the root DOM::Node of node.
	 */
	virtual bool enhanceNode(Node *node, DOM::Node parentDNode, DOM::Node nextDNode) = 0;

	/**
	 * This function apply some modifications once the whole DOM::Node tree is built.
	 * @param domNode The domNode we want to add some modifications.
	 */
	virtual void postEnhanceNode(DOM::Node domNode) = 0;

	/**
	 * This function un-apply the modifications made by postEnhanceNode()
	 * @param domNode The DOM::Node we want to un-enhance!
	 */
	virtual void postUnenhanceNode(DOM::Node domNode) = 0;

	/**
	* Read the config.
	* @m_config The config to read.
	*/
	virtual void readConfig(KConfig *m_config) = 0;

	/**
	 * This need to be strongly extended.
	 */
};

#endif