ActionMenu

ActionMenu[name,{lbl1:>act1,lbl2:>act2,}]

represents an action menu with label name and with items labeled lbli that evaluates the expression acti if the corresponding item is chosen.

Details and Options

  • name and the lbli can be any expressions.
  • ActionMenu by default displays name and the lbli in "ActionMenu" style, which typically uses the system menu font.
  • In ActionMenu[name,list], Delimiter can appear as an element of list, specifying a horizontal delimiter in the displayed menu.
  • The following options can be given:
  • AppearanceAutomaticthe overall appearance of the menu
    BaselinePositionAutomaticwhat to align with a surrounding text baseline
    BaseStyle{}base style specifications for the menu
    ContentPaddingTruewhether to shrink the margins tightly around the contents
    EnabledAutomaticwhether the menu is enabled or grayed out
    EvaluatorAutomaticthe kernel in which to evaluate the acti
    FieldSize{{1,50},{1,10}}the size of the field for menu items
    FrameMarginsAutomaticmargins to leave inside the menu frame
    ImageMargins0margins around the image of the displayed menu
    ImageSizeAutomaticthe overall image size of the displayed menu
    MenuStyle{}style specifications for menu items
    Method"Preemptive"the evaluation method to use
  • Possible settings for Appearance include:
  • Nonedisplay only name, without modification
    Automaticdisplay in a special action menu form (default)
    "PopupMenu"display like a popup menu with initial value name
    "Button"display like a button
  • Typical possible settings for the Method option include "Preemptive" and "Queued".
  • The settings for BaseStyle are appended to the default style typically given by the "ActionMenu" style in the current stylesheet.

Examples

open allclose all

Basic Examples  (2)

Create an action menu that prints the result of an evaluation:

Create an action menu that performs a simple assignment operation:

Scope  (3)

Use Delimiter to separate menu items:

The labels can be any expression:

Options  (11)

Appearance  (1)

Use different display appearances for the menu:

ContentPadding  (1)

Remove extra whitespace around a label with no ascenders or descenders:

Enabled  (2)

By default, ActionMenu is enabled:

By setting Enabled->False, the menu is disabled:

Evaluator  (2)

By default, the button function is sent to the kernel for evaluation:

By setting Evaluator, the button function can be evalauted in another kernel:

FieldSize  (1)

Change the field size:

FrameMargins  (1)

Add margins within the menu:

ImageMargins  (1)

Add margins outside the menu:

ImageSize  (1)

Specify the overall image size:

Method  (1)

By default, action menu functions are evaluated on a preemptive link, which times out after five seconds:

Use Method->"Queued" to evaluate button functions on the main link, which never times out:

Applications  (2)

Choose between various graphics objects:

Control the range of a graphic:

Properties & Relations  (1)

ActionMenu has the same effect as a Button series:

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