Mathematica 9 is now available
SEARCH MATHEMATICA 8 DOCUMENTATION
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.
Mathematica > Dynamic Interactivity > Control Objects >
Built-in Mathematica SymbolTutorials »|See Also »|More About »

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, {val1->lbl1, val2->lbl2, ...}]
represents a popup menu in which possible value vali is indicated by lbli.
PopupMenu[x, {val1->lbl1, ...}, 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.
  • 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
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
  • 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.
EXAMPLESCLOSE ALL
Basic Examples   (2)
Select values from a popup menu:
Connect PopupMenu to a dynamic state:
Select values from a popup menu:
In[1]:=
Click for copyable input
Out[1]=
 
Connect PopupMenu to a dynamic state:
In[1]:=
Click for copyable input
Out[1]=
Scope   (7)
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:
Start with value c selected:
The setting is based on value, regardless of labels:
Connect a PopupMenu to a slider:
Options   (9)
Specify an alignment within the menu:
By default, PopupMenu does not open until you click it:
By setting AutoAction, PopupMenu opens as the mouse moves over it:
Align with surrounding text:
By default, PopupMenu is enabled:
By setting Enabled->False, PopupMenu is disabled, but visible in its current state:
Use a predefined size:
Specify width and height:
Add margins within the view:
Add margins outside the view:
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:
New in 6
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team