summaryrefslogtreecommitdiffstats
path: root/kparts/browserinterface.h
blob: d74b64bb28055fc3ab12e27ab6d6f09821380001 (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
#ifndef __browserinterface_h__
#define __browserinterface_h__

#include <qobject.h>
#include <qvariant.h>

#include <kdelibs_export.h>

namespace KParts
{

/**
 * The purpose of this interface is to allow a direct communication between
 * a KPart and the hosting browser shell (for example Konqueror) . A
 * shell implementing this interface can propagate it to embedded kpart
 * components by using the setBrowserInterface call of the part's
 * KParts::BrowserExtension object.
 *
 * This interface looks not very rich, but the main functionality is
 * implemented using the callMethod method for part->shell
 * communication and using Qt properties for allowing a part to
 * to explicitly query information from the shell.
 *
 * Konqueror in particular, as 'reference' implementation, provides
 * the following functionality through this interface:
 *
 * Qt properties:
 * <code>
 * Q_PROPERTY( uint historyLength READ historyLength );
 * </code>
 *
 * Callable methods:
 * <code>
 * void goHistory( int );
 * </code>
 *
 */
class KPARTS_EXPORT BrowserInterface : public QObject
{
    Q_OBJECT
public:
    BrowserInterface( QObject *parent, const char *name = 0 );
    virtual ~BrowserInterface();

    /**
     * Perform a dynamic invocation of a method in the BrowserInterface
     * implementation. Methods are to be implemented as simple Qt slots.
     */
    void callMethod( const char *name, const QVariant &argument );
};

}

#endif