Skip to main content
Version: 2025

SalPopupMenu

Namespace: PPJ.Runtime.Windows

Assembly: PPJ.Web.50 (5.0.0.0)

A SAL popup-menu branch with dynamic enabled-state evaluation.

public class SalPopupMenu : MenuItem, ISalMenu

Example:

var menu = new SalPopupMenu { Text = "File" };
menu.MenuItems.Add(new SalMenuItem { Text = "Open" });

Constructors​

Instance member SalPopupMenu()​

Invokes OnInitializeMenu to populate the new popup branch.

Properties​

Instance member IsParent​

Boolean: Always identifies this item as a parent menu, even when empty.

Instance member Owner​

Control: Gets the control identified as this menu's SAL owner.

Instance member StatusText​

String: Gets or sets the status-bar text used when this branch is selected or opened. (Default: "")

Null becomes empty. The first assignment attaches a selection handler.

Methods​

Instance member CloneMenu()​

Clones the inherited popup and copies enabled-state callbacks.

Returns: MenuItem. The cloned SalPopupMenu.

Protected member Dispose(disposing)​

Clears SAL callback references before disposing the inherited menu item.

ParameterTypeDescription
disposingBooleanWhether managed resources are being disposed.

Instance member MergeMenu()​

Creates and registers a merged menu without running its constructor or initialization hook.

Returns: MenuItem. The merged menu with the EnabledWhen subscriptions copied.

Protected member OnInitializeMenu()​

Provides the initialization hook overridden by generated named-menu classes.

The base implementation does nothing. Called from construction.

Protected member OnPopup(e)​

Refreshes child menu states and updates the status bar before raising the inherited event.

ParameterTypeDescription
eEventArgsThe popup event data.

Instance member Open()​

Requests that the browser open the popup.

Events​

Instance member EnabledWhen​

SalMenuEnabledWhenHandler Evaluates whether the menu should be enabled when its SAL state is refreshed.

Implements​

NameDescription
ISalMenuExposes menu refresh, status text, and the owning control for SAL menus.