represents a locator object at position {x,y} in a graphic.


takes the position to be the dynamically updated current value of pos, with this value being reset if the locator object is moved.


displays obj as the locator object.


displays nothing visible as the locator object.

Details and Options

  • Locator[{x,y},Automatic] uses the default "crosshairs" appearance for the locator object.
  • Locator[Dynamic[{x,y}]] will reset the values of x and y when the locator object is moved; Locator[{x,y}] will not.
  • Locator[Dynamic[{x,y}],None] gives no directly visible indication of position, but can be used in conjunction with a construct such as Point[Dynamic[{x,y}]]. »
  • Locator objects that appear inside Deploy[expr] can still be manipulated interactively, just like, for example, Slider objects. »
  • If obj does not define its own absolute size, its size when used as a locator object can be specified using the ImageSize option of Locator.
  • The setting for ImageSize can be Tiny, Small, Medium, Large, or an explicit value in printer's points. »
  • The center of the locator object is taken to be the setting for the AlignmentPoint option of obj, or by default, the center of the bounding box for obj.
  • The following options can be given:
  • AppearanceAutomaticbasic appearance of the locator
    AutoActionFalsewhether to move automatically when the mouse is over the graphic
    EnabledAutomaticwhether the locator is enabled, or grayed out
    ImageSizeAutomaticthe size of the displayed locator object
    LocatorRegionAutomaticwhere the locator object should be allowed to go
  • Locator[] is equivalent to Locator[Scaled[{0.5,0.5}]]. »
  • Locator can be used to specify the control for a variable in Manipulate, to indicate that the value of the variable should be determined by the position of a locator. »


open allclose all

Basic Examples  (3)

Set up a locator that can move in a graphic:

Click for copyable input

Set up locator that defines the value of p:

Click for copyable input

Put a locator in a Manipulate:

Click for copyable input
Out[1]=Play Animation

Scope  (7)

Options  (11)

Applications  (2)

Properties & Relations  (2)

Possible Issues  (1)

Neat Examples  (3)

See Also

Point  LocatorPane  Manipulate  Slider2D  Slider  VerticalSlider  Deploy  Inset


Introduced in 2007