navFormShow (Function)

Top  Previous  Next

Architecture:

NX32 / NX32L

Device support:

MX2 turbo/encore/warp, AX9 turbo, NX-200, NX-400, NX-900

Firmware version:

4.70 / 1.30.00

Nav. API level:

21


This function will show a form on the navigation device. This can e.g. be used to show the correct form when the destination is reached, so that there is no need to look through the list of forms to find the correct one.

 

Note that some navigation devices do not support showing the form while the user is in the main menu or in some of the applications on the navigation device.

If the user must be notified to fill out the form, one possibility is to also call navPopupAlert.

 

Input:

id : DINT

ID of the form to show.

 

 

Returns: INT

0

- Success.

-1

- Navigation interface is not open.

-2

- Error communicating with navigation device.

-4

- The navigation device rejected the command.

-11

- Showing a form is not supported.

-12

- Navigation interface is busy.

 

Declaration:

FUNCTION navFormShow : INT;
VAR_INPUT
  id       : DINT;
END_VAR;

 

Example:

INCLUDE rtcu.inc
 
PROGRAM NavigationExample;
 
BEGIN
  ...
  // show form 55
  navFormShow(id := 55);
  ...
END;
END_PROGRAM;