PopMenu

Description

Displays a menu at the specified location.

Applies to

Menu objects

Syntax

menuname.PopMenu ( xlocation, ylocation )

Argument

Description

menuname

The fully qualified name of a menu on a menu bar you want to display at the specified location

xlocation

The distance in PowerBuilder units of the displayed menu from the left edge of the window

ylocation

The distance in PowerBuilder units of the displayed menu from the top of the window


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.)

Calling PopMenu in an object script

PopMenu must be called in an object script. It should not be called in a global function.

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:

m_Emp.M_Procedures.PopMenu(100, 200)

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

m_Appl.M_file.PopMenu(PointerX(), PointerY())

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):

Menu4 NewMenu
NewMenu = CREATE Menu4
NewMenu.m_language.PopMenu(PointerX(), PointerY())

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

NewMenu.m_language.PopMenu( &
   w_frame.PointerX(), w_frame.PointerY())