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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
/***************************************************************************
instance.h - description
-------------------
begin : Tue Aug 13 2002
copyright : (C) 2002 by Marc Britton <consume@optushome.com.au>
(C) 2004 by Andras Mantia <amantia@kde.org>
(C) 2004 by Michal Rudolf <mrudolf@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 INSTANCE_H
#define INSTANCE_H
/* QT INCLUDES */
#include <qstring.h>
#include <qstringlist.h>
#include <qobject.h>
#include <qmap.h>
#include <qguardedptr.h>
/* KDE INCLUDES */
#include <kurl.h>
/* OTHER INCLUDES */
#include "dcopkommanderif.h"
/* FORWARD DECLARATIONS */
class QWidget;
class QDialog;
class QFile;
class KommanderWidget;
class Instance : public QObject, virtual public DCOPKommanderIf
{
Q_OBJECT
public:
Instance();
Instance(QWidget*);
~Instance();
/* passing global variables: two forms are accepted.
kdmr-executor file.kmdr COUNT=45 PATH=/tmp - this adds global variables 45 and PATH
kmdr-executor file.kmdr 45 /tmp - this adds global variables ARG1 and ARG2
ARGS holds space-separated list of all second-type variables (like Bash $@)
ARGCOUNT holds number of second-type arguments
*/
virtual void addCmdlineArguments(const QStringList& args);
//DCOP methods. The documentation is in the widgets/specials.cpp file.
virtual void setEnabled(const QString& widgetName, bool enable);
virtual void enableWidget(const QString& widgetName, bool enable); /* DEPRECATED */
virtual void setVisible(const QString& widgetName, bool enable);
virtual void setText(const QString& widgetName, const QString& text);
virtual void changeWidgetText(const QString& widgetName, const QString& text); /* DEPRECATED */
virtual QString text(const QString& widgetName);
virtual void setSelection(const QString& widgetName, const QString& text);
virtual void setCurrentListItem(const QString& widgetName, const QString& text); /* DEPRECATED */
virtual QString selection(const QString& widgetName);
virtual int currentItem(const QString &widgetName);
virtual QString item(const QString &widgetName, int index);
virtual int itemDepth(const QString &widgetName, int index);
virtual QString itemPath(const QString &widgetName, int index);
virtual void removeItem(const QString &widgetName, int index);
virtual void removeListItem(const QString &widgetName, int index); /* DEPRECATED */
virtual void insertItem(const QString &widgetName, const QString &item, int index);
virtual void addListItem(const QString &widgetName, const QString &item, int index); /* DEPRECATED */
virtual void setPixmap(const QString &widgetName, const QString &iconName, int index);
virtual void insertItems(const QString &widgetName, const QStringList &items, int index);
virtual void addListItems(const QString &widgetName, const QStringList &items, int index);/*DEPRECATED*/
virtual void addUniqueItem(const QString &widgetName, const QString &item);
virtual int findItem(const QString &widgetName, const QString &item);
virtual void clear(const QString &widgetName);
virtual void clearList(const QString &widgetName); /* DEPRECATED */
virtual void setCurrentItem(const QString &widgetName, int index);
virtual void setCurrentTab(const QString &widgetName, int index); /* DEPRECATED */
virtual void insertTab(const QString &widgetName, const QString &label, int index);
virtual void setChecked(const QString &widgetName, bool checked);
virtual bool checked(const QString &widgetName);
virtual void setAssociatedText(const QString &widgetName, const QString &text);
virtual QStringList associatedText(const QString &widgetName);
virtual QString type(const QString& widget);
virtual QStringList children(const QString& parent, bool recursive);
virtual QString global(const QString& variableName);
virtual void setGlobal(const QString& variableName, const QString& value);
virtual void setMaximum(const QString &widgetName, int value);
virtual QString execute(const QString &widgetName);
virtual void cancel(const QString &widgetName);
virtual int count(const QString &widgetName);
virtual int currentColumn(const QString &widgetName);
virtual int currentRow(const QString &widgetName);
virtual void insertRow(const QString &widgetName, int row, int count);
virtual void insertColumn(const QString &widgetName, int column, int count);
virtual void setCellText(const QString &widgetName, int row, int column, const QString& text);
virtual QString cellText(const QString &widgetName, int row, int column);
virtual void removeRow(const QString &widgetName, int row, int count);
virtual void removeColumn(const QString &widgetName, int column, int count);
virtual void setRowCaption(const QString &widgetName, int row, const QString& text);
virtual void setColumnCaption(const QString &widgetName, int column, const QString& text);
virtual int getWinID();
virtual void setBusyCursor(bool busy);
QWidget *widget() { return m_instance;}
public slots:
/** Sets the instance's parent */
void setParent(QWidget*);
/** Returns whether the instance is built */
bool isBuilt() const;
/** Builds the instance. Uses stdin if no filename is given */
bool build(const KURL& fname);
/** Executes the instance which was built before */
bool run();
private:
/** Check if the file exists, has correct extension and is not in a temporary (insecure) directory */
bool isFileValid(const KURL& fname) const;
/* Dialog Instance */
QGuardedPtr<QWidget> m_instance;
/* Associated Text Instance */
KommanderWidget *m_textInstance;
/** The parent widget */
QWidget *m_parent;
/* Get object by name */
QObject* stringToWidget(const QString& name);
/* Cast to Kommander widget if possible */
KommanderWidget* kommanderWidget(QObject* object);
};
#endif
|
