Table of Contents
Advertisement
4. Extending the Location−sensitive
This section explains how to extend the location−sensitive menu of Navigator with external commands.
4.1. About external commands
When Navigator is showing the map view, it's possible to tap & hold on any point of the map to get a
location−sensitive menu. The default, built−in menu can be extended with new commands that, when
selected, send a message to an external application.
In other words, an external application can be set up to receive a request from Navigator when the user
taps & holds on any location of a map and selects the appropriate command. An external application can
also let Navigator show points of interest associated with the application and send it back a request when
the user taps & holds on one of the associated points of interest and selects the appropriate command. An
example of such an application could be a guide of hotels or restaurants.
Two different types of command are thus considered: when a point of interest associated with the
external application is selected, and when an arbitrary location is selected. The points of interest associated
with the external application must be made accessible to Navigator in an external POI file, with the format
described in this section.
To extend the location−sensitive menu, the external application must provide a so−called capabilities
file that describes the application and the additional commands to be present in the location−sensitive menu
of Navigator and, optionally, the corresponding external POI file.
WARNING: IN THE CURRENT VERSION OF NAVIGATOR THE TOTAL NUMBER OF
EXTERNAL LOCATION−SENSITIVE MENU COMMANDS IS LIMITED TO TWO, AND THE
TOTAL NUMBER OF EXTERNAL TYPES OF POINTS OF INTEREST IS LIMITED TO SEVEN, SO
IT IS IMPOSSIBLE TO HAVE MORE THAN ONE EXTERNAL APPLICATION AT THE SAME
TIME.
IF
YOU
LOCATION−SENSITIVE MENU, PLEASE WARN THE USERS THAT IT WILL BE INCOMPATIBLE
WITH OTHER SOLUTIONS OF THE SAME KIND.
4.2. Capabilities files
An external application that wants to extend the location−sensitive menu has to provide a capabilities
file with extension .CAP and place it in the \TomTom\ directory of the Pocket PC. Every external
command can have an associated icon to be displayed in the location−sensitive menu. It is recommended
that several bitmaps of different sizes be provided for each icon. Navigator will select the bitmap with the
most appropriate size depending upon the circumstances. The bitmaps for a single external command are
provided in a file with extension .TMT and the format described below.
4.2.1. Format of the .CAP file
The .CAP file is a text file with the following format:
Version|«app version number»|
AppName|«app exe name»|
AppPath|«app path»|
AppMainTitle|«app main wnd title»|
AppPoiFile|«external poi file»|
AppIconFile|«app tmt file»|
PROVIDE
A
SOLUTION
Menu
THAT
REQUIRES
10
EXTENSION
OF
THE
Advertisement
Table of Contents
