nmpButtonsDefine (Function)

This function will define a number of configurable buttons on the NMP with the IDs 1.. count. It is required to call this method before any other nmpButton calls.

Note that the buttons take up space that would otherwise be used for the navigation display.

Input:

count : INT (0..10)

The number of buttons to define. Using 0 will remove all the buttons and return the used space to the navigation display.

Returns: INT

Declaration:

FUNCTION nmpButtonsDefine : INT;
VAR_INPUT
   count : SINT;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
VAR
   rc : INT;
END_VAR;
BEGIN
   ...
   // Define 3 buttons
   rc := nmpButtonsDefine(count := 3);
   IF rc <> 0 THEN
      DebugFmt(message := "Error: nmpButtonsDefine=\1", v1 := rc);
   END_IF;
   ...
END;
END_PROGRAM;