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 > Low-Level Notebook Programming >

Built-in Mathematica Symbol

Tutorials »|See Also »|More About »

ButtonBox

Updated In 6 Graphic

ButtonBox[boxes]
is a low-level box construct that represents a button in a notebook expression.

MORE INFORMATION

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.

ButtonBox[boxes, BaseStyle->"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
	ImageSize	Full	the size of the button
	FrameMargins	Automatic	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:

	ButtonData	Automatic	the second argument to supply to the button function
	ButtonFunction	(pasting function)	the function to apply when the button is clicked
	ButtonSource	Automatic	where to get the first argument of the button function
	Enabled	Automatic	whether to make the button always active
	Evaluator	None	where 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.

Basic Examples (2)

Display a button that opens a new notebook window when clicked:

Out[1]//DisplayForm=

Display a button that assigns a random number to r:

Out[1]//DisplayForm=

See the value of r after clicking the button:

Button ToBoxes

Representing Textual Forms by Boxes

Low-Level Notebook Programming

New in 3 | Last modified in 6

© 2013 Wolfram Research, Inc.

Ask a question about this page | Suggest an improvement | Leave a message for the team