LocatorPane

LocatorPane[{x,y},back]
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.

LocatorPane[{pt1,pt2,},back]
sets up multiple locators at positions , , .

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

LocatorPane[pts,back,{{xmin,ymin},{xmax,ymax}}]
specifies the range of coordinates for the locator.

LocatorPane[pts,back,{{xmin,ymin},{xmax,ymax},{dx,dy}}]
uses jumps dx, dy.

Details and OptionsDetails and Options

  • The background in a locator pane can be a graphic or any other expression.
  • For a Graphics object g, LocatorPane[pt,g] 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[pt,expr] takes the range of coordinates for pt to be 0 to 1 in each direction.
  • The following options can be given:
  • AppearanceAutomaticthe appearance of locators
    AutoActionFalsewhether to move the locator automatically when the mouse is over it
    BaselinePositionAutomatichow to align with a surrounding text baseline
    BaseStyle{}base style specifications for the locator pane
    ContinuousActionTruewhether to update continuously when locators are moved
    EnabledAutomaticwhether the locator pane is enabled, or its locators are grayed out
    Exclusions{}specific points to exclude
    LocatorAutoCreateFalsewhether to allow clicks to create new locators
    TouchscreenAutoZoomFalse
  • whether to zoom to fullscreen when activated on a touchscreen
  • 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->{g1,g2,}, the i^(th) locator is displayed as . »
  • LocatorPane[{pt1,pt2,},back,{range1,range2,}] specifies different ranges for different locators.
  • LocatorPane[pts,back,range] 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.

ExamplesExamplesopen allclose all

Basic Examples  (2)Basic Examples  (2)

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

In[1]:=
Click for copyable input
Out[1]=

Create multiple locators:

In[2]:=
Click for copyable input
Out[2]=

Use Dynamic to connect locator positions to variables:

In[1]:=
Click for copyable input
Out[1]=

Do the same for multiple locators:

In[2]:=
Click for copyable input
Out[2]=
Introduced in 2007
(6.0)
| Updated in 2012
(9.0)