PopupMenu (Property)

Find out the custom popup menu associated with a control or window.
Modify the popup menu associated with a control or window (associate another popup menu with the control or window).
Customize the system menus of controls by adding options.

Reminder: A popup menu is a menu that is opened by the user via a right mouse click. A popup menu is created in the window editor during the control description ("UI" tab). See Managing the popup menus for more details.
The arrow found on the right of control is used to edit or create a popup menu in the menu editor.

Remark: Some types of controls (edit controls, tables, ...) have a default popup menu (displayed if no custom popup menu is associated with the control). This system menu can also be disabled.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 20 and later

This property is now available for iPhone/iPad applications.

This property is now available for Table controls and table columns in Android applications.

New in version 20

This property is now available for iPhone/iPad applications.

This property is now available for Table controls and table columns in Android applications.

This property is now available for iPhone/iPad applications.

This property is now available for Table controls and table columns in Android applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Code used to modify the popup menu associated with the button
// Popup1 and Popup2 are existing popup menus
IF BTN_Button1..PopupMenu = "Popup1" THEN
BTN_Button1..PopupMenu = "Popup2"
ELSE
// Restores the default popup menu of AAFs
BTN_Button1..PopupMenu = ""
END

// Initialization code of edit control
// Adds the Popup1 menu after the system popup menu of control
// Popup1 is an existing popup menu
MySelf..PopupMenu = "+Popup1"

Syntax

Finding out the popup menu associated with a control or window Hide the details

<Menu> = <Element>..PopupMenu

<Menu>: Character string

Name of custom popup menu associated with the object,
Empty string ("") if no custom popup menu is associated with the object.

<Element>: Control name or window name

Name of control or window for which the name of custom popup menu is requested.

Modifying the popup menu associated with a control or window Hide the details

<Element>..PopupMenu = <Name of New Menu>

<Element>: Control name or window name

Name of control or window whose popup menu will be modified.

<Name of New Menu>: Character string (with or without quotes) or constant

Name of new custom popup menu associated with the object (empty string to restore the system popup menu).
To add a popup menu to the system menu, you must:
write the "+" sign in front of the menu name (to display the new menu after the options of system menu).
write the "+" sign after the menu name (to display the new menu before the options of system menu).
specify an empty string to use the default popup menu of AAFs
You also have the ability to use the following constants:
PopupMenuDisabled Used to disable the display of all the popup menus (including the system popup menus or the popup menus for the Currency + Euro edit controls).
This constant is not available.
PopupMenuSystem Used to disable the display of menu options specific to the AAFs (Automatic Application Features). Only the Windows popup menu is displayed.
Also allows you to access the Unicode options available for some Windows systems ("Read from right to left, Display the Unicode control characters, ...").
This constant is not available.

Remarks

Adding menu options into the popup menu

..PopupMenu cannot be used to cumulate the custom popup menus associated with a control. However, menu options can be added to an existing popup menu by MenuAddMenu, MenuAddOption, ... See Functions for managing menus for more details.

Popup menu and group of controls

A popup menu can be associated with a group of controls: all the controls belonging to the group will have the same popup menu. In read mode, <Result> always corresponds to an empty string ("").

Horizontal Table control

The system popup menu of the Horizontal Table controls does not contain the export options.

Changing the popup menu and storing information about the Table controls

When changing the popup menu, the persistent information previously saved for the Table control (size of columns, ...) is not available anymore. This information is re-initialized.

Limits

..PopupMenu only applies to controls in a window (including Table control columns). This property cannot be used with the menus, etc.

..PopupMenu does not apply to the following controls:

Static
Non-clickable image
Progress Bar
Shape

..PopupMenu only applies to the following elements:

Button.
Edit control.
Image.
Check Box.
Radio Button.
List Box.
Combo Box.
TreeView.
Tab.
Window.
Column of Table control.
Supercontrol.