guiMenuRemoveItem (Function)

Top  Previous  Next

Architecture:

NX32L

Device support:

NX-400

Firmware version:

1.00.00


This function removes an item from the menu.

 

 

Input:

menu : SYSHANDLE

The handle to the menu to remove the item from.

 

index : INT (1..8)

The index of the item to remove.

 

 

Returns: INT

0

- Success.

-1

- Interface is not open (see guiOpen).

-3

- Invalid handle or index.

-9

- The menu is currently shown and can not be altered.

-11

- The GUI API is not supported.

 

Declaration:

FUNCTION guiMenuRemoveItem : INT;
VAR_INPUT
  menu    : SYSHANDLE;
  index   : INT;
END_VAR;

 

 

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
VAR
  rc       : INT;
  menu     : SYSHANDLE;
END_VAR;
 
BEGIN
  ...
  // Remove item
  rc := guiMenuRemoveItem(menu := menu, index:=1);
  ...
END;
END_PROGRAM;