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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
/*!
\page index.html
\title Qtopia - the Qt palmtop environment
Qtopia is a graphical environment for Linux on a handheld PC or small device.
<ul>
<li><a href=start.html>Getting started with Qtopia development</a>
<li><a href=refman.html>Qtopia Library Reference Manual</a>
<li><a href=../index.html>Qt Library Reference Manual</a>
</ul>
*/
/*!
\page refman.html
\title Qtopia Library Reference Manual
<h2>Overview</h2>
Qtopia applications share a common look and feel through a shared application
framework. This documentation describes that framework to the audience
of developers intending to write new applications and to modify existing
applications.
<ul>
<li> <a href=mainfunc.html>The <tt>main()</tt> function.</a>
<li> <a href=docwidget.html>The main document widget.</a>
<li> <a href=qcop.html>QCop messages.</a>
<li> <a href=classes.html>Library classes.</a>
<li> <a href=functions.html>All functions.</a>
</ul>
*/
/*!
\page mainfunc.html
\title The <tt>main()</tt> function
The <tt>main()</tt> function of all applications should following
this example:
\code
int main( int argc, char **argv )
{
QPEApplication a( argc, argv );
Main m;
a.showMainWidget(&m);
a.exec();
}
\endcode
If the application is <a href=docwidget.html>document-oriented</a>, the
call to <tt>QPEApplication::showMainWidget()</tt>
should be replaced by a call to
<tt>\l QPEApplication::showMainDocumentWidget() </tt>.
The application window should be implemented in a self-contained way -
it should not perform application-level operations such as testing parameters,
calling exit(), or calling quit() - all that is handled by QPEApplication.
Your application window should call close() if it needs to explicitly
close, and it must be prepared for the possibility that show() will be
called before the application window destructor. In other words,
implement your application window in a way that it could be used easily
from other applications - and that is a good rule to follow anyway, as
it means that most of your program can be trivially reused on Qt/X11, Qt/Windows,
Qt/Mac, and any other ports of the Qt API.
*/
/*!
\page docwidget.html
\title The main document widget
Applications which view or edit a particular type or types of files are
called <i>document-oriented</i> applications. Qtopia has framework
support to simplify the implementation of such applications. The
<a href=mainfunc.html>main()</a> function is slightly different in
these applications.
The top-level widget of a document-oriented application must have a
Qt slot named:
\code
public slot:
void setDocument( const QString& applnk_filename );
\endcode
This slot should then be implemented to save the applications current
document (if any) and show/edit the specified document. An example
implementation is:
\code
void Main::setDocument( const QString& applnk_filename )
{
FileManager fm;
if ( current ) {
if ( !fm.saveFile( *current, data ) ) {
// error
return;
}
delete current;
}
current = new DocLnk(applnk_filename);
if ( !fm.loadFile(*current, data ) ) {
// error
}
}
\endcode
*/
/*!
\page classes.html
\title Library Classes
\annotatedclasslist
*/
/*!
\page headers.html
\title Header Files
\headerfilelist
*/
/*!
\page functions.html
\title All Functions
\functionindex
*/
|
