Popup Menu (PRIM_PPNL.Menu)

Popup Menu

Ancestors - Popup (PRIM_PPNL) Panel (PRIM_PANL) Container (PRIM_CPST) Control (PRIM_CTRL) Object (PRIM_OBJT)

Details

A Popup Menu is used for both right click context menus and submenus from Menu Bar and Menu Item
 
Popup Menu is a composite control and as such can contain any other controls. However, to simplify the construction, all child controls will flow down the menu item, fitting to the width.
 
Popup Menu can be used to add a context menu to a control simply by dropping one in the designer. If dropped on a Push Button it will become the drop menu for the button. If dropped on a menu item it will become submenu.
 
A Popup Panel can be used instead of a Popup Menu to provide a free format menu area.
 
The Prepare is fired immediately before the menu is displayed.

Example

This example shows a button with an attached popup menu. The second item in the popup has submenu showing 2 further items.
 
Construction of menus is easily managed in the designer. This code is provided for reference purposes.
Begin_Com Role(*EXTENDS #PRIM_WEB)
 
   Define_Com Class(#PRIM_PHBN) Name(#Button) Caption('Button') Displayposition(2) Left(560) Parent(#COM_OWNER) Tabposition(1) Top(40) Width(145) Menupopup(#PopupMenu1)
 
   Define_Com Class(#PRIM_PPNL.Menu) Name(#PopupMenu1) Left(8) Top(33) Height(104)
   Define_Com Class(#PRIM_PPNL.MenuItem) Name(#MenuItem1) Caption('MenuItem1') Displayposition(1) Parent(#PopupMenu1) Tabposition(1) Tabstop(False) Width(148)
   Define_Com Class(#PRIM_PPNL.MenuItem) Name(#MenuItem2) Caption('MenuItem2') Displayposition(2) Parent(#PopupMenu1) Tabposition(4) Tabstop(False) Top(25) Width(148) Menupopup(#PopupMenu2)
   Define_Com Class(#PRIM_PPNL.MenuItem) Name(#MenuItem3) Caption('MenuItem3') Displayposition(3) Parent(#PopupMenu1) Tabposition(3) Tabstop(False) Top(50) Width(148)
   Define_Com Class(#PRIM_PPNL.MenuItem) Name(#MenuItem4) Caption('MenuItem4') Displayposition(4) Parent(#PopupMenu1) Tabposition(2) Tabstop(False) Top(75) Width(148)
 
   Define_Com Class(#PRIM_PPNL.Menu) Name(#PopupMenu2) Left(157) Top(59) Height(54)
   Define_Com Class(#PRIM_PPNL.MenuItem) Name(#MenuItem5) Caption('MenuItem1') Displayposition(1) Parent(#PopupMenu2) Tabposition(1) Tabstop(False)
   Define_Com Class(#PRIM_PPNL.MenuItem) Name(#MenuItem6) Caption('MenuItem2') Displayposition(2) Parent(#PopupMenu2) Tabposition(2) Tabstop(False)
 
End_Com

Properties

NameDescription
AutoCloseClose the panel automatically Inherited from Popup (PRIM_PPNL)
AutoFocusSet to true to set focus to the popup panel when shown Inherited from Popup (PRIM_PPNL)
BusyUpdatesBusyUpdates specifies how the control updates itself Inherited from Control (PRIM_CTRL)
BusyUpdatesOfParentBusyUpdatesOfParent specifies whether the parent controls updates Inherited from Control (PRIM_CTRL)
CanFocusCanFocus returns a value indicating whether the control can receive keyboard focus Inherited from Control (PRIM_CTRL)
CaptionText to display in the title bar Inherited from Popup (PRIM_PPNL)
CloseButtonShow the close button in the title bar Inherited from Popup (PRIM_PPNL)
CloseImageRepository enrolled image to show in the title bar Inherited from Popup (PRIM_PPNL)
CloseOnClickSet to True to close the popup when on click of a child control Inherited from Popup (PRIM_PPNL)
ComponentClassNameComponentClassName is the name of the component's class. Inherited from Object (PRIM_OBJT)
ComponentControlsComponentControls is a collection of all the controls contained in this component. Inherited from Container (PRIM_CPST)
ComponentMembersComponentMembers provides access to all the member components of this component Inherited from Object (PRIM_OBJT)
ComponentPatternNameComponentPatternName is used to qualify the class of the component. Inherited from Object (PRIM_OBJT)
ComponentTagGeneric space allowing a value to be stored for the instance Inherited from Object (PRIM_OBJT)
ComponentTypeComponentType gives you access to the type information about the component Inherited from Object (PRIM_OBJT)
ComponentTypeNameComponentTypeName is the fully qualified name of the component's class. Inherited from Object (PRIM_OBJT)
ContentPanel to show in the popup Inherited from Popup (PRIM_PPNL)
CursorCursor sets the cursor image Inherited from Control (PRIM_CTRL)
DesignManagerReference to a Design Manager instance for this panel Inherited from Panel (PRIM_PANL)
DisableNoScrollDisableNoScroll controls whether scroll bars are displayed. Inherited from Panel (PRIM_PANL)
DisplayPositionDisplayPosition determines the order in which components are shown Inherited from Control (PRIM_CTRL)
DragStyleDragStyle determines how a component can be dragged Inherited from Control (PRIM_CTRL)
EnableChildrenEnableChildren specifies if the parent sets the Enabled property of child components Inherited from Container (PRIM_CPST)
EnabledEnable activates/deactivates the component Inherited from Control (PRIM_CTRL)
FixedPositionFix the control position so that it does not move if the parent is scrolled Inherited from Control (PRIM_CTRL)
FocusFocus tells whether the component has focus Inherited from Control (PRIM_CTRL)
FocusedStyleReference to a style to be applied when the control is focus Inherited from Control (PRIM_CTRL)
FocusedStylesCollection of styles to be applied when the control is focus Inherited from Control (PRIM_CTRL)
HandleReturns the Windows handle in desktop applications Inherited from Control (PRIM_CTRL)
HeightThe height of the control in pixels Inherited from Control (PRIM_CTRL)
HintCaption displayed when the mouse hovers over the control Inherited from Control (PRIM_CTRL)
HintPopupHintPopup allows a PopupPanel instance to be used instead of the default hint text box Inherited from Control (PRIM_CTRL)
HintShowEnabled or disable the appearance of hints Inherited from Control (PRIM_CTRL)
HintShowOfParentDelegate hints appearance to the parent control Inherited from Control (PRIM_CTRL)
HintTitleHintTitle defines the text shown at the top of the hint window in emphasized text Inherited from Control (PRIM_CTRL)
HorizontalScrollShow the horizontal scroll bar Inherited from Panel (PRIM_PANL)
HorizontalScrollIncHorizontalScrollInc specifies the pixel increment for horizontal scroll bar. Inherited from Panel (PRIM_PANL)
HorizontalScrollPosHorizontalScrollPos sets the position of the horizontal scroll bar Inherited from Panel (PRIM_PANL)
HorizontalScrollRemainderSpecifies the pixels remaining to the right of the current scroll position Inherited from Panel (PRIM_PANL)
ImageRepository enrolled image to show in the control Inherited from Panel (PRIM_PANL)
ImageAlignmentPosition of the image within the panel Inherited from Panel (PRIM_PANL)
IsAnimatingIsAnimating indicates that a control is currently being animated Inherited from Control (PRIM_CTRL)
IsOpenReturns True if the popup is currently being shown Inherited from Popup (PRIM_PPNL)
IsRealizedTrue if the control is currently realized Inherited from Control (PRIM_CTRL)
LayoutManagerReference to a layout manager used to control the position of child controls Inherited from Panel (PRIM_PANL)
LeftPosition of the control relative to the left boundary of its parent Inherited from Control (PRIM_CTRL)
MenuSizingControls whether the menu will be sized as designed or to the size of the menu items
ModifiedModified indicates that the contents of the component have changed Inherited from Control (PRIM_CTRL)
MouseOverMouseOver determines whether the mouse is directly over a control Inherited from Popup (PRIM_PPNL)
MouseOverPartTrue if the cursor is within the bounds of a child component Inherited from Popup (PRIM_PPNL)
MouseOverStyleMouseOverStyle defines the style to be applied to a control when the mouse is over it Inherited from Control (PRIM_CTRL)
MouseOverStylesMouseOverStyles is a collection of styles to be applied to a control when the mouse is over it Inherited from Control (PRIM_CTRL)
NameName identifies the component Inherited from Object (PRIM_OBJT)
OpacityOpacity denotes the appearance of a control in terms of its interaction with its background Inherited from Control (PRIM_CTRL)
OwnerOwner owns this component Inherited from Object (PRIM_OBJT)
ParentReference to the control in which this control is visually positioned Inherited from Control (PRIM_CTRL)
PopupPopup allows a PopupPanel instance to be used instead of the typical right click popup menu Inherited from Control (PRIM_CTRL)
PopupMenuReference to a PopupMenu to be shown on a right click Inherited from Control (PRIM_CTRL)
PrivateStyleStyle applied to the control but not inherited by child controls Inherited from Container (PRIM_CPST)
PrivateStylesCollection of styles applied to the control but not inherited by child controls Inherited from Container (PRIM_CPST)
RenderStyleRender content as DirectX or defer to the parent control Inherited from Panel (PRIM_PANL)
RotationRotation allows a control to rotate a number of degrees about a given origin Inherited from Control (PRIM_CTRL)
RotationOriginLeftRotationOriginLeft defines the left coordinate of an imaginary point around which a control will rotate Inherited from Control (PRIM_CTRL)
RotationOriginTopRotationOriginTop defines the top coordinate of an imaginary point around which a control will rotate Inherited from Control (PRIM_CTRL)
ScaleHeightScaleHeight is the percentage of the height to use in the visual appearance of a control Inherited from Control (PRIM_CTRL)
ScaleOriginLeftScaleOriginLeft defines the left coordinate of an imaginary point from which a control will scale Inherited from Control (PRIM_CTRL)
ScaleOriginTopScaleOriginTop defines the top coordinate of an imaginary point from which a control will scale Inherited from Control (PRIM_CTRL)
ScaleWidthScaleWidth is the percentage of the width to use in the visual appearance of a control Inherited from Control (PRIM_CTRL)
ScreenLeftScreenLeft sets the distance from the left of the screen Inherited from Control (PRIM_CTRL)
ScreenTopScreenTop sets the distance from the top of the screen Inherited from Control (PRIM_CTRL)
ScrollLeftLeft position of a horizontally scrolled child control relative to its parent control Inherited from Control (PRIM_CTRL)
ScrollTopTop position of a vertically scrolled child control relative to its parent control Inherited from Control (PRIM_CTRL)
ShroudStyleReference to a style to be used as a background when the popup is shown Inherited from Popup (PRIM_PPNL)
ShroudStylesCollection of styles to be used as a background when the popup is shown Inherited from Popup (PRIM_PPNL)
SkewLeftSkewLeft defines the angle at which to skew the control horizontally Inherited from Control (PRIM_CTRL)
SkewOriginLeftSkewOriginLeft defines the left coordinate of an imaginary point from which a control will skew Inherited from Control (PRIM_CTRL)
SkewOriginTopSkewOriginTop defines the top coordinate of an imaginary point from which a control will skew Inherited from Control (PRIM_CTRL)
SkewTopSkewTop defines the angle at which to skew the control vertically Inherited from Control (PRIM_CTRL)
StyleStyle defines the style to be applied to a control Inherited from Control (PRIM_CTRL)
StylesCollection of styles to be applied to the control Inherited from Control (PRIM_CTRL)
TabPositionTabPosition sets the order of focus when the Tab key is used Inherited from Control (PRIM_CTRL)
TabStopSet to false to stop focus being given to the control via the Tab key Inherited from Control (PRIM_CTRL)
ThemeBackgroundThemed background for Material Design themed applications Inherited from Panel (PRIM_PANL)
ThemeDrawStyleName of the Theme DrawStyle to be applied to the panel Inherited from Panel (PRIM_PANL)
ThemeStyleSpecifies how theme usage is determined Inherited from Panel (PRIM_PANL)
TitleBarShow the title bar Inherited from Popup (PRIM_PPNL)
TitleBarThemeDrawStyleName of the Theme DrawStyle to be applied to the title bar Inherited from Popup (PRIM_PPNL)
TitleImageImage displayed on the left side of the title bar Inherited from Popup (PRIM_PPNL)
TopPosition of the control relative to the top boundary of its parent Inherited from Control (PRIM_CTRL)
TouchMoveDetermines how the popup panel will respond to touch move processing Inherited from Popup (PRIM_PPNL)
TouchRotateDetermines how the control will respond to touch rotation Inherited from Control (PRIM_CTRL)
TouchScaleDetermines how the control will respond to touch scaling Inherited from Control (PRIM_CTRL)
TouchSizeDetermines whether a popup panel can be resized Inherited from Popup (PRIM_PPNL)
VerticalScrollShow the vertical scroll bar Inherited from Panel (PRIM_PANL)
VerticalScrollIncVerticalScrollInc specifies the pixel increment for vertical scroll bar. Inherited from Panel (PRIM_PANL)
VerticalScrollPosVerticalScrollPos sets the position of the vertical scroll bar Inherited from Panel (PRIM_PANL)
VerticalScrollRemainderSpecifies the pixels left to the botom from the current scroll position Inherited from Panel (PRIM_PANL)
VisibleShow or hide the control Inherited from Control (PRIM_CTRL)
VisualStyleVisualStyle sets the appearance Inherited from Control (PRIM_CTRL)
VisualStyleOfParentAdopt the Visual style from the parent control Inherited from Control (PRIM_CTRL)
WidthWidth of the component in pixels Inherited from Control (PRIM_CTRL)

Events

NameDescription
AnimationEndedFired when an animation is ended Inherited from Control (PRIM_CTRL)
Cancelled
ClickFired when the mouse is clicked on the control Inherited from Control (PRIM_CTRL)
Origin, Handled
ClosedThe popup panel has closed Inherited from Control (PRIM_CTRL)
ClosingThe popup is closing Inherited from Control (PRIM_CTRL)
ClosePopup
CreateInstanceCreateInstance is signalled when an instance of a component is created Inherited from Control (PRIM_CTRL)
DesignChangedFired when the a design is activated Inherited from Control (PRIM_CTRL)
Design, DesignManager
DestroyInstanceDestroyInstance is signalled when an instance of a component is about to be destroyed Inherited from Control (PRIM_CTRL)
DoubleClickFired when the user double clicks Inherited from Control (PRIM_CTRL)
Origin, Handled
DragDropFired on mouse up to signify the end of a drag process Inherited from Control (PRIM_CTRL)
PosX, PosY, Source, Payload, AggregatedSource, Origin, Handled, DragResult
DragOverFired during the drag and drop process when the cursor moves over the control Inherited from Control (PRIM_CTRL)
PosX, PosY, Source, Payload, DragState, AcceptDrop, DragCursor, ShowDropHilight, AggregatedSource, Origin, Handled
EndDragFired when the drag and drop process has completed Inherited from Control (PRIM_CTRL)
Source, Payload, DragResult, AggregatedSource, Origin, Handled
EnterFired when the Enter key is pressed Inherited from Control (PRIM_CTRL)
KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled
InitializeFired after a component has been realized for the first time Inherited from Control (PRIM_CTRL)
KeyPressFired when a key is pressed on the keyboard Inherited from Control (PRIM_CTRL)
KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled
MouseEnterThe mouse has entered the bounds of the control Inherited from Control (PRIM_CTRL)
MouseHoverThe mouse has hovered over the control Inherited from Control (PRIM_CTRL)
Origin, Handled
MouseLeaveThe mouse has left the bounds of the control Inherited from Control (PRIM_CTRL)
PreparePopup is about to be shown Inherited from Control (PRIM_CTRL)
Context, Left, Top, Width, Height, Transition, Continue
ScrollChangedFired when the scrollbars in a composite control are moved Inherited from Control (PRIM_CTRL)
Orientation
SizeChangedFired when the size of the panel is changed Inherited from Control (PRIM_CTRL)
StartDragFired when the user starts a drag and drop process Inherited from Control (PRIM_CTRL)
Source, Payload, Continue, DragList, AggregatedSource, Origin, Handled
TouchChangeFired repeatedly between the TouchStart and TouchEnd boundaries to provide details of the touch events Inherited from Control (PRIM_CTRL)
MoveLeft, MoveTop, ScaleWidth, ScaleHeight, Rotation, Continue
TouchEndFired when the user stops touching the screen Inherited from Control (PRIM_CTRL)
TouchStartFired when the user first makes physical contact with the screen Inherited from Control (PRIM_CTRL)
Origin, TouchMove, TouchRotate, TouchScale, TouchSize

Methods

NameDescription
ClosePopupClose the popup Inherited from Popup (PRIM_PPNL)
FadeInAnimate from invisible to visible Inherited from Control (PRIM_CTRL)
Duration, Delay
FadeOutAnimate from visible to invisible Inherited from Control (PRIM_CTRL)
Duration, Delay, Visible
HorizontalScrollToSet the horizontal scroll position using a child control Inherited from Panel (PRIM_PANL)
Control, ScrollPosition
MoveFromMove a control from the specified position to the current position Inherited from Control (PRIM_CTRL)
Left, Top, Duration, Delay
MoveToAnimate a move from the specified number of pixels Inherited from Control (PRIM_CTRL)
Left, Top, Duration, Delay
RealizeCreates the visual portion of dynamically created controls Inherited from Control (PRIM_CTRL)
ScaleAnimate a change of scale Inherited from Control (PRIM_CTRL)
ScaleWidth, ScaleHeight, Duration, Delay
SetFocusSets the control to be the focus control Inherited from Control (PRIM_CTRL)
ShowMessagesLANSA Internal Use Inherited from Control (PRIM_CTRL)
ShowPopupShow the popup Inherited from Popup (PRIM_PPNL)
Left, Top, Placement, Transition, Context
TransitionAnimate the change from one control to another Inherited from Container (PRIM_CPST)
From, To, TransitionType, Duration, Delay
UnrealizeDestroys the visual portion of dynamically created controls Inherited from Control (PRIM_CTRL)
UpdateDisplayUpdateDisplay updates the display immediately Inherited from Control (PRIM_CTRL)
VerticalScrollToSet the vertical scroll position using a child control Inherited from Panel (PRIM_PANL)
Control, ScrollPosition

See also

All Component Classes

Technical Reference

Febuary 18 V14SP2