navFormReceiveDone (Function)

This function must be called when the program is done using the received form.

Note that the received form is only valid after a "Form received" event is raised; the event will be removed when this function is called.

Input:

None.

Returns: INT

Declaration:

FUNCTION navFormReceiveDone : INT;

Example:

INCLUDE rtcu.inc
 
VAR
   form : navFormReceive;
   str  : STRING;
END_VAR;
 
FUNCTION ReadForm;
   form();
   IF form.ready THEN
      DebugMsg(message := "*** submitted form received ***");
      DebugFmt(message := "-id=\4", v4 := form.ID);
      DebugFmt(message := "-version=\4", v4 := form.version);
      DebugFmt(message := "-time=\4", v4 := form.time);
 
      // Read field 13
      navFormReceiveReadText(ID := 13, text := str);
 
      navFormReceiveDone();
   END_IF;
END_FUNCTION;
 
THREAD_BLOCK navMonitor;
VAR
   event : INT := 0;
END_VAR;
 
WHILE event <> -1 DO
   event := navWaitEvent(timeout := -1);
   CASE event OF
      ...
      14: ReadForm();
      ...
   END_CASE;
END_WHILE;
END_THREAD_BLOCK;