ButtonBox

Usage

• ButtonBox[boxes] represents a button in a notebook, displaying boxes and performing an action when it is clicked on.
• 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 Active->True.

Notes

• When ButtonBox objects are active, they perform an action whenever they are clicked on. Otherwise, clicking on them simply selects them or their contents.

• ButtonBox[boxes, ButtonStyle->"style"] takes the properties of the ButtonBox from the specified style. The style for a ButtonBox can specify both its appearance and its action.

• The following options affecting button appearance can be given:

Background	Automatic	button background color
ButtonFrame	"Palette"	the type of frame for the button
ButtonExpandable	True	whether a button should expand to fill a position in a GridBox
ButtonMargins	3.0	the margin in printer's points around the contents of a button
ButtonMinHeight	1.0	the minimum total height of a button in units of font size

• The following options affecting button action can be given:

Active	False	whether to make the button always active
ButtonData	Null	the second argument to supply to the button function
ButtonEvaluator	None	where to send the button function expression for evaluation
ButtonFunction	(pasting function)	the function to apply when the button is clicked
ButtonNote	None	what to display in the window status line when the cursor is over the button
ButtonSource	Automatic	where to get the first argument of the button function from

• ButtonBox[ ... ] is by default interpreted as Button[ ... ] if it is given as input to the Mathematica kernel.

• See Section 2.9.10 and Section 2.11.6.

• See also: Dialog, Input.

• New in Version 3.

Further Examples