A popup menu assigned to a form.

Syntax

[<oRef> =] new Popup(<parent> [, <name expC>])

<oRef>

A variable or property in which to store a reference to the newly created Popup object.

<parent>

The form to which you’re binding the Popup object.

<name expC>

An optional name for the Popup object. If not specified, the Popup class will auto-generate a name for the object.

Properties

The following tables list the properties, events and methods of the Popup class.

Property

Default

Description

alignment

Align Center

Aligns the popup menu horizontally relative to the right-click location (0=Align Center, 1=Align Left, 2=Align

Right).

baseClassName

POPUP

Identifies the object as an instance of the Popup class.

className

(POPUP)

Identifies the object as an instance of a custom class. When no custom class exists, defaults to baseClassName

id

-1

A supplementary ID number for the object

left

 

Sets the position of the left border.

name

 

The popup object's name.

parent

 

An object reference that points to the parent form.

top

 

Sets the position of the top border.

trackRight

true

Determines whether the popup menu responds to a right mouse click for selection of a menu item.

 

Event

Parameters

Description

beforeRelease

 

before an object is released from memory.

onInitMenu

 

After the popup menu is opened.

 

Method

Parameters

Description

open( )

 

Opens the popup menu.

release( )

 

Explicitly removes the popup object from memory.

Description

A Popup object represents a context or popup menu that is displayed when you right-click a form. You may also open the popup explicitly by calling its open( ) method.

A form may have any number of popup menu bound to it. Only one menu at time can be assigned to the form’s popupMenu property; that is the menu that appears when right-clicking the form.

The popup contains Menu objects that represent the menu items in the popup.