summaryrefslogtreecommitdiff
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--library/applicationinterface.h33
-rw-r--r--library/fontfactoryinterface.h15
-rw-r--r--library/imagecodecinterface.h13
-rw-r--r--library/qpeapplication.cpp6
-rw-r--r--library/qpeapplication.h40
-rw-r--r--library/styleinterface.h24
6 files changed, 116 insertions, 15 deletions
diff --git a/library/applicationinterface.h b/library/applicationinterface.h
index b37a2c5..b7648f6 100644
--- a/library/applicationinterface.h
+++ b/library/applicationinterface.h
@@ -17,11 +17,44 @@
17#endif 17#endif
18#endif 18#endif
19 19
20
21/**
22 * \brief Application interface currently used by the quicklaunch framework
23 *
24 * This is the interface to be exposed by applications available as DSO
25 * Normally one would use the OApplicationFactory which does the magic of
26 * exposing the interface.
27 *
28 *
29 * Resulting dynamic shared objects (dso) need to go into the
30 * OPIEDIR/plugins/application.
31 *
32 *
33 * You can use this interface to load applications into your application.
34 * @todo Implement Services + Trader
35 * @since Opie 1.0.2
36 */
20struct ApplicationInterface : public QUnknownInterface 37struct ApplicationInterface : public QUnknownInterface
21{ 38{
22public: 39public:
40
41 /**
42 * \brief create the mainwindow for the giving application name
43 * Create a main window for the giving application name
44 *
45 * @param appName The application widget to be created
46 * @param parent The parent of the newly created widget
47 * @param name The name of the QObject
48 * @param f Possible Window Flags
49 *
50 * @return the widget or 0l
51 */
23 virtual QWidget *createMainWindow( const QString &appName, QWidget *parent=0, 52 virtual QWidget *createMainWindow( const QString &appName, QWidget *parent=0,
24 const char *name=0, Qt::WFlags f=0 ) = 0; 53 const char *name=0, Qt::WFlags f=0 ) = 0;
54
55 /**
56 * The list of application windows supported
57 */
25 virtual QStringList applications() const = 0; 58 virtual QStringList applications() const = 0;
26}; 59};
27 60
diff --git a/library/fontfactoryinterface.h b/library/fontfactoryinterface.h
index ed65dfa..68b0be5 100644
--- a/library/fontfactoryinterface.h
+++ b/library/fontfactoryinterface.h
@@ -33,6 +33,21 @@ class QFontFactory;
33#endif 33#endif
34#endif 34#endif
35 35
36
37/**
38 * \brief Interface for additional Font Factories
39 *
40 * To add special types of fonts TrueTypes or your very own
41 * format. If you implement this Interface you can add
42 * custom font loading.
43 *
44 * The dynamic shared object goes to
45 * OPIEDIR/plugins/fontfactories.
46 *
47 * As of version Opie 1.0.2 loading of the plugins is not
48 * yet implemented
49 *
50 */
36struct FontFactoryInterface : public QUnknownInterface 51struct FontFactoryInterface : public QUnknownInterface
37{ 52{
38 virtual QFontFactory *fontFactory() = 0; 53 virtual QFontFactory *fontFactory() = 0;
diff --git a/library/imagecodecinterface.h b/library/imagecodecinterface.h
index 8306b68..3b1cd7b 100644
--- a/library/imagecodecinterface.h
+++ b/library/imagecodecinterface.h
@@ -29,6 +29,19 @@
29#endif 29#endif
30#endif 30#endif
31 31
32
33/**
34 *
35 * \brief add Image Codecs
36 *
37 * This interface will be queried to add new Image loading
38 * and saving routines.
39 *
40 * The ImageCodec needs to be placed in OPIEDIR/plugins/imagecodecs.
41 *
42 * @see QImage
43 * @see QImageIO
44 **/
32struct ImageCodecInterface : public QUnknownInterface 45struct ImageCodecInterface : public QUnknownInterface
33{ 46{
34public: 47public:
diff --git a/library/qpeapplication.cpp b/library/qpeapplication.cpp
index a97efc0..6f2e43b 100644
--- a/library/qpeapplication.cpp
+++ b/library/qpeapplication.cpp
@@ -435,8 +435,8 @@ static void setTreble( int t = 0, int percent = -1 )
435} 435}
436 436
437 437
438/*! 438/**
439 \class QPEApplication qpeapplication.h 439 \class QPEApplication
440 \brief The QPEApplication class implements various system services 440 \brief The QPEApplication class implements various system services
441 that are available to all Qtopia applications. 441 that are available to all Qtopia applications.
442 442
@@ -1571,6 +1571,7 @@ void QPEApplication::pidMessage( const QCString& msg, const QByteArray& data)
1571*/ 1571*/
1572void QPEApplication::showMainWidget( QWidget* mw, bool nomaximize ) 1572void QPEApplication::showMainWidget( QWidget* mw, bool nomaximize )
1573{ 1573{
1574 setMainWidget(mw);
1574 d->show(mw, nomaximize ); 1575 d->show(mw, nomaximize );
1575} 1576}
1576 1577
@@ -1591,6 +1592,7 @@ void QPEApplication::showMainDocumentWidget( QWidget* mw, bool nomaximize )
1591 Global::setDocument( mw, QString::fromUtf8(argv()[1]) ); 1592 Global::setDocument( mw, QString::fromUtf8(argv()[1]) );
1592 1593
1593 1594
1595 setMainWidget(mw);
1594 d->show(mw, nomaximize ); 1596 d->show(mw, nomaximize );
1595} 1597}
1596 1598
diff --git a/library/qpeapplication.h b/library/qpeapplication.h
index 729cf2b..3ef8b46 100644
--- a/library/qpeapplication.h
+++ b/library/qpeapplication.h
@@ -37,7 +37,45 @@ class QPEApplicationData;
37class QWSEvent; 37class QWSEvent;
38class QWSKeyEvent; 38class QWSKeyEvent;
39 39
40 40/**
41 \brief The QPEApplication class implements various system services
42 that are available to all Qtopia applications.
43
44 Simply by using QPEApplication instead of QApplication, a standard Qt
45 application becomes a Qtopia application. It automatically follows
46 style changes, quits and raises, and in the
47 case of \link docwidget.html document-oriented\endlink applications,
48 changes the currently displayed document in response to the environment.
49
50 To create a \link docwidget.html document-oriented\endlink
51 application use showMainDocumentWidget(); to create a
52 non-document-oriented application use showMainWidget(). The
53 keepRunning() function indicates whether the application will
54 continue running after it's processed the last \link qcop.html
55 QCop\endlink message. This can be changed using setKeepRunning().
56
57 A variety of signals are emitted when certain events occur, for
58 example, timeChanged(), clockChanged(), weekChanged(),
59 dateFormatChanged() and volumeChanged(). If the application receives
60 a \link qcop.html QCop\endlink message on the application's
61 QPE/Application/\e{appname} channel, the appMessage() signal is
62 emitted. There are also flush() and reload() signals, which
63 are emitted when synching begins and ends respectively - upon these
64 signals, the application should save and reload any data
65 files that are involved in synching. Most of these signals will initially
66 be received and unfiltered through the appMessage() signal.
67
68 This class also provides a set of useful static functions. The
69 qpeDir() and documentDir() functions return the respective paths.
70 The grabKeyboard() and ungrabKeyboard() functions are used to
71 control whether the application takes control of the device's
72 physical buttons (e.g. application launch keys). The stylus' mode of
73 operation is set with setStylusOperation() and retrieved with
74 stylusOperation(). There are also setInputMethodHint() and
75 inputMethodHint() functions.
76
77 \ingroup qtopiaemb
78*/
41class QPEApplication : public QApplication 79class QPEApplication : public QApplication
42{ 80{
43 Q_OBJECT 81 Q_OBJECT
diff --git a/library/styleinterface.h b/library/styleinterface.h
index 8a900c7..872a4a5 100644
--- a/library/styleinterface.h
+++ b/library/styleinterface.h
@@ -25,9 +25,9 @@
25#define IID_Style QUuid( 0x17af792c, 0xe461, 0x49a9, 0x9b, 0x71, 0x06, 0x8b, 0x9a, 0x8d, 0xda, 0xe4) 25#define IID_Style QUuid( 0x17af792c, 0xe461, 0x49a9, 0x9b, 0x71, 0x06, 0x8b, 0x9a, 0x8d, 0xda, 0xe4)
26#endif 26#endif
27 27
28// {6C33B4F9-D529-453A-8FB3-DA42B21872BD} 28// {6C33B4F9-D529-453A-8FB3-DA42B21872BD}
29# ifndef IID_StyleExtended 29# ifndef IID_StyleExtended
30# define IID_StyleExtended QUuid( 0x6c33b4f9, 0xd529, 0x453a, 0x8f, 0xb3, 0xda, 0x42, 0xb2, 0x18, 0x72, 0xbd) 30# define IID_StyleExtended QUuid( 0x6c33b4f9, 0xd529, 0x453a, 0x8f, 0xb3, 0xda, 0x42, 0xb2, 0x18, 0x72, 0xbd)
31#endif 31#endif
32 32
33#endif 33#endif
@@ -40,27 +40,27 @@ class QStyle;
40 40
41struct StyleInterface : public QUnknownInterface 41struct StyleInterface : public QUnknownInterface
42{ 42{
43 //! Return a new style. 43 /*! Return a new style.*/
44 virtual QStyle *style() = 0; 44 virtual QStyle *style() = 0;
45 //! Return a short name for the style. 45 /*! Return a short name for the style. */
46 virtual QString name() const = 0; 46 virtual QString name() const = 0;
47}; 47};
48 48
49struct StyleExtendedInterface : public StyleInterface 49struct StyleExtendedInterface : public StyleInterface
50{ 50{
51 //! Return a (longer) description for the style. 51 /*! Return a (longer) description for the style. */
52 virtual QString description ( ) const = 0; 52 virtual QString description ( ) const = 0;
53 53
54 //! Does this style support customization 54 /*! Does this style support customization */
55 virtual bool hasSettings ( ) const = 0; 55 virtual bool hasSettings ( ) const = 0;
56 56
57 //! Return a new settings page. 57 /*! Return a new settings page. */
58 virtual QWidget *create ( QWidget *parent, const char *name = 0 ) = 0; 58 virtual QWidget *create ( QWidget *parent, const char *name = 0 ) = 0;
59 59
60 //! Callback for appearance app when OK is clicked (return true when style has to re-applied). 60 /*! Callback for appearance app when OK is clicked (return true when style has to re-applied). */
61 virtual bool accept ( ) = 0; 61 virtual bool accept ( ) = 0;
62 62
63 //! Callback for appeaeance app when Cancel is clicked. 63 /*! Callback for appeaeance app when Cancel is clicked. */
64 virtual void reject ( ) = 0; 64 virtual void reject ( ) = 0;
65}; 65};
66 66