summaryrefslogtreecommitdiffstats
path: root/kparts/design.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce4a32fe52ef09d8f5ff1dd22c001110902b60a2 (patch)
tree5ac38a06f3dde268dc7927dc155896926aaf7012 /kparts/design.h
downloadtdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.tar.gz
tdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.zip
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
Diffstat (limited to 'kparts/design.h')
-rw-r--r--kparts/design.h28
1 files changed, 28 insertions, 0 deletions
diff --git a/kparts/design.h b/kparts/design.h
new file mode 100644
index 000000000..ba608d777
--- /dev/null
+++ b/kparts/design.h
@@ -0,0 +1,28 @@
+/**
+ * @mainpage Framework for KDE graphical components
+ *
+ *
+ *
+ * This library implements the framework for KDE parts, which are
+ * elaborate widgets with a user-interface defined in terms of actions
+ * (menu items, toolbar icons). See KParts::Part.
+ *
+ * The library also provides a framework for applications that want to
+ * use parts. Such applications need to inherit their main window
+ * from KParts::MainWindow and provide a so-called shell GUI,
+ * which provides a basic skeleton GUI with part-independent functionality/actions.
+ *
+ * Some KParts applications won't be specific to a given part, but expect
+ * to be able to embed, for instance, all types of viewers out there. For this
+ * the basic functionality of any viewer has been implemented in
+ * KParts::ReadOnlyPart, which viewer-like parts should inherit from.
+ * The same applies to KParts::ReadWritePart, which is for editor-like parts.
+ *
+ * You can add actions to an existing KParts app from "outside", defining
+ * the code for those actions in a shared library. This mechanism is
+ * obviously called plugins, and implemented by KParts::Plugin.
+ *
+ * For a complete, and very simple, example of how to use KParts to display
+ * any kind of file (i.e. making a generic viewer), see the docu for
+ * KParts::ComponentFactory::createPartInstanceFromQuery()
+ */