This is documentation for Mathematica 6, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.1)


LocatorPane[{x, y}, back]
represents a pane with a locator at position {x, y} 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 pt1, pt2, ....
LocatorPane[Dynamic[{pt1, pt2, ...}], back]
takes the locator positions to be dynamically updated current values of the pti.
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.
  • 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
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
  • 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 gi.  »
  • 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 "LocatorPane" style in the current stylesheet.
New in 6