navFormAddTime (Function)

 Top  Previous  Next

Architecture:

NX32 / NX32L

Device support:

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

Firmware version:

4.70 / 1.30.00

Nav. API level:

12

This function will add a time field to the form that is currently being constructed.

 

This field can be read from a received form by using navFormReceiveReadDateTime.

 

 

Input:

id : DINT (1..2147483647)

Unique ID to identify the field.

 

title : STRING

The title of the field. Max. 50 characters.

 

desc : STRING

The description of the field to show below the title while no value has been entered. Max. 60 characters.

 

required : BOOL (default FALSE)

Set to true to make the field required.

 

linsec : DINT (default -1)

The linsec of the default time. Set to -1 to use the current time.

 

 

Returns: INT

0

- Success.

-1

- The form could not be found. Call navFormCreate first.

-3

- There is not space for more fields on the form.

-8

- Invalid parameter.

 

Declaration:

FUNCTION navFormAddTime : INT;
VAR_INPUT
  id         : DINT;
  title     : STRING;
  desc       : STRING;
  required   : BOOL := FALSE;
  linsec     : DINT := -1;
END_VAR;

 

Example:

INCLUDE rtcu.inc
 
PROGRAM NavigationExample;
VAR
  rc : INT;
END_VAR;
BEGIN
  ...
  // Add time field to the form.
  rc := navFormAddTime(id:=5, title:="Time", desc:="Select time");
  DebugFmt(message := "Add time=\1", v1 := rc);
  ...
END;
END_PROGRAM;