guiControlRemove (Function)

This function removes the provided control, and releases the resources associated with it.

Input:

control : SYSHANDLE

A handle to the control. Will be made invalid once the control is removed.

Returns: INT

Declaration:

FUNCTION guiControlRemove : INT;
VAR_INPUT
   control : ACCESS SYSHANDLE;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
VAR
   rc     : INT;
   button : SYSHANDLE;
END_VAR;
 
BEGIN
   ...
   // Remove handle
   rc := guiControlRemove(control := button);
   ...
END;
END_PROGRAM;