C# SDK

◆ ApplicationEvents

enum ApplicationEvents
strong

ApplicationEvents enum enumerates events that Drive can generate.
Drive events can be processed by registering ApplicationHandler in InitApi function.

Enumerator
EVENT_APP_STARTED 

Event occurs when application starts

EVENT_APP_CLOSED 

Event occurs when application is terminated

EVENT_ROUTE_USERCANCEL 

Event occurs when user cancel the route.

EVENT_WAIPOINT_VISITED 

Event occurs when a waypoint is visited. The strData parameter will return the waypoint ID.

EVENT_WAYPOINT_VISITED 

Event occurs when a waypoint is visited. The strData parameter will return the waypoint ID.

EVENT_ROUTE_FINISH 

Event occurs when user reaches route destination.

EVENT_ROUTE_COMPUTED 

Event occurs when new route is computed.

EVENT_OFF_ROUTE 

Event occurs when a route is recomputed.

EVENT_ITINERARY_CHANGED 
EVENT_ITINERARY_WARNING 
EVENT_OPTIMIZATION_FINISHED 

Event occurs when optimization is finished.

EVENT_OFF_ROUTE_EXT 

Event occurs when a route is recomputed. Data contains information about itinerary ID.

EVENT_INVISIBLE_WAYPOINT_VISITED 

Event occurs when a invisible waypoint is visited. The strData parameter will return the waypoint ID.

EVENT_APP_EXIT 

Event occurs when application was closed by user.

EVENT_MAIN_MENU 

Event occurs when user click on the navigation window

EVENT_CONTEXT_MENU 

Event occurs when user show context menu. Context menu is located at the bottom of the navigation screen.

EVENT_EXIT_MENU 

Event occurs when return to navigation from any menu

EVENT_CUSTOM_MENU 

Event occurs after user clicks on some custom button in the menu. The strData parameter will return the command parameter (defined in menu.ini file) of this button.

EVENT_CHANGE_LANGUAGE 

Event occurs when user change language of Drive application. The strData contains the name of the lang file, e.g. if user selects English in the menu, it returns "english.lang"

EVENT_CHANGE_ORIENTATION 

Event occurs when user change screen orientation of Drive application. The strData has the values "1", "2", "3" or "4", according to the screen rotation.

EVENT_RADAR_WARNING 

Event occurs when a radar warning is invoked. The strData parameter has following format: "%d,%d".
First parameter is speed camera type (see SpeedCameraType enum)
Second parameter is allowed speed (km / h)

EVENT_POI_WARNING 

Event occurs when a poi warning is invoked. The strData parameter has following format: "%s,%s,{%d,%d}"
First parameter is category name (use CApplicationAPI.GetPoiCategoryList function to get list of poi categories)
Second parameter is POI name
Third parameter is longitude
Fourth parameter is latitude

EVENT_GEOFENCE 

Event occurs when a geofence interference is invoked. The strData parameter has following format: "%d,%d"
First parameter is geofence event type. 0 mean enter to the restricted area, 1 mean leave the restricted area. Second parameter is restricted area ID

EVENT_RESTRICTED_ROAD 

Event occurs when a restricted road interference is invoked.

EVENT_BORDER_CROSSING 

Event occurs when the border is crossed

EVENT_SPEED_EXCEEDING 

Event occurs when the speed limit is exceeded

EVENT_SPEED_LIMIT_CHANGED 

Event occurs when the speed limit is changed

EVENT_BITMAP_CLICK 

Event occurs when the user click on bitmap in browsemap

EVENT_POI_CLICK 

POI was clicked. Data contains string "{category_name},{poi_name},{lon,lat}"

EVENT_WAYPOINT_CLICKED 

Waypoint was clicked. Data contains ID of waypoint (if set) or order of waypoint in itinerary (if ID was not set)

EVENT_BROWSE_MAP_EXIT 

Event occurs when you exit browsing map.

EVENT_SHARE_POSITION 

Position was shared from the app menu (Special setting must be turned on to enable this feature). Data contains JSON: { "lat": (int), "lon": (int) }

EVENT_WAYPOINT_MARKED_AS_VISITED 

Event occurs when waypoint is marked as visited. Data contains info about waypoint ID and trigger of this event ("manual" or "sdk")