For the user, the main difference between an OPA and an APP is that the APP can be made to start by up to 5 different events:
- By an Icon in the Extras bars.
- By the New File dialog in the System screen.
- By clicking on an file associated by the APP.
- By klicking on the APP file in the \System\Apps\yourapp folder.
- It is of course possible to start it from other programs too...
(Like the Help system)
Which of these are possible are decided by the APP definitionin your source code.
APP YourApp, YourKuid&
The different parts:
- APP YourApp, YourKuid&
YourApp is the name of your Application. Try to make it short AND descriptive!
YourKuid& is a unique ID number belonging to your Application. It is used among other things to identify which files belong to your App.
Symbian has 3 distinct series of numbers. One for Symbian's own Apps, One 'free for all' which can be used for Apps you make for personal use,(But DO NOT DISTRIBUTE!)
and the last is the 'third party software' series. this is the numbers you should use...
You can E-Mail a request for these numbers from Symbian. If you plan to release your App do it! The numbers are free...
- FLAGS xx
This tells the system what kind of App it's dealing with.
0 (Or rather no FLAGS) statement means NO files(Like Calc)
1 means that this App can create files. Extra information!
2 Means that this App will NOT show up on the Extras bar.
- ICON "c:\programfiles\yourapp.mbm"
This tells the system which icon to use for the App in the Extras bar, and also for the files if the App is alloved files.
The File must be in MBM(Multi BitMap or 'EPOC Picture File' in Sketch). You can specify more than one file by using additional ICON statements.
An App needs from 1 to 3 pairs of icons.(Picture and mask). You can use the same file as both...
The file(s) should contain bitmaps in theese sizes: 24x24, 32x32 and 48x48. You don't have to make all those. You can make just the biggest,
and just hope that the system makes a decent scaled down version when you change zoom levels....