PopMenu – PB Docs 2017

Description

Displays a menu at the specified location.

Applies to

Menu objects

Syntax

Return value

Integer. Returns 1 if it succeeds and -1 if an error occurs. If any
argument’s value is null, PopMenu returns null.

Usage

If the menu object is not associated with the window so that it was
opened when the window was opened, you must use CREATE to allocated memory
for the menu (see the last example).

If the Visible property of the menu is false, you must make the menu
visible before you can display it as a pop-up menu.

The coordinates you specify for PopMenu are relative to the active
window. In an MDI application, the coordinates are relative to the frame
window, which is the active window. To display a menu at the cursor
position, call PointerX and PointerY for the active window (the frame
window in an MDI application) to get the coordinates of the cursor. (See
the examples.)

Examples

These statements display the menu m_Emp.M_Procedures at location
100, 200 in the active window. M_Emp is the menu associated with the
window:

This statement displays the menu m_Appl.M_File at the cursor
position, where m_Appl is the menu associated with the window.

These statements display a pop-up menu at the cursor position.
Menu4 was created in the Menu painter and includes a menu called
m_language. Menu4 is not the menu for the active window. NewMenu is an
instance of Menu4 (datatype Menu4):

In an MDI application, the last line would include the MDI frame as
the object for the pointer functions: