DOCUMENTATION CENTER SEARCH

New to Mathematica? Find your learning path »

Mathematica > Dynamic Interactivity > Custom Interface Construction > Click-Interactive Panels > LocatorPane >

Mathematica > Visualization and Graphics > Graphics Interactivity & Drawing > Click-Interactive Panels > LocatorPane >

LocatorPane

represents a pane with a locator at position

and background back.

LocatorPane[Dynamic[pt], back]
takes the locator position to be the dynamically updated current value of pt, with the value of pt being reset if the locator is moved.

sets up multiple locators at positions

,

, ....

LocatorPane[Dynamic[{pt₁, pt₂, ...}], back]
takes the locator positions to be dynamically updated current values of the

.

specifies the range of coordinates for the locator.

uses jumps dx, dy.

MORE INFORMATION

The background in a locator pane can be a graphic or any other expression.

For a Graphics object g, LocatorPane by default takes the range of coordinates for pt to be the range of graphics coordinates corresponding to PlotRange in g.

For a general expression, LocatorPane takes the range of coordinates for pt to be 0 to 1 in each direction.

The following options can be given:

	Appearance	Automatic	the appearance of locators
	AutoAction	False	whether to move the locator automatically when the mouse is over it
	BaselinePosition	Automatic	how to align with a surrounding text baseline
	BaseStyle	{}	base style specifications for the locator pane
	ContinuousAction	True	whether to update continuously when locators are moved
	Enabled	Automatic	whether the locator pane is enabled, or its locators are grayed out
	Exclusions	{}	specific points to exclude
	LocatorAutoCreate	False	whether to allow clicks to create new locators

With the setting Appearance->g, all locators in the locator pane are displayed as g, where g is any graphic or other expression. »

With Appearance, the i locator is displayed as . »

LocatorPane specifies different ranges for different locators.

LocatorPane by default directs any click to the nearest locator.

The settings for BaseStyle are appended to the default style typically given by the style in the current stylesheet.

Basic Examples (2)

Create a locator pane with a single locator and a background image of a disk:

Create multiple locators:

Use Dynamic to connect locator positions to variables:

Do the same for multiple locators:

Create a locator pane with a single locator and a background image of a disk:

Out[1]=

Create multiple locators:

Out[2]=

Use Dynamic to connect locator positions to variables:

Out[1]=

Do the same for multiple locators:

Out[2]=

Use a graphic as the background:

Include an empty graphic:

Use any expression as the background:

Specify a range of coordinates for locators:

Specify both a range and jump size for locators:

Use any expression as the appearance for locators:

Use multiple locators:

Use a dynamic setting:

Connect the dynamic setting to a Slider2D:

Use any expression as the appearance for locators in LocatorPane:

Multiple locators with different appearances:

Use Appearance->None for invisible locators:

Use an invisible locator to implement a constrained movement:

By default, the locator does not change until you click in the locator pane:

By setting AutoAction, the locator changes as the mouse moves over the locator pane:

Change the background colors:

Change the background color dynamically:

By default, variables are continuously updated:

Setting ContinuousAction to False makes variable updates only when the locator is released:

By default, LocatorPane is enabled:

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

By default, each click in the locator pane will move the nearest locator:

By setting LocatorAutoCreate->True, you can use Alt+Click to create or remove locators:

By setting LocatorAutoCreate->All, create a locator on each click (Alt+Click to remove):

Make an interactive plot that runs through all locators:

Applications (5)

Set up an array of movable random points:

Create a locator that is constrained to follow the curve:

Visualize solutions to a linear system of differential equations

:

Interactive curve fit plot:

Interactive three-point circle :

Properties & Relations (2)

LocatorPane is a special case of EventHandler:

Use Setting to extract the setting of a LocatorPane:

Neat Examples (3)

Use AutoAction to select the locator closest to the mouse point:

Constrain the locator to a circle:

Visualize solutions to a linear system of differential equations

:

Slider2D ClickPane Locator Manipulate Slider ColorSlider EventHandler

Introduction to Dynamic

Generalized Input

Click-Interactive Panels

Control Objects

Custom Interface Construction

Dynamic Visualization

Graphics Interactivity & Drawing

New in 6

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

Format: HTML | CDF