navFormMove (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:

12


This function will move a form on the navigation device.

Depending on the position of the other forms, it may cause other forms to change position as well.

 

Input:

id : DINT

ID of the form to move.

 

new_pos : INT (1..32767)

The new position of the form.

 

 

Returns: INT

>0

- The position of the form.

-1

- Navigation interface is not open.

-2

- Error communicating with navigation device.

-4

- The navigation device rejected the command.

-8

- Invalid position.

-11

- Forms are not supported.

-12

- Navigation interface is busy.

 

Declaration:

FUNCTION navFormMove : INT;
VAR_INPUT
  id       : DINT;
  new_pos : INT;
END_VAR;

 

Example:

INCLUDE rtcu.inc
 
PROGRAM NavigationExample;
 
BEGIN
  ...
  // Move form 55 to position 10
  navFormMove(id := 55, new_pos := 10);
  ...
END;
END_PROGRAM;