Skip to main content
Version: Next

SET MENU ITEM PARAMETER

SET MENU ITEM PARAMETER ( menu ; menuItem ; param )

ParameterTypeDescription
menuInteger, TextMenu reference or Menu number
menuItemIntegerNumber of menu item or -1 for the last item added to the menu
paramTextString to associate as parameter

This command is not thread-safe, it cannot be used in preemptive code.

Description

The SET MENU ITEM PARAMETER command associates a custom character string with a menu item designated by the menu and menuItem parameters.

This parameter is mainly used by the Dynamic pop up menu command.

Example

This code provides a menu including the names of the open windows and lets you get the number of the window chosen:

 WINDOW LIST($alWindow)
 $tMenuRef:=Create menu
 For($i;1;Size of array($alWindow))
    APPEND MENU ITEM($tMenuRef;Get window title($alWindow{$i})) // Title of menu item
    SET MENU ITEM PARAMETER($tMenuRef;-1;String($alWindow{$i})) // Value returned by menu item
 End for
 $tWindowRef:=Dynamic pop up menu($tMenuRef)
 RELEASE MENU($tMenuRef)

See also

Dynamic pop up menu
Get menu item parameter
Get selected menu item parameter