navFormGetPos (Function)

Architecture:	NX32 / NX32L
Firmware version:	4.70 / 1.30.00
Nav. API level:	12

This function retrieves the position of a form on the navigation device.

Input:

id : DINT

ID of the form to get the position of.

Returns: INT

>0	- The position of the form
-1	- Navigation interface is not open.
-2	- Error communicating with navigation device.
-11	- Forms are not supported.
-12	- Navigation interface is busy.

Declaration:

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

Example:

INCLUDE rtcu.inc

PROGRAM NavigationExample;
VAR
   rc : INT;
END_VAR;
BEGIN
   ...
   // Get position of form 55
   rc := navFormGetPos(id := 55);
   ...
END;
END_PROGRAM;