guiMenuShow (Function)

 Top  Previous  Next

Architecture:

NX32L

Device support:

NX-400

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;