summaryrefslogtreecommitdiff
path: root/docs/qcop.doc
Unidiff
Diffstat (limited to 'docs/qcop.doc') (more/less context) (ignore whitespace changes)
-rw-r--r--docs/qcop.doc2
1 files changed, 1 insertions, 1 deletions
diff --git a/docs/qcop.doc b/docs/qcop.doc
index 6fe4c71..e62f91d 100644
--- a/docs/qcop.doc
+++ b/docs/qcop.doc
@@ -1,179 +1,179 @@
1/*! 1/*!
2 2
3\page qcop.html 3\page qcop.html
4 4
5\title QCop Messages 5\title QCop Messages
6 6
7QCop messages allow applications to communicate with each other. 7QCop messages allow applications to communicate with each other.
8These messages are send using QCopEnvelope, and received by connecting 8These messages are send using QCopEnvelope, and received by connecting
9to a QCopChannel. 9to a QCopChannel.
10 10
11The <tt>channelname</tt> of channels within Qtopia all start with "QPE/". 11The <tt>channelname</tt> of channels within Qtopia all start with "QPE/".
12The <tt>messagename</tt> is a function identifier followed by a list of types 12The <tt>messagename</tt> is a function identifier followed by a list of types
13in parentheses. There are no spaces in the message name. 13in parentheses. There are no spaces in the message name.
14 14
15The variable names shown in this documentation are purely for information 15The variable names shown in this documentation are purely for information
16purposes. A message shown as 16purposes. A message shown as
17"messageName(Type1 varname1, Type2 varname2, Type2 varname3)" would be 17"messageName(Type1 varname1, Type2 varname2, Type2 varname3)" would be
18used in program code as: 18used in program code as:
19 19
20\code 20\code
21 QCopEnvelope e(channelname, "messageName(Type1,Type2,Type2)"); 21 QCopEnvelope e(channelname, "messageName(Type1,Type2,Type2)");
22 e << parameter1 << parameter2 << parameter3; 22 e << parameter1 << parameter2 << parameter3;
23\endcode 23\endcode
24 24
25 25
26The system-wide channels and messages. 26The system-wide channels and messages.
27 27
28<dl> 28<dl>
29<dt><b>QPE/System</b> 29<dt><b>QPE/System</b>
30 <dd> 30 <dd>
31 <ul> 31 <ul>
32 <li>busy() 32 <li>busy()
33 <br> Causes a wait indicator to be shown to the user. 33 <br> Causes a wait indicator to be shown to the user.
34 <li>notBusy() 34 <li>notBusy()
35 <br> Cancels the wait indicator. 35 <br> Cancels the wait indicator.
36 <li>linkChanged(QString) 36 <li>linkChanged(QString)
37 <br> Sent whenever a link is changed. 37 <br> Sent whenever a link is changed.
38 It is sent by FileManager::saveFile() and others, and 38 It is sent by FileManager::saveFile() and others, and
39 received by the Launcher. 39 received by the Launcher.
40 <li>applyStyle() 40 <li>applyStyle()
41 <br> Sent when user changes style. 41 <br> Sent when user changes style.
42 It is received by QPEApplication and the application 42 It is received by QPEApplication and the application
43 will redraw accordingly. 43 will redraw accordingly.
44 <li>quit() 44 <li>quit()
45 <br> Terminates the Qtopia environment. 45 <br> Terminates the Qtopia environment.
46 <li>shutdown() 46 <li>shutdown()
47 <br> Terminates the system. 47 <br> Terminates the system.
48 <li>restart() 48 <li>restart()
49 <br> Restarts the Qtopia environment. 49 <br> Restarts the Qtopia environment.
50 <li>execute(QString) 50 <li>execute(QString)
51 <br> Executes or raises the given application. 51 <br> Executes or raises the given application.
52 <li>execute(QString,QString) 52 <li>execute(QString,QString)
53 <br> Executes or raises the given application, passing an argument. 53 <br> Executes or raises the given application, passing an argument.
54 Note that you should consider using the 54 Note that you should consider using the
55 <b>QPE/Application/<i>appname</i></b> channels described below. 55 <b>QPE/Application/<i>appname</i></b> channels described below.
56 <li>addAlarm(QDateTime,QCString,QCString,int) 56 <li>addAlarm(QDateTime,QCString,QCString,int)
57 <br> Internal. See AlarmServer::addAlarm() 57 <br> Internal. See AlarmServer::addAlarm()
58 <li>deleteAlarm(QDateTime,QCString,QCString,int) 58 <li>deleteAlarm(QDateTime,QCString,QCString,int)
59 <br> Internal. See AlarmServer::deleteAlarm() 59 <br> Internal. See AlarmServer::deleteAlarm()
60 <li>setDefaultRotation(int) 60 <li>setDefaultRotation(int)
61 <br> Internal. 61 <br> Internal.
62 <li>grabKeyboard(QString) 62 <li>grabKeyboard(QString)
63 <br> Internal. 63 <br> Internal.
64 <li>timeChange(QString) 64 <li>timeChange(QString)
65 <br> Internal. 65 <br> Internal.
66 <li>clockChange(bool) 66 <li>clockChange(bool)
67 <br> Internal. 67 <br> Internal.
68 <li>setScreenSaverInterval(int) 68 <li>setScreenSaverInterval(int)
69 <br> Internal. 69 <br> Internal.
70 <li>language(QString) 70 <li>language(QString)
71 <br> Internal. 71 <br> Internal.
72 </ul> 72 </ul>
73 73
74<dt><b>QPE/Sync</b> 74<dt><b>QPE/Sync</b>
75 <ul> 75 <ul>
76 <li>flush() 76 <li>flush()
77 <br> Sent at the start of synchronization. Synchable applications 77 <br> Sent at the start of synchronization. Synchable applications
78 should save any synchable data to disk. 78 should save any synchable data to disk.
79 <i>Note: this message is currently asynchronous. Stay tuned 79 <i>Note: this message is currently asynchronous. Stay tuned
80 to discussions regarding synchronization, as this message 80 to discussions regarding synchronization, as this message
81 may become synchronous, requiring slight midification to 81 may become synchronous, requiring slight midification to
82 your code. For now, just respond in a timely fashion, 82 your code. For now, just respond in a timely fashion,
83 since the sync server merely waits a small time.</i> 83 since the sync server merely waits a small time.</i>
84 <li>reload() 84 <li>reload()
85 <br> Sent at the end of synchronization. Synchable applications 85 <br> Sent at the end of synchronization. Synchable applications
86 should reload any synchable data from disk. 86 should reload any synchable data from disk.
87 </ul> 87 </ul>
88 88
89<dt><b>QPE/TaskBar</b> 89<dt><b>QPE/TaskBar</b>
90 <ul> 90 <ul>
91 <li>message(QString) 91 <li>message(QString)
92 <br> Internal. See Global::statusMessage() 92 <br> Internal. See Global::statusMessage()
93 <li>showInputMethod() 93 <li>showInputMethod()
94 <br> Internal. 94 <br> Internal.
95 <li>hideInputMethod() 95 <li>hideInputMethod()
96 <br> Internal. 96 <br> Internal.
97 <li>reloadInputMethods() 97 <li>reloadInputMethods()
98 <br> Internal. 98 <br> Internal.
99 <li>reloadApplets() 99 <li>reloadApplets()
100 <br> Internal. 100 <br> Internal.
101 </ul> 101 </ul>
102 102
103<dt><b>QPE/Card</b> 103<dt><b>QPE/Card</b>
104 <ul> 104 <ul>
105 <li>stabChanged() 105 <li>stabChanged()
106 <br> Sent when <tt>/var/run/stab</tt>, <tt>/var/state/pcmcia/stab</tt>, 106 <br> Sent when <tt>/var/run/stab</tt>, <tt>/var/state/pcmcia/stab</tt>,
107 or <tt>/var/lib/pcmcia/stab</tt> may have changed. 107 or <tt>/var/lib/pcmcia/stab</tt> may have changed.
108 <li>netUp() 108 <li>netUp()
109 <br> Sent when a network connection is running. 109 <br> Sent when a network connection is running.
110 <li>netDown() 110 <li>netDown()
111 <br> Sent when a network connection is available, but not running. 111 <br> Sent when a network connection is available, but not running.
112 <li>netUnavailable() 112 <li>netUnavailable()
113 <br> Sent when a network connection is not available. 113 <br> Sent when a network connection is not available.
114 </ul> 114 </ul>
115 115
116<dt><b>Qt/Tray</b> 116<dt><b>Qt/Tray</b>
117 This channel allows Qt applications (not just Qtopia applications) 117 This channel allows Qt applications (not just Qtopia applications)
118 to show system-tray status in a cross-platform manner, 118 to show system-tray status in a cross-platform manner,
119 but it is not currently supported. See TaskbarAppletInterface for 119 but it is not currently supported. See TaskbarAppletInterface for
120 a more powerful alternative for system tray applications. 120 a more powerful alternative for system tray applications.
121 <ul> 121 <ul>
122 <li>popup(int,QPoint) 122 <li>popup(int,QPoint)
123 <li>remove(int) 123 <li>remove(int)
124 <li>setIcon(int,QPixmap) 124 <li>setIcon(int,QPixmap)
125 <li>setToolTip(int,QString) 125 <li>setToolTip(int,QString)
126 <li>doubleClicked(int,QPoint) 126 <li>doubleClicked(int,QPoint)
127 <li>clicked(int,QPoint) 127 <li>clicked(int,QPoint)
128 </ul> 128 </ul>
129</dl> 129</dl>
130 130
131Each application listens on a channel called 131Each application listens on a channel called
132<b>QPE/Application/<i>appname</i></b>, where <b><i>appname</i></b> is 132<b>QPE/Application/<i>appname</i></b>, where <b><i>appname</i></b> is
133the executable name (the application identifier). Standard messages on 133the executable name (the application identifier). Standard messages on
134this channel are: 134this channel are:
135 135
136<dl> 136<dl>
137 <dt><b>QPE/Application/<i>appname</i></b> 137 <dt><b>QPE/Application/<i>appname</i></b>
138 <ul> 138 <ul>
139 <li>setDocument(QString) 139 <li>setDocument(QString)
140 <br>Internal. Causes the setDocument(const QString&) slot 140 <br>Internal. Causes the setDocument(const QString&) slot
141 of <a href=docwidget.html>the main document widget</a> 141 of <a href=docwidget.html>the main document widget</a>
142 to be called. 142 to be called.
143 <li>nextView() 143 <li>nextView()
144 <br>Applications connected to hardware buttons will receive 144 <br>Applications connected to hardware buttons will receive
145 this message if they are already visible. 145 this message if they are already visible.
146 <li>raise() 146 <li>raise()
147 <br>Internal. Causes the the main document widget and the 147 <br>Internal. Causes the the main document widget and the
148 current modal widget to be raised. 148 current modal widget to be raised.
149 <li>quit() 149 <li>quit()
150 <br>Internal. Terminates the application. 150 <br>Internal. Terminates the application.
151 <li>quitIfInvisible() 151 <li>quitIfInvisible()
152 <br>Internal. Terminates the application if it is not shown. 152 <br>Internal. Terminates the application if it is not shown.
153 </ul> 153 </ul>
154</dl> 154</dl>
155 155
156The QPE/Application/<i>appname</i> channel has a special property: when 156The QPE/Application/<i>appname</i> channel has a special property: when
157messages are sent to these channels vie QCopEnvelope, the message is 157messages are sent to these channels vie QCopEnvelope, the message is
158delivered even if the application is not yet running (the application 158delivered even if the application is not yet running (the application
159is run and the message is then sent). 159is run and the message is then sent).
160 160
161Applications also respond to messages specific to the application. 161Applications also respond to messages specific to the application.
162Such messages in the base Qtopia applications are: 162Such messages in the base Qtopia applications are:
163 163
164<dl> 164<dl>
165 <dt><b>QPE/Application/helpbrowser</b> 165 <dt><b>QPE/Application/helpbrowser</b>
166 <ul> 166 <ul>
167 <li>showFile(QString <i>file</i>) 167 <li>showFile(QString <i>file</i>)
168 <br>Send this message to have the Help Browser show a file. 168 <br>Send this message to have the Help Browser show a file.
169 The <i>file</i> may be an absolute filename or relative 169 The <i>file</i> may be an absolute filename or relative
170 to the system HTML documentation directory ($QPEDIR/help/html). 170 to the system HTML documentation directory ($OPIEDIR/help/html).
171 </ul> 171 </ul>
172 <dt><b>QPE/Application/datebook</b> 172 <dt><b>QPE/Application/datebook</b>
173 <ul> 173 <ul>
174 <li>alarm(QDateTime,int) 174 <li>alarm(QDateTime,int)
175 <br>Internal. Causes the Calendar application to sound alarms. 175 <br>Internal. Causes the Calendar application to sound alarms.
176 </ul> 176 </ul>
177</dl> 177</dl>
178 178
179*/ 179*/