OpenPopupMenu (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing controls

OpenPopupMenu

Presentation

Example

See also

Functions for managing controls

OpenPopupMenu (Function)

In french: OuvreMenuContextuel

Automatically opens a popup menu for the current control or window.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Versions 20 and later

This function is now available for iPhone/iPad applications.

New in version 20

This function is now available for iPhone/iPad applications.

Versions 21 and later

This function is now available for Android applications.

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

New in version 21

This function is now available for Android applications.

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

This function is now available for Android applications.

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

Example

// -- Click code of BTN_Action button
OpenPopupMenu(MenuDateChoice)

Syntax

OpenPopupMenu([<Name of popup menu> [, <X> , <Y >]])

<Name of popup menu>: Optional character string (with or without quotes)

Name of the popup menu that must be opened for the current control.
If this parameter is not specified, the default popup menu associated with the control is opened.
This parameter is not available. Only the popup menu of the current control can be opened.

<X>: Integer (optional)

X coordinate of the opening position of the popup menu. This X coordinate is expressed in pixels, in relation to the top left corner of the window. If <X> and <Y> are not specified, the popup menu is opened at mouse position.
This parameter is not available:
On iPhone, the popup menu is opened according to the iPhone standard: the popup menu comes from the bottom of the screen.
On iPad, the popup menu is opened according to the iPad standard: the popup menu is displayed beside the control that triggered the menu opening.
In Android, the popup menu is opened in the middle of the screen.

<Y >: Integer (optional)

Y coordinate of the opening position of the popup menu. This Y coordinate is specified in pixels, in relation to the top left corner of the window. If <X> and <Y> are not specified, the popup menu is opened at mouse position.
This parameter is not available:
On iPhone, the popup menu is opened according to the iPhone standard: the popup menu comes from the bottom of the screen.
On iPad, the popup menu is opened according to the iPad standard: the popup menu is displayed beside the control that triggered the menu opening.
In Android, the popup menu is opened in the middle of the screen.

Remarks

This function must be run in the code associated with a control or window. This function should not be used in the code for resizing a window.
This function is a locking function until the popup menu is closed.
This function is not a locking function in iOS.
For a MDI child window, it may be interesting to open a popup menu defined in the MDI parent window. In this case, <Name of popup menu> must have the following format:

NameOfWindow.NameOfPopupMenu
This function must be used in one of the processes of the control for which the popup menu must be displayed.

Component : wd240obj.dll