PasteButton

PasteButton[expr]

represents a button that pastes expr whenever it is pressed.

PasteButton[label,expr]

displays with label on the button.

Details and Options

  • expr is by default pasted at the current insertion point in your input notebook.
  • PasteButton[notebook,label,expr] pastes to the specified notebook.
  • PasteButton evaluates its arguments in an ordinary way, so that expr is immediately evaluated.
  • PasteButton[Defer[expr]] creates a button which pastes the unevaluated form of expr.
  • If expr contains a selection placeholder, it will be replaced by your current selection when the paste is done.
  • Selection placeholders are represented by the character or \[SelectionPlaceholder].
  • label can be any expression.
  • PasteButton takes the same options as Button.
  • PasteButton[expr] creates a button with equivalent functionality to the one created by Button[expr,None,BaseStyle->"Paste"].

Examples

open allclose all

Basic Examples  (3)

Create a button that will paste its contents:

Supply a different label:

Create a button to paste an unevaluated expression:

Scope  (2)

PasteButton Content  (1)

Use any expression as a label:

PasteButton Control  (1)

Paste the result of an evaluation:

Paste a graphics object:

Options  (13)

Alignment  (1)

Different predefined alignment options:

Appearance  (1)

Default and "Pressed" appearance:

Background  (1)

Change the background colors:

BaselinePosition  (1)

Align with the surrounding text:

Enabled  (2)

By default PasteButton is enabled:

By setting Enabled->False, the button is disabled but visible in its current state:

Evaluator  (1)

By default the paste operation takes place in the front end:

FrameMargins  (1)

By setting FrameMargins you make the button content area larger:

ImageMargins  (1)

By setting ImageMargins you make the button area larger:

ImageSize  (4)

Use preset values:

Or use any values:

By setting the second element you can also control the height:

Set a fully custom size:

Applications  (1)

Make paste buttons for a collection of country strings:

Properties & Relations  (2)

Use to replace it with the current selection:

PasteButton is a special case of Button:

Possible Issues  (1)

PasteButton does not evaluate its arguments on each click:

Introduced in 2007
 (6.0)