navFormAddSelect (Function)

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

The selection field must contain 1-30 options that are added with navFormAddOption.

It supports both single selection (radio buttons) and multiple selections (check boxes).

The selected options can be read from a received form by using navFormReceiveReadSelect.

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.

multi : BOOL (default FALSE)

Set to true to allow selection of multiple options.

Returns: INT

Declaration:

FUNCTION navFormAddSelect : INT;
VAR_INPUT
  id         : DINT;
  title     : STRING;
  desc       : STRING;
  required   : BOOL := FALSE;
  multi     : BOOL := FALSE;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM NavigationExample;
VAR
  rc : INT;
END_VAR;
BEGIN
  ...
  // Add a selection field with two options to the form.
  rc := navFormAddSelect(id := 3, title:="Options", desc:="Select options",multi:=TRUE);
  DebugFmt(message := "Add select=\1", v1 := rc);
 
  rc := navFormAddOption(id:=1, select_id:=3, title:="Option 1");
  DebugFmt(message := "Add option=\1", v1 := rc);
 
  rc := navFormAddOption(id:=2, select_id:=3, title:="Option 2");
  DebugFmt(message := "Add option=\1", v1 := rc);
  ...
END;
END_PROGRAM;