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.