This is documentation for Mathematica 6, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.2)


Updated In 6 Graphic
is a low-level box construct that represents a button in a notebook expression.
  • ButtonBox is the low-level representation of Button. Except for low-level notebook expression manipulation, ButtonBox should not need to be used directly.
  • ButtonBox[boxes] displays as boxes and performs an action when it is clicked.
  • The default action is to paste boxes at your current insertion point. Other actions can be specified using options.
  • ButtonBox objects are used to implement palette buttons, hyperlinks and other active elements in notebooks.
  • ButtonBox objects are active when either they or the cell that contains them has the option Enabled->True.
  • When ButtonBox objects are active, they perform an action whenever they are clicked. Otherwise, clicking them simply selects them or their contents.
  • The following options affecting button appearance can be given:
BackgroundAutomaticbutton background color
ButtonFrame"Palette"the type of frame for the button
ImageSizeFullthe size of the button
FrameMarginsAutomaticthe margin in printer's points around the contents of a button
ButtonMinHeight1.0the minimum total height of a button in units of font size
  • The following options affecting button action can be given:
ButtonDataAutomaticthe second argument to supply to the button function
ButtonFunction(pasting function) the function to apply when the button is clicked
ButtonSourceAutomaticwhere to get the first argument of the button function
EnabledAutomaticwhether to make the button always active
EvaluatorNonewhere to send the button function expression for evaluation
  • ButtonBox[...] is by default interpreted as Button[...] if it is given as input to the Mathematica kernel.
New in 3 | Last modified in 6