author | mickeyl <mickeyl> | 2005-01-02 15:20:41 (UTC) |
---|---|---|
committer | mickeyl <mickeyl> | 2005-01-02 15:20:41 (UTC) |
commit | 71232a4e45f78041c2ab138edf45903bbf2b34ce (patch) (unidiff) | |
tree | 6c51dc86163e656c7ac6a3cd6ea7e7e0f1ab89c0 /library | |
parent | 226a83c4b4334648de408249dba61bd1f7e6dba3 (diff) | |
download | opie-71232a4e45f78041c2ab138edf45903bbf2b34ce.zip opie-71232a4e45f78041c2ab138edf45903bbf2b34ce.tar.gz opie-71232a4e45f78041c2ab138edf45903bbf2b34ce.tar.bz2 |
Add the Qtopia 1.7 SDK macros for quick-apps to easa compilation of 3rd party apps against our headers
-rw-r--r-- | library/qpeapplication.h | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/library/qpeapplication.h b/library/qpeapplication.h index 00d3d31..849d5b3 100644 --- a/library/qpeapplication.h +++ b/library/qpeapplication.h | |||
@@ -31,201 +31,214 @@ | |||
31 | #endif | 31 | #endif |
32 | #include "qpedecoration_qws.h" | 32 | #include "qpedecoration_qws.h" |
33 | #include "timestring.h" | 33 | #include "timestring.h" |
34 | #include "qpeglobal.h" | 34 | #include "qpeglobal.h" |
35 | 35 | ||
36 | class QCopChannel; | 36 | class QCopChannel; |
37 | class QPEApplicationData; | 37 | class QPEApplicationData; |
38 | class QWSEvent; | 38 | class QWSEvent; |
39 | class QWSKeyEvent; | 39 | class QWSKeyEvent; |
40 | 40 | ||
41 | /** | 41 | /** |
42 | \brief The QPEApplication class implements various system services | 42 | \brief The QPEApplication class implements various system services |
43 | that are available to all Qtopia applications. | 43 | that are available to all Qtopia applications. |
44 | 44 | ||
45 | Simply by using QPEApplication instead of QApplication, a standard Qt | 45 | Simply by using QPEApplication instead of QApplication, a standard Qt |
46 | application becomes a Qtopia application. It automatically follows | 46 | application becomes a Qtopia application. It automatically follows |
47 | style changes, quits and raises, and in the | 47 | style changes, quits and raises, and in the |
48 | case of \link docwidget.html document-oriented\endlink applications, | 48 | case of \link docwidget.html document-oriented\endlink applications, |
49 | changes the currently displayed document in response to the environment. | 49 | changes the currently displayed document in response to the environment. |
50 | 50 | ||
51 | To create a \link docwidget.html document-oriented\endlink | 51 | To create a \link docwidget.html document-oriented\endlink |
52 | application use showMainDocumentWidget(); to create a | 52 | application use showMainDocumentWidget(); to create a |
53 | non-document-oriented application use showMainWidget(). The | 53 | non-document-oriented application use showMainWidget(). The |
54 | keepRunning() function indicates whether the application will | 54 | keepRunning() function indicates whether the application will |
55 | continue running after it's processed the last \link qcop.html | 55 | continue running after it's processed the last \link qcop.html |
56 | QCop\endlink message. This can be changed using setKeepRunning(). | 56 | QCop\endlink message. This can be changed using setKeepRunning(). |
57 | 57 | ||
58 | A variety of signals are emitted when certain events occur, for | 58 | A variety of signals are emitted when certain events occur, for |
59 | example, timeChanged(), clockChanged(), weekChanged(), | 59 | example, timeChanged(), clockChanged(), weekChanged(), |
60 | dateFormatChanged() and volumeChanged(). If the application receives | 60 | dateFormatChanged() and volumeChanged(). If the application receives |
61 | a \link qcop.html QCop\endlink message on the application's | 61 | a \link qcop.html QCop\endlink message on the application's |
62 | QPE/Application/\e{appname} channel, the appMessage() signal is | 62 | QPE/Application/\e{appname} channel, the appMessage() signal is |
63 | emitted. There are also flush() and reload() signals, which | 63 | emitted. There are also flush() and reload() signals, which |
64 | are emitted when synching begins and ends respectively - upon these | 64 | are emitted when synching begins and ends respectively - upon these |
65 | signals, the application should save and reload any data | 65 | signals, the application should save and reload any data |
66 | files that are involved in synching. Most of these signals will initially | 66 | files that are involved in synching. Most of these signals will initially |
67 | be received and unfiltered through the appMessage() signal. | 67 | be received and unfiltered through the appMessage() signal. |
68 | 68 | ||
69 | This class also provides a set of useful static functions. The | 69 | This class also provides a set of useful static functions. The |
70 | qpeDir() and documentDir() functions return the respective paths. | 70 | qpeDir() and documentDir() functions return the respective paths. |
71 | The grabKeyboard() and ungrabKeyboard() functions are used to | 71 | The grabKeyboard() and ungrabKeyboard() functions are used to |
72 | control whether the application takes control of the device's | 72 | control whether the application takes control of the device's |
73 | physical buttons (e.g. application launch keys). The stylus' mode of | 73 | physical buttons (e.g. application launch keys). The stylus' mode of |
74 | operation is set with setStylusOperation() and retrieved with | 74 | operation is set with setStylusOperation() and retrieved with |
75 | stylusOperation(). There are also setInputMethodHint() and | 75 | stylusOperation(). There are also setInputMethodHint() and |
76 | inputMethodHint() functions. | 76 | inputMethodHint() functions. |
77 | 77 | ||
78 | \ingroup qtopiaemb | 78 | \ingroup qtopiaemb |
79 | */ | 79 | */ |
80 | class QPEApplication : public QApplication | 80 | class QPEApplication : public QApplication |
81 | { | 81 | { |
82 | Q_OBJECT | 82 | Q_OBJECT |
83 | public: | 83 | public: |
84 | QPEApplication( int& argc, char **argv, Type=GuiClient ); | 84 | QPEApplication( int& argc, char **argv, Type=GuiClient ); |
85 | ~QPEApplication(); | 85 | ~QPEApplication(); |
86 | 86 | ||
87 | static QString qpeDir(); | 87 | static QString qpeDir(); |
88 | static QString documentDir(); | 88 | static QString documentDir(); |
89 | void applyStyle(); | 89 | void applyStyle(); |
90 | void reset(); | 90 | void reset(); |
91 | static int defaultRotation(); | 91 | static int defaultRotation(); |
92 | static void setDefaultRotation(int r); | 92 | static void setDefaultRotation(int r); |
93 | static void setCurrentRotation(int r); | 93 | static void setCurrentRotation(int r); |
94 | static void setCurrentMode(int x, int y, int depth ); | 94 | static void setCurrentMode(int x, int y, int depth ); |
95 | static void grabKeyboard(); | 95 | static void grabKeyboard(); |
96 | static void ungrabKeyboard(); | 96 | static void ungrabKeyboard(); |
97 | 97 | ||
98 | enum StylusMode { | 98 | enum StylusMode { |
99 | LeftOnly, | 99 | LeftOnly, |
100 | RightOnHold | 100 | RightOnHold |
101 | // RightOnHoldLeftDelayed, etc. | 101 | // RightOnHoldLeftDelayed, etc. |
102 | }; | 102 | }; |
103 | static void setStylusOperation( QWidget*, StylusMode ); | 103 | static void setStylusOperation( QWidget*, StylusMode ); |
104 | static StylusMode stylusOperation( QWidget* ); | 104 | static StylusMode stylusOperation( QWidget* ); |
105 | 105 | ||
106 | enum InputMethodHint { | 106 | enum InputMethodHint { |
107 | Normal, | 107 | Normal, |
108 | AlwaysOff, | 108 | AlwaysOff, |
109 | AlwaysOn | 109 | AlwaysOn |
110 | }; | 110 | }; |
111 | 111 | ||
112 | enum screenSaverHint { | 112 | enum screenSaverHint { |
113 | Disable = 0, | 113 | Disable = 0, |
114 | DisableLightOff = 1, | 114 | DisableLightOff = 1, |
115 | DisableSuspend = 2, | 115 | DisableSuspend = 2, |
116 | Enable = 100 | 116 | Enable = 100 |
117 | }; | 117 | }; |
118 | 118 | ||
119 | static void setInputMethodHint( QWidget *, InputMethodHint ); | 119 | static void setInputMethodHint( QWidget *, InputMethodHint ); |
120 | static InputMethodHint inputMethodHint( QWidget * ); | 120 | static InputMethodHint inputMethodHint( QWidget * ); |
121 | 121 | ||
122 | void showMainWidget( QWidget*, bool nomax=FALSE ); | 122 | void showMainWidget( QWidget*, bool nomax=FALSE ); |
123 | void showMainDocumentWidget( QWidget*, bool nomax=FALSE ); | 123 | void showMainDocumentWidget( QWidget*, bool nomax=FALSE ); |
124 | 124 | ||
125 | static void showDialog( QDialog*, bool nomax=FALSE ) QPE_WEAK_SYMBOL; | 125 | static void showDialog( QDialog*, bool nomax=FALSE ) QPE_WEAK_SYMBOL; |
126 | static int execDialog ( QDialog*, bool nomax=FALSE ) QPE_WEAK_SYMBOL; | 126 | static int execDialog ( QDialog*, bool nomax=FALSE ) QPE_WEAK_SYMBOL; |
127 | static void showWidget( QWidget*, bool nomax=FALSE ) QPE_WEAK_SYMBOL; | 127 | static void showWidget( QWidget*, bool nomax=FALSE ) QPE_WEAK_SYMBOL; |
128 | /* Merge setTempScreenSaverMode */ | 128 | /* Merge setTempScreenSaverMode */ |
129 | #ifdef QTOPIA_INTERNAL_INITAPP | 129 | #ifdef QTOPIA_INTERNAL_INITAPP |
130 | void initApp( int argv, char **argv ); | 130 | void initApp( int argv, char **argv ); |
131 | #endif | 131 | #endif |
132 | 132 | ||
133 | static void setKeepRunning(); | 133 | static void setKeepRunning(); |
134 | bool keepRunning() const; | 134 | bool keepRunning() const; |
135 | 135 | ||
136 | bool keyboardGrabbed() const; | 136 | bool keyboardGrabbed() const; |
137 | 137 | ||
138 | int exec(); | 138 | int exec(); |
139 | 139 | ||
140 | signals: | 140 | signals: |
141 | void clientMoused(); | 141 | void clientMoused(); |
142 | void timeChanged(); | 142 | void timeChanged(); |
143 | void clockChanged( bool pm ); | 143 | void clockChanged( bool pm ); |
144 | void micChanged( bool muted ); | 144 | void micChanged( bool muted ); |
145 | void volumeChanged( bool muted ); | 145 | void volumeChanged( bool muted ); |
146 | void appMessage( const QCString& msg, const QByteArray& data); | 146 | void appMessage( const QCString& msg, const QByteArray& data); |
147 | void weekChanged( bool startOnMonday ); | 147 | void weekChanged( bool startOnMonday ); |
148 | void dateFormatChanged( DateFormat ); | 148 | void dateFormatChanged( DateFormat ); |
149 | void flush(); | 149 | void flush(); |
150 | void reload(); | 150 | void reload(); |
151 | /* linkChanged signal */ | 151 | /* linkChanged signal */ |
152 | 152 | ||
153 | private slots: | 153 | private slots: |
154 | void systemMessage( const QCString &msg, const QByteArray &data ); | 154 | void systemMessage( const QCString &msg, const QByteArray &data ); |
155 | void pidMessage( const QCString &msg, const QByteArray &data ); | 155 | void pidMessage( const QCString &msg, const QByteArray &data ); |
156 | void removeSenderFromStylusDict(); | 156 | void removeSenderFromStylusDict(); |
157 | void hideOrQuit(); | 157 | void hideOrQuit(); |
158 | 158 | ||
159 | protected: | 159 | protected: |
160 | bool qwsEventFilter( QWSEvent * ); | 160 | bool qwsEventFilter( QWSEvent * ); |
161 | void internalSetStyle( const QString &style ); | 161 | void internalSetStyle( const QString &style ); |
162 | void prepareForTermination(bool willrestart); | 162 | void prepareForTermination(bool willrestart); |
163 | virtual void restart(); | 163 | virtual void restart(); |
164 | virtual void shutdown(); | 164 | virtual void shutdown(); |
165 | bool eventFilter( QObject *, QEvent * ); | 165 | bool eventFilter( QObject *, QEvent * ); |
166 | void timerEvent( QTimerEvent * ); | 166 | void timerEvent( QTimerEvent * ); |
167 | bool raiseAppropriateWindow(); | 167 | bool raiseAppropriateWindow(); |
168 | virtual void tryQuit(); | 168 | virtual void tryQuit(); |
169 | #ifndef OPIE_NO_ERASE_RECT_HACKFIX | 169 | #ifndef OPIE_NO_ERASE_RECT_HACKFIX |
170 | #if QT_VERSION > 233 | 170 | #if QT_VERSION > 233 |
171 | virtual void polish ( QWidget * ); // this is actually implemented in qt_override.cpp (!) | 171 | virtual void polish ( QWidget * ); // this is actually implemented in qt_override.cpp (!) |
172 | #endif | 172 | #endif |
173 | #endif | 173 | #endif |
174 | private: | 174 | private: |
175 | void mapToDefaultAction( QWSKeyEvent *ke, int defKey ); | 175 | void mapToDefaultAction( QWSKeyEvent *ke, int defKey ); |
176 | void processQCopFile(); | 176 | void processQCopFile(); |
177 | 177 | ||
178 | #if defined(Q_WS_QWS) && !defined(QT_NO_COP) | 178 | #if defined(Q_WS_QWS) && !defined(QT_NO_COP) |
179 | QCopChannel *sysChannel; | 179 | QCopChannel *sysChannel; |
180 | QCopChannel *pidChannel; | 180 | QCopChannel *pidChannel; |
181 | #endif | 181 | #endif |
182 | QPEApplicationData *d; | 182 | QPEApplicationData *d; |
183 | 183 | ||
184 | bool reserved_sh; | 184 | bool reserved_sh; |
185 | 185 | ||
186 | }; | 186 | }; |
187 | 187 | ||
188 | 188 | ||
189 | 189 | ||
190 | enum Transformation { Rot0, Rot90, Rot180, Rot270 }; /* from qgfxtransformed_qws.cpp */ | 190 | enum Transformation { Rot0, Rot90, Rot180, Rot270 }; /* from qgfxtransformed_qws.cpp */ |
191 | 191 | ||
192 | inline int TransToDeg ( Transformation t ) | 192 | inline int TransToDeg ( Transformation t ) |
193 | { | 193 | { |
194 | int d = static_cast<int>( t ); | 194 | int d = static_cast<int>( t ); |
195 | return d * 90; | 195 | return d * 90; |
196 | } | 196 | } |
197 | 197 | ||
198 | inline Transformation DegToTrans ( int d ) | 198 | inline Transformation DegToTrans ( int d ) |
199 | { | 199 | { |
200 | Transformation t = static_cast<Transformation>( d / 90 ); | 200 | Transformation t = static_cast<Transformation>( d / 90 ); |
201 | return t; | 201 | return t; |
202 | } | 202 | } |
203 | 203 | ||
204 | /* | 204 | /* |
205 | * Set current rotation of Opie, and rotation for newly started apps. | 205 | * Set current rotation of Opie, and rotation for newly started apps. |
206 | * Differs from setDefaultRotation in that 1) it rotates currently running apps, | 206 | * Differs from setDefaultRotation in that 1) it rotates currently running apps, |
207 | * and 2) does not set deforient or save orientation to qpe.conf. | 207 | * and 2) does not set deforient or save orientation to qpe.conf. |
208 | */ | 208 | */ |
209 | 209 | ||
210 | inline void QPEApplication::setCurrentRotation( int r ) | 210 | inline void QPEApplication::setCurrentRotation( int r ) |
211 | { | 211 | { |
212 | // setTransformation has been introduced in Qt/Embedded 2.3.4 snapshots | 212 | // setTransformation has been introduced in Qt/Embedded 2.3.4 snapshots |
213 | // for compatibility with the SharpROM use fallback to setDefaultTransformation() | 213 | // for compatibility with the SharpROM use fallback to setDefaultTransformation() |
214 | #if QT_VERSION > 233 | 214 | #if QT_VERSION > 233 |
215 | Transformation e = DegToTrans( r ); | 215 | Transformation e = DegToTrans( r ); |
216 | ::setenv( "QWS_DISPLAY", QString( "Transformed:Rot%1:0" ).arg( r ).latin1(), 1 ); | 216 | ::setenv( "QWS_DISPLAY", QString( "Transformed:Rot%1:0" ).arg( r ).latin1(), 1 ); |
217 | qApp->desktop()->qwsDisplay()->setTransformation( e ); | 217 | qApp->desktop()->qwsDisplay()->setTransformation( e ); |
218 | #else | 218 | #else |
219 | setDefaultRotation( r ); | 219 | setDefaultRotation( r ); |
220 | #endif | 220 | #endif |
221 | } | 221 | } |
222 | 222 | ||
223 | /* | ||
224 | * Qtopia 1.7 SDK compatibility macros | ||
225 | * FIXME: Support Opie Quicklaunch Interface | ||
226 | */ | ||
227 | #define QTOPIA_ADD_APPLICATION(NAME,IMPLEMENTATION) \ | ||
228 | int main( int argc, char** argv ) \ | ||
229 | { \ | ||
230 | QPEApplication app = QPEApplication( argc, argv );\ | ||
231 | IMPLEMENTATION* mw = new IMPLEMENTATION(); \ | ||
232 | app.showMainWidget( mw ); \ | ||
233 | app.exec(); \ | ||
234 | } | ||
235 | #define QTOPIA_MAIN // Bee-Bop-Alula | ||
223 | 236 | ||
224 | /* | 237 | /* |
225 | * -remove me | 238 | * -remove me |
226 | */ | 239 | */ |
227 | #ifdef Q_WS_QWS | 240 | #ifdef Q_WS_QWS |
228 | extern Q_EXPORT QRect qt_maxWindowRect; | 241 | extern Q_EXPORT QRect qt_maxWindowRect; |
229 | #endif | 242 | #endif |
230 | 243 | ||
231 | #endif | 244 | #endif |