PopupMenu

PopupMenu[x,{val1,val2,}]

represents a popup menu with setting x and possible values vali.

PopupMenu[Dynamic[x],{val1,}]

takes the setting to be the dynamically updated current value of x, with the value of x being reset every time an item is selected from the menu.

PopupMenu[x,{val1lbl1,val2lbl2,}]

represents a popup menu in which possible value vali is indicated by lbli.

PopupMenu[x,{val1lbl1,},dlbl]

displays the menu item as dlbl if x is none of the vali.

PopupMenu[x,{},dlbl,base]

displays as base when it is not being clicked.

Details and Options

  • PopupMenu[x,{val1,val2,}] displays with the vali as successive entries in the menu.
  • The vali and lbli can be strings, boxes, graphics or any other expressions, including dynamic expressions.
  • In PopupMenu[x,list], Delimiter can appear as an element of list, specifying a horizontal delimiter in the displayed popup menu.
  • The following options can be given:
  • AppearanceAutomaticthe overall appearance of the menu
    BaselinePositionAutomaticalignment relative to surrounding text
    BaseStyle{}base style specifications for the menu
    ContentPaddingTruewhether to shrink the margins tightly around the contents
    EnabledAutomaticwhether the menu is enabled, or grayed out
    FieldSize{{1.,50.},{1.,10.}}the size of the field for menu items
    FrameMarginsAutomaticmargins to leave inside the menu frame
    ImageMargins0margins around the displayed menu
    ImageSizeAllthe overall image size of the displayed menu
    MenuStyle{}style specifications for menu items
  • Appearance->{"Clicked"->app1,"Unclicked"->app2} allows different appearances to be specified for the clicked and unclicked states of the popup menu.
  • The settings for BaseStyle are appended to the default style typically given by the "PopupMenu" style in the current stylesheet.

Examples

open allclose all

Basic Examples  (2)

Select values from a popup menu:

Connect PopupMenu to a dynamic state:

Scope  (7)

PopupMenu Content  (4)

Use graphics as content in PopupMenu:

Use any expression as a label:

Use Null to indicate a blank label:

By default, a PopupMenu leaves enough space to display without ever resizing:

With ImageSize->Automatic, PopupMenu resizes for each pane:

PopupMenu Control  (3)

Start with value selected:

The setting is based on value, regardless of labels:

Connect a PopupMenu to a slider:

Options  (11)

Alignment  (1)

Specify an alignment within the menu:

AutoAction  (2)

By default, PopupMenu does not open until you click it:

By setting AutoAction, PopupMenu opens as the mouse moves over it:

BaselinePosition  (1)

Align with surrounding text:

Enabled  (1)

By default, PopupMenu is enabled:

By setting Enabled->False, PopupMenu is disabled, but visible in its current state:

FieldSize  (3)

Use a predefined size:

Specify width and height:

Allow a width and height between set values:

FrameMargins  (1)

Add margins within the view:

ImageMargins  (1)

Add margins outside the view:

ImageSize  (1)

Control the overall height and width:

Applications  (1)

Dynamically update the base view:

Properties & Relations  (1)

In PopupMenu, the setting is associated with the value of the element in the list:

In PopupView, the setting is associated with the position of the element in the list:

Introduced in 2007
 (6.0)
 |
Updated in 2010
 (8.0)