guiMenuShow (Function)

Architecture:	NX32L
Firmware version:	1.00.00

This function shows the provided menu.

The menu is closed when the user selects an item, clicks outside the menu, or guiMenuClose is called.

Input:

menu : SYSHANDLE

The handle to the menu.

Returns: INT

0	- Success.
-1	- Interface is not open (see guiOpen).
-3	- Invalid handle
-9	- A menu is already visible.
-10	- No items in the menu.
-11	- The GUI API is not supported.

Declaration:

FUNCTION guiMenuShow : INT;
VAR_INPUT
menu : SYSHANDLE;
END_VAR;

Example:

INCLUDE rtcu.inc

PROGRAM test;
VAR
   rc    : INT;
   menu  : SYSHANDLE;
END_VAR;

BEGIN
   ...
   // Show the menu.
   rc := guiMenuShow(menu := menu);
   ...
END;
END_PROGRAM;