Products
  • Wolfram|One

    The definitive Wolfram Language and notebook experience

  • Mathematica

    The original technical computing environment

  • Notebook Assistant + LLM Kit

    All-in-one AI assistance for your Wolfram experience

  • Compute Services
  • System Modeler
  • Finance Platform
  • Wolfram|Alpha Notebook Edition
  • Application Server
  • Enterprise Private Cloud
  • Wolfram Engine
  • Wolfram Player
  • Wolfram Cloud App
  • Wolfram Player App

More mobile apps

Core Technologies of Wolfram Products

  • Wolfram Language
  • Computable Data
  • Wolfram Notebooks
  • AI & Linguistic Understanding

Deployment Options

  • Wolfram Cloud
  • wolframscript
  • Wolfram Engine Community Edition
  • Wolfram LLM API
  • WSTPServer
  • Wolfram|Alpha APIs

From the Community

  • Function Repository
  • Community Paclet Repository
  • Example Repository
  • Neural Net Repository
  • Prompt Repository
  • Wolfram Demonstrations
  • Data Repository
  • Group & Organizational Licensing
  • All Products
Consulting & Solutions

We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

  • Data & Computational Intelligence
  • Model-Based Design
  • Algorithm Development
  • Wolfram|Alpha for Business
  • Blockchain Technology
  • Education Technology
  • Quantum Computation

Wolfram Consulting

Wolfram Solutions

  • Data Science
  • Artificial Intelligence
  • Biosciences
  • Healthcare Intelligence
  • Sustainable Energy
  • Control Systems
  • Enterprise Wolfram|Alpha
  • Blockchain Labs

More Wolfram Solutions

Wolfram Solutions For Education

  • Research Universities
  • Colleges & Teaching Universities
  • Junior & Community Colleges
  • High Schools
  • Educational Technology
  • Computer-Based Math

More Solutions for Education

  • Contact Us
Learning & Support

Get Started

  • Wolfram Language Introduction
  • Fast Intro for Programmers
  • Fast Intro for Math Students
  • Wolfram Language Documentation

More Learning

  • Highlighted Core Areas
  • Demonstrations
  • YouTube
  • Daily Study Groups
  • Wolfram Schools and Programs
  • Books

Grow Your Skills

  • Wolfram U

    Courses in computing, science, life and more

  • Community

    Learn, solve problems and share ideas.

  • Blog

    News, views and insights from Wolfram

  • Resources for

    Software Developers

Tech Support

  • Contact Us
  • Support FAQs
  • Support FAQs
  • Contact Us
Company
  • About Wolfram
  • Career Center
  • All Sites & Resources
  • Connect & Follow
  • Contact Us

Work with Us

  • Student Ambassador Initiative
  • Wolfram for Startups
  • Student Opportunities
  • Jobs Using Wolfram Language

Educational Programs for Adults

  • Summer School
  • Winter School

Educational Programs for Youth

  • Middle School Camp
  • High School Research Program
  • Computational Adventures

Read

  • Stephen Wolfram's Writings
  • Wolfram Blog
  • Wolfram Tech | Books
  • Wolfram Media
  • Complex Systems

Educational Resources

  • Wolfram MathWorld
  • Wolfram in STEM/STEAM
  • Wolfram Challenges
  • Wolfram Problem Generator

Wolfram Initiatives

  • Wolfram Science
  • Wolfram Foundation
  • History of Mathematics Project

Events

  • Stephen Wolfram Livestreams
  • Online & In-Person Events
  • Contact Us
  • Connect & Follow
Wolfram|Alpha
  • Your Account
  • User Portal
  • Wolfram Cloud
  • Products
    • Wolfram|One
    • Mathematica
    • Notebook Assistant + LLM Kit
    • Compute Services
    • System Modeler
    • Finance Platform
    • Wolfram|Alpha Notebook Edition
    • Application Server
    • Enterprise Private Cloud
    • Wolfram Engine
    • Wolfram Player
    • Wolfram Cloud App
    • Wolfram Player App

    More mobile apps

    • Core Technologies
      • Wolfram Language
      • Computable Data
      • Wolfram Notebooks
      • AI & Linguistic Understanding
    • Deployment Options
      • Wolfram Cloud
      • wolframscript
      • Wolfram Engine Community Edition
      • Wolfram LLM API
      • WSTPServer
      • Wolfram|Alpha APIs
    • From the Community
      • Function Repository
      • Community Paclet Repository
      • Example Repository
      • Neural Net Repository
      • Prompt Repository
      • Wolfram Demonstrations
      • Data Repository
    • Group & Organizational Licensing
    • All Products
  • Consulting & Solutions

    We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

    WolframConsulting.com

    Wolfram Solutions

    • Data Science
    • Artificial Intelligence
    • Biosciences
    • Healthcare Intelligence
    • Sustainable Energy
    • Control Systems
    • Enterprise Wolfram|Alpha
    • Blockchain Labs

    More Wolfram Solutions

    Wolfram Solutions For Education

    • Research Universities
    • Colleges & Teaching Universities
    • Junior & Community Colleges
    • High Schools
    • Educational Technology
    • Computer-Based Math

    More Solutions for Education

    • Contact Us
  • Learning & Support

    Get Started

    • Wolfram Language Introduction
    • Fast Intro for Programmers
    • Fast Intro for Math Students
    • Wolfram Language Documentation

    Grow Your Skills

    • Wolfram U

      Courses in computing, science, life and more

    • Community

      Learn, solve problems and share ideas.

    • Blog

      News, views and insights from Wolfram

    • Resources for

      Software Developers
    • Tech Support
      • Contact Us
      • Support FAQs
    • More Learning
      • Highlighted Core Areas
      • Demonstrations
      • YouTube
      • Daily Study Groups
      • Wolfram Schools and Programs
      • Books
    • Support FAQs
    • Contact Us
  • Company
    • About Wolfram
    • Career Center
    • All Sites & Resources
    • Connect & Follow
    • Contact Us

    Work with Us

    • Student Ambassador Initiative
    • Wolfram for Startups
    • Student Opportunities
    • Jobs Using Wolfram Language

    Educational Programs for Adults

    • Summer School
    • Winter School

    Educational Programs for Youth

    • Middle School Camp
    • High School Research Program
    • Computational Adventures

    Read

    • Stephen Wolfram's Writings
    • Wolfram Blog
    • Wolfram Tech | Books
    • Wolfram Media
    • Complex Systems
    • Educational Resources
      • Wolfram MathWorld
      • Wolfram in STEM/STEAM
      • Wolfram Challenges
      • Wolfram Problem Generator
    • Wolfram Initiatives
      • Wolfram Science
      • Wolfram Foundation
      • History of Mathematics Project
    • Events
      • Stephen Wolfram Livestreams
      • Online & In-Person Events
    • Contact Us
    • Connect & Follow
  • Wolfram|Alpha
  • Wolfram Cloud
  • Your Account
  • User Portal
Wolfram Language & System Documentation Center
LocatorPane
  • See Also
    • Slider2D
    • ClickPane
    • Locator
    • Manipulate
    • Slider
    • ColorSlider
    • GestureHandler
    • EventHandler
  • Related Guides
    • Click-Interactive Panels
    • Control Objects
    • Custom Interface Construction
    • Graphics Interactivity & Drawing
    • Dynamic Visualization
  • Workflows
    • Use Locator Controls
  • Tech Notes
    • Introduction to Dynamic
    • Generalized Input
    • See Also
      • Slider2D
      • ClickPane
      • Locator
      • Manipulate
      • Slider
      • ColorSlider
      • GestureHandler
      • EventHandler
    • Related Guides
      • Click-Interactive Panels
      • Control Objects
      • Custom Interface Construction
      • Graphics Interactivity & Drawing
      • Dynamic Visualization
    • Workflows
      • Use Locator Controls
    • Tech Notes
      • Introduction to Dynamic
      • Generalized Input

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.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
LocatorPane Content  
LocatorPane Control  
Options  
Appearance  
AutoAction  
Background  
ContinuousAction  
Enabled  
LocatorAutoCreate  
Applications  
Properties & Relations  
Neat Examples  
See Also
Tech Notes
Related Guides
Related Workflows
History
Cite this Page
BUILT-IN SYMBOL
  • See Also
    • Slider2D
    • ClickPane
    • Locator
    • Manipulate
    • Slider
    • ColorSlider
    • GestureHandler
    • EventHandler
  • Related Guides
    • Click-Interactive Panels
    • Control Objects
    • Custom Interface Construction
    • Graphics Interactivity & Drawing
    • Dynamic Visualization
  • Workflows
    • Use Locator Controls
  • Tech Notes
    • Introduction to Dynamic
    • Generalized Input
    • See Also
      • Slider2D
      • ClickPane
      • Locator
      • Manipulate
      • Slider
      • ColorSlider
      • GestureHandler
      • EventHandler
    • Related Guides
      • Click-Interactive Panels
      • Control Objects
      • Custom Interface Construction
      • Graphics Interactivity & Drawing
      • Dynamic Visualization
    • Workflows
      • Use Locator Controls
    • Tech Notes
      • Introduction to Dynamic
      • Generalized Input

LocatorPane

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.

Details 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:
  • Appearance Automaticthe appearance of locators
    AutoAction Falsewhether 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
    ContinuousAction Truewhether to update continuously when locators are moved
    Enabled Automaticwhether the locator pane is enabled, or its locators are grayed out
    Exclusions{}specific points to exclude
    LocatorAutoCreate Falsewhether 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 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.

Examples

open all close all

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:

Scope  (8)

LocatorPane Content  (2)

Use a graphic as the background:

Include an empty graphic:

Use any expression as the background:

LocatorPane Control  (6)

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:

Options  (15)

Appearance  (3)

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:

AutoAction  (2)

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:

Background  (2)

Change the background colors:

Change the background color dynamically:

ContinuousAction  (2)

By default, variables are continuously updated:

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

Enabled  (2)

By default, LocatorPane is enabled:

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

LocatorAutoCreate  (4)

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  (6)

Set up an array of movable random points:

Create a locator that is constrained to follow the curve:

Use CurrentValue["CurrentLocatorPaneThumb"] to enforce different drag restrictions on different points:

Visualize solutions to a linear system of differential equations :

Interactive curve fit plot:

Interactive three-point circle [more info]:

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 :

See Also

Slider2D  ClickPane  Locator  Manipulate  Slider  ColorSlider  GestureHandler  EventHandler

Tech Notes

    ▪
  • Introduction to Dynamic
  • ▪
  • Generalized Input

Related Guides

    ▪
  • Click-Interactive Panels
  • ▪
  • Control Objects
  • ▪
  • Custom Interface Construction
  • ▪
  • Graphics Interactivity & Drawing
  • ▪
  • Dynamic Visualization

Related Workflows

    Related Workflows
    ▪
  • Use Locator Controls

History

Introduced in 2007 (6.0) | Updated in 2008 (7.0) ▪ 2012 (9.0)

Wolfram Research (2007), LocatorPane, Wolfram Language function, https://reference.wolfram.com/language/ref/LocatorPane.html (updated 2012).

Text

Wolfram Research (2007), LocatorPane, Wolfram Language function, https://reference.wolfram.com/language/ref/LocatorPane.html (updated 2012).

CMS

Wolfram Language. 2007. "LocatorPane." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2012. https://reference.wolfram.com/language/ref/LocatorPane.html.

APA

Wolfram Language. (2007). LocatorPane. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/LocatorPane.html

BibTeX

@misc{reference.wolfram_2025_locatorpane, author="Wolfram Research", title="{LocatorPane}", year="2012", howpublished="\url{https://reference.wolfram.com/language/ref/LocatorPane.html}", note=[Accessed: 01-March-2026]}

BibLaTeX

@online{reference.wolfram_2025_locatorpane, organization={Wolfram Research}, title={LocatorPane}, year={2012}, url={https://reference.wolfram.com/language/ref/LocatorPane.html}, note=[Accessed: 01-March-2026]}

Top
Introduction for Programmers
Introductory Book
Wolfram Function Repository | Wolfram Data Repository | Wolfram Data Drop | Wolfram Language Products
Top
  • Products
  • Wolfram|One
  • Mathematica
  • Notebook Assistant + LLM Kit
  • Compute Services
  • System Modeler

  • Wolfram|Alpha Notebook Edition
  • Wolfram|Alpha Pro
  • Mobile Apps

  • Wolfram Engine
  • Wolfram Player

  • Volume & Site Licensing
  • Server Deployment Options
  • Consulting
  • Wolfram Consulting
  • Repositories
  • Data Repository
  • Function Repository
  • Community Paclet Repository
  • Neural Net Repository
  • Prompt Repository

  • Wolfram Language Example Repository
  • Notebook Archive
  • Wolfram GitHub
  • Learning
  • Wolfram U
  • Wolfram Language Documentation
  • Webinars & Training
  • Educational Programs

  • Wolfram Language Introduction
  • Fast Introduction for Programmers
  • Fast Introduction for Math Students
  • Books

  • Wolfram Community
  • Wolfram Blog
  • Public Resources
  • Wolfram|Alpha
  • Wolfram Problem Generator
  • Wolfram Challenges

  • Computer-Based Math
  • Computational Thinking
  • Computational Adventures

  • Demonstrations Project
  • Wolfram Data Drop
  • MathWorld
  • Wolfram Science
  • Wolfram Media Publishing
  • Customer Resources
  • Store
  • Product Downloads
  • User Portal
  • Your Account
  • Organization Access

  • Support FAQ
  • Contact Support
  • Company
  • About Wolfram
  • Careers
  • Contact
  • Events
Wolfram Community Wolfram Blog
Legal & Privacy Policy
WolframAlpha.com | WolframCloud.com
© 2026 Wolfram
© 2026 Wolfram | Legal & Privacy Policy |
English