|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE reference |
|
11 PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd"> |
|
12 <reference id="GUID-71909C6D-297C-50A9-99BB-FEBC67389954" xml:lang="en"><title>Conditions</title><abstract><p>A <codeph>condition</codeph> can be structured in any of the |
|
13 following ways: </p><table id="GUID-B95AB521-6EB8-5592-B2A4-125DAD0214BD"> |
|
14 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
15 <thead> |
|
16 <row> |
|
17 <entry>Name</entry> |
|
18 <entry>Usage</entry> |
|
19 </row> |
|
20 </thead> |
|
21 <tbody> |
|
22 <row> |
|
23 <entry><p> <xref href="GUID-71909C6D-297C-50A9-99BB-FEBC67389954.dita#GUID-71909C6D-297C-50A9-99BB-FEBC67389954/GUID-97BFD6F4-3139-5469-8701-2916CD7745BA"> condition-primitive</xref> </p> </entry> |
|
24 <entry><p> <codeph>(condition)</codeph> </p> </entry> |
|
25 </row> |
|
26 <row> |
|
27 <entry><p> <codeph>AND</codeph> </p> </entry> |
|
28 <entry><p> <codeph>(condition) AND (condition)</codeph> </p> </entry> |
|
29 </row> |
|
30 <row> |
|
31 <entry><p> <codeph>OR</codeph> </p> </entry> |
|
32 <entry><p> <codeph>(condition) OR (condition)</codeph> </p> </entry> |
|
33 </row> |
|
34 <row> |
|
35 <entry><p> <codeph>NOT</codeph> </p> </entry> |
|
36 <entry><p> <codeph>NOT(condition)</codeph> </p> <p> <b>Note</b>: Specify |
|
37 the condition within braces, when using <codeph>IF</codeph> statement with <codeph>NOT</codeph> operator. |
|
38 For example: </p> <codeblock id="GUID-2DA29151-E682-5BFF-B4AC-ABCD6B726CBE" xml:space="preserve">IF NOT (MachineUid = 0x101fb3dd)</codeblock> </entry> |
|
39 </row> |
|
40 </tbody> |
|
41 </tgroup> |
|
42 </table></abstract><prolog><metadata><keywords/></metadata></prolog><refbody> |
|
43 <section id="GUID-97BFD6F4-3139-5469-8701-2916CD7745BA"><title>condition-primitive</title> <p>A <codeph>condition-primitive</codeph> can |
|
44 be any of the following: </p> <table id="GUID-1C03207A-D960-5BEE-9330-EFA265418300"> |
|
45 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
46 <thead> |
|
47 <row> |
|
48 <entry>Usage</entry> |
|
49 <entry>Description</entry> |
|
50 </row> |
|
51 </thead> |
|
52 <tbody> |
|
53 <row> |
|
54 <entry><p> <codeph>attrib=value</codeph> </p> </entry> |
|
55 <entry><p>Condition to test the <codeph>Equal to</codeph> expression. </p> </entry> |
|
56 </row> |
|
57 <row> |
|
58 <entry><p> <codeph>attrib<>value</codeph> </p> </entry> |
|
59 <entry><p>Condition to test the <codeph>Less than or greater than</codeph> expression </p> </entry> |
|
60 </row> |
|
61 <row> |
|
62 <entry><p> <codeph>attrib>value</codeph> </p> </entry> |
|
63 <entry><p>Condition to test the <codeph>Greater than</codeph> expression. </p> </entry> |
|
64 </row> |
|
65 <row> |
|
66 <entry><p> <codeph>attrib<value</codeph> </p> </entry> |
|
67 <entry><p>Condition to test the <codeph>Less than</codeph> expression. </p> </entry> |
|
68 </row> |
|
69 <row> |
|
70 <entry><p> <codeph>attrib>=value</codeph> </p> </entry> |
|
71 <entry><p>Condition to test the <codeph>Greater than or equal to</codeph> expression. </p> </entry> |
|
72 </row> |
|
73 <row> |
|
74 <entry><p> <codeph>attrib<=value</codeph> </p> </entry> |
|
75 <entry><p>Condition to test <codeph>Less than or equal to</codeph> expression. </p> </entry> |
|
76 </row> |
|
77 <row> |
|
78 <entry><p> <codeph>exists(filename)</codeph> </p> </entry> |
|
79 <entry><p>Tests for the existence of a file. </p> </entry> |
|
80 </row> |
|
81 <row> |
|
82 <entry><p> <codeph>appprop(uid,propid)</codeph> </p> </entry> |
|
83 <entry><p>Retrieves the properties from another registry entry. </p> </entry> |
|
84 </row> |
|
85 <row> |
|
86 <entry><p> <codeph>package(package_uid)</codeph> </p> </entry> |
|
87 <entry><p>Tests for the existence of an installed package. </p> </entry> |
|
88 </row> |
|
89 <row> |
|
90 <entry><p> <codeph>version(package_uid,rel_operator,v_major,v_minor,v_build) |
|
91 </codeph> </p> </entry> |
|
92 <entry><p>Tests for the existence of a specific version of the installed package. </p> <p>v_major |
|
93 = major component of the version (range 0-127); v_minor = minor component |
|
94 of the version (range 0-99); v_build = build component of the version (range |
|
95 0-32,767) </p> </entry> |
|
96 </row> |
|
97 </tbody> |
|
98 </tgroup> |
|
99 </table> <p id="GUID-8D2AE716-03BD-5EC2-929A-9F268F811C40"><b>attrib</b> </p> <p> <codeph>attrib</codeph> can |
|
100 be one of the attributes defined in <codeph>HALData::TAttribute</codeph>. |
|
101 These attributes correspond to hardware properties of the device. It must |
|
102 be specified in uppercase and without the initial letter <codeph>E</codeph>. |
|
103 The following attributes are supported: </p> <table id="GUID-C06BDE17-DCB2-52E5-82D9-54C36A3EE6D6"> |
|
104 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
105 <tbody> |
|
106 <row> |
|
107 <entry><p> <b>PKG variable name</b> </p> </entry> |
|
108 <entry><p> <b>HALData attribute (as retrieved by HAL::Get())</b> </p> </entry> |
|
109 </row> |
|
110 <row> |
|
111 <entry><p> <codeph>MANUFACTURER</codeph> </p> </entry> |
|
112 <entry><p> <codeph>HALData::EManufacturer </codeph> </p> </entry> |
|
113 </row> |
|
114 <row> |
|
115 <entry><p> <codeph>MANUFACTURERHARDWAREREV</codeph> </p> </entry> |
|
116 <entry><p> <codeph>HALData::EManufacturerHardwareRev </codeph> </p> </entry> |
|
117 </row> |
|
118 <row> |
|
119 <entry><p> <codeph>MANUFACTURERSOFTWAREREV</codeph> </p> </entry> |
|
120 <entry><p> <codeph>HALData::EManufacturerSoftwareRev </codeph> </p> </entry> |
|
121 </row> |
|
122 <row> |
|
123 <entry><p> <codeph>MANUFACTURERSOFTWAREBUILD</codeph> </p> </entry> |
|
124 <entry><p> <codeph>HALData::EManufacturerSoftwareBuild </codeph> </p> </entry> |
|
125 </row> |
|
126 <row> |
|
127 <entry><p> <codeph>MODEL</codeph> </p> </entry> |
|
128 <entry><p> <codeph>HALData::EModel </codeph> </p> </entry> |
|
129 </row> |
|
130 <row> |
|
131 <entry><p> <codeph>MACHINEUID</codeph> </p> </entry> |
|
132 <entry><p> <codeph> HALData::EMachineUid </codeph> </p> </entry> |
|
133 </row> |
|
134 <row> |
|
135 <entry><p> <codeph>DEVICEFAMILY</codeph> </p> </entry> |
|
136 <entry><p> <codeph> HALData::EDeviceFamily </codeph> </p> </entry> |
|
137 </row> |
|
138 <row> |
|
139 <entry><p> <codeph>DEVICEFAMILYREV</codeph> </p> </entry> |
|
140 <entry><p> <codeph>HALData::EDeviceFamilyRev</codeph> </p> </entry> |
|
141 </row> |
|
142 <row> |
|
143 <entry><p> <codeph>CPU</codeph> </p> </entry> |
|
144 <entry><p> <codeph> HALData::ECPU</codeph> </p> </entry> |
|
145 </row> |
|
146 <row> |
|
147 <entry><p> <codeph>CPUARCH</codeph> </p> </entry> |
|
148 <entry><p> <codeph>HALData::ECPUArch </codeph> </p> </entry> |
|
149 </row> |
|
150 <row> |
|
151 <entry><p> <codeph>CPUABI</codeph> </p> </entry> |
|
152 <entry><p> <codeph>HALData::ECPUABI</codeph> </p> </entry> |
|
153 </row> |
|
154 <row> |
|
155 <entry><p> <codeph>CPUSPEED</codeph> </p> </entry> |
|
156 <entry><p> <codeph>HALData::ECPUSpeed</codeph> </p> </entry> |
|
157 </row> |
|
158 <row> |
|
159 <entry><p> <codeph>SYSTEMTICKPERIOD</codeph> </p> </entry> |
|
160 <entry><p> <codeph>HALData::ESystemTickPeriod</codeph> </p> </entry> |
|
161 </row> |
|
162 <row> |
|
163 <entry><p> <codeph>MEMORYRAM</codeph> </p> </entry> |
|
164 <entry><p> <codeph>HALData::EMemoryRAM</codeph> </p> </entry> |
|
165 </row> |
|
166 <row> |
|
167 <entry><p> <codeph>MEMORYRAMFREE</codeph> </p> </entry> |
|
168 <entry><p> <codeph>HALData::EMemoryRAMFree</codeph> </p> </entry> |
|
169 </row> |
|
170 <row> |
|
171 <entry><p> <codeph>MEMORYROM</codeph> </p> </entry> |
|
172 <entry><p> <codeph> HALData::EMemoryROM</codeph> </p> </entry> |
|
173 </row> |
|
174 <row> |
|
175 <entry><p> <codeph>MEMORYPAGESIZE</codeph> </p> </entry> |
|
176 <entry><p> <codeph>HALData::EMemoryPageSize</codeph> </p> </entry> |
|
177 </row> |
|
178 <row> |
|
179 <entry><p> <codeph>POWERBACKUP</codeph> </p> </entry> |
|
180 <entry><p> <codeph> HALData::EPowerBackup </codeph> </p> </entry> |
|
181 </row> |
|
182 <row> |
|
183 <entry><p> <codeph>KEYBOARD</codeph> </p> </entry> |
|
184 <entry><p> <codeph>HALData::EKeyboard </codeph> </p> </entry> |
|
185 </row> |
|
186 <row> |
|
187 <entry><p> <codeph>KEYBOARDDEVICEKEYS</codeph> </p> </entry> |
|
188 <entry><p> <codeph>HALData::EKeyboardDeviceKeys</codeph> </p> </entry> |
|
189 </row> |
|
190 <row> |
|
191 <entry><p> <codeph>KEYBOARDAPPKEYS</codeph> </p> </entry> |
|
192 <entry><p> <codeph>HALData::EKeyboardAppKeys </codeph> </p> </entry> |
|
193 </row> |
|
194 <row> |
|
195 <entry><p> <codeph>KEYBOARDCLICK</codeph> </p> </entry> |
|
196 <entry><p> <codeph>HALData::EKeyboardClick </codeph> </p> </entry> |
|
197 </row> |
|
198 <row> |
|
199 <entry><p> <codeph>KEYBOARDCLICKVOLUMEMAX</codeph> </p> </entry> |
|
200 <entry><p> <codeph> HALData::EKeyboardClickVolumeMax </codeph> </p> </entry> |
|
201 </row> |
|
202 <row> |
|
203 <entry><p> <codeph>DISPLAYXPIXELS</codeph> </p> </entry> |
|
204 <entry><p> <codeph> HALData::EDisplayXPixels</codeph> </p> </entry> |
|
205 </row> |
|
206 <row> |
|
207 <entry><p> <codeph>DISPLAYYPIXELS</codeph> </p> </entry> |
|
208 <entry><p> <codeph> HALData::EDisplayYPixels</codeph> </p> </entry> |
|
209 </row> |
|
210 <row> |
|
211 <entry><p> <codeph>DISPLAYXTWIPS</codeph> </p> </entry> |
|
212 <entry><p> <codeph>HALData::EDisplayXTwips</codeph> </p> </entry> |
|
213 </row> |
|
214 <row> |
|
215 <entry><p> <codeph>DISPLAYYTWIPS</codeph> </p> </entry> |
|
216 <entry><p> <codeph> HALData::EDisplayYTwips </codeph> </p> </entry> |
|
217 </row> |
|
218 <row> |
|
219 <entry><p> <codeph>DISPLAYCOLORS</codeph> </p> </entry> |
|
220 <entry><p> <codeph> HALData::EDisplayColors </codeph> </p> </entry> |
|
221 </row> |
|
222 <row> |
|
223 <entry><p> <codeph>DISPLAYCONTRASTMAX</codeph> </p> </entry> |
|
224 <entry><p> <codeph>HALData::EDisplayContrastMax </codeph> </p> </entry> |
|
225 </row> |
|
226 <row> |
|
227 <entry><p> <codeph>BACKLIGHT</codeph> </p> </entry> |
|
228 <entry><p> <codeph>HALData::EBacklight </codeph> </p> </entry> |
|
229 </row> |
|
230 <row> |
|
231 <entry><p> <codeph>PEN</codeph> </p> </entry> |
|
232 <entry><p> <codeph>HALData::EPen</codeph> </p> </entry> |
|
233 </row> |
|
234 <row> |
|
235 <entry><p> <codeph>PENX</codeph> </p> </entry> |
|
236 <entry><p> <codeph>HALData::EPenX</codeph> </p> </entry> |
|
237 </row> |
|
238 <row> |
|
239 <entry><p> <codeph>PENY</codeph> </p> </entry> |
|
240 <entry><p> <codeph>HALData::EPenY </codeph> </p> </entry> |
|
241 </row> |
|
242 <row> |
|
243 <entry><p> <codeph>PENDISPLAYON</codeph> </p> </entry> |
|
244 <entry><p> <codeph>HALData::EPenDisplayOn </codeph> </p> </entry> |
|
245 </row> |
|
246 <row> |
|
247 <entry><p> <codeph>PENCLICK</codeph> </p> </entry> |
|
248 <entry><p> <codeph>HALData::EPenClick</codeph> </p> </entry> |
|
249 </row> |
|
250 <row> |
|
251 <entry><p> <codeph>PENCLICKVOLUMEMAX</codeph> </p> </entry> |
|
252 <entry><p> <codeph> HALData::EPenClickVolumeMax </codeph> </p> </entry> |
|
253 </row> |
|
254 <row> |
|
255 <entry><p> <codeph>MOUSE</codeph> </p> </entry> |
|
256 <entry><p> <codeph>HALData::EMouse</codeph> </p> </entry> |
|
257 </row> |
|
258 <row> |
|
259 <entry><p> <codeph>MOUSEX</codeph> </p> </entry> |
|
260 <entry><p> <codeph> HALData::EMouseX</codeph> </p> </entry> |
|
261 </row> |
|
262 <row> |
|
263 <entry><p> <codeph>MOUSEY</codeph> </p> </entry> |
|
264 <entry><p> <codeph>HALData::EMouseY</codeph> </p> </entry> |
|
265 </row> |
|
266 <row> |
|
267 <entry><p> <codeph>MOUSEBUTTONS</codeph> </p> </entry> |
|
268 <entry><p> <codeph> HALData::EMouseButtons</codeph> </p> </entry> |
|
269 </row> |
|
270 <row> |
|
271 <entry><p> <codeph>CASESWITCH</codeph> </p> </entry> |
|
272 <entry><p> <codeph>HALData::ECaseSwitch </codeph> </p> </entry> |
|
273 </row> |
|
274 <row> |
|
275 <entry><p> <codeph>LEDS</codeph> </p> </entry> |
|
276 <entry><p> <codeph>HALData::ELEDs</codeph> </p> </entry> |
|
277 </row> |
|
278 <row> |
|
279 <entry><p> <codeph>INTEGRATEDPHONE</codeph> </p> </entry> |
|
280 <entry><p> <codeph>HALData::EIntegratedPhone</codeph> </p> </entry> |
|
281 </row> |
|
282 <row> |
|
283 <entry><p> <codeph>DISPLAYBRIGHTNESS</codeph> </p> </entry> |
|
284 <entry><p> <codeph>HALData::EDisplayBrightness</codeph> </p> </entry> |
|
285 </row> |
|
286 <row> |
|
287 <entry><p> <codeph>DISPLAYBRIGHTNESSMAX</codeph> </p> </entry> |
|
288 <entry><p> <codeph> HALData::EDisplayBrightnessMax</codeph> </p> </entry> |
|
289 </row> |
|
290 <row> |
|
291 <entry><p> <codeph>KEYBOARDBACKLIGHTSTATE</codeph> </p> </entry> |
|
292 <entry><p> <codeph>HALData::EKeyboardBacklightState</codeph> </p> </entry> |
|
293 </row> |
|
294 <row> |
|
295 <entry><p> <codeph>ACCESSORYPOWER</codeph> </p> </entry> |
|
296 <entry><p> <codeph>HALData::EAccessoryPower</codeph> </p> </entry> |
|
297 </row> |
|
298 <row> |
|
299 <entry><p> <codeph>SYSTEMDRIVE</codeph> </p> </entry> |
|
300 <entry><p> <codeph>HALData::ESystemDrive </codeph> </p> </entry> |
|
301 </row> |
|
302 <row> |
|
303 <entry><p> <codeph>FPHARDWARE</codeph> </p> </entry> |
|
304 <entry><p> <codeph>HALData::EHardwareFloatingPoint</codeph> </p> </entry> |
|
305 </row> |
|
306 <row> |
|
307 <entry><p> <codeph>NUMHALATTRIBUTES</codeph> </p> </entry> |
|
308 <entry><p> <codeph>HALData::ENumHalAttributes </codeph> </p> </entry> |
|
309 </row> |
|
310 </tbody> |
|
311 </tgroup> |
|
312 </table> <p>The following attributes, which are not stored in the HAL, can |
|
313 additionally be specified: </p> <table id="GUID-86E7846C-3B2C-5DC3-959F-E193DDA31E48"> |
|
314 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
315 <thead> |
|
316 <row> |
|
317 <entry>Attribute</entry> |
|
318 <entry>Description</entry> |
|
319 </row> |
|
320 </thead> |
|
321 <tbody> |
|
322 <row> |
|
323 <entry><p> <codeph>LANGUAGE</codeph> </p> </entry> |
|
324 <entry><p>An integer that identifies the language selected by the Symbian |
|
325 device user, during installation. For possible values, see the <xref href="GUID-698538DF-DCDC-347B-BD32-DD9EB896BAFB.dita"><apiname>TLanguage</apiname></xref> enumeration |
|
326 defined in <filepath>e32lang.h</filepath>. </p> <p> <b>Note</b>: It is recommended |
|
327 to use language blocks to install language-specific files. </p> </entry> |
|
328 </row> |
|
329 <row> |
|
330 <entry><p> <codeph>Option<n></codeph> </p> </entry> |
|
331 <entry><p>Specifies the options that are displayed to the Symbian device user |
|
332 during installation. See <xref href="GUID-FF82B80D-18CA-5333-83EB-3AB94F696016.dita">Option-List</xref> for |
|
333 more information. </p> </entry> |
|
334 </row> |
|
335 </tbody> |
|
336 </tgroup> |
|
337 </table> </section> |
|
338 </refbody></reference> |