Avoid displaying multiple 'finish' events using Display Listener

Last Published: April 25, 2020


The map display process may take place asynchronously, that is, in multiple threads simultaneously to improve the performance. In such a case, one finish event is invoked when each display thread is finished. This means that the application may invoke a finish method of the associated DisplayListener more than once.

Therefore, if the DisplayListener's finish method is overridden to perform a certain function, this function may be called multiple times, although one would like to call it just once when the map is completely displayed.


To make sure that all display threads are terminated before some function is performed, keep track of every start, finish, and cancel event of the DisplayListener. This can be done by creating a custom Listener by extending the DisplayAdapter class.

1. Create a new class that extends DisplayAdapter.

2. Create a counter method to record the events of the DisplayAdapter.

3. Adjust the counter accordingly for each time a thread starts, stops, or is cancelled.

4. Display a 'finished' message when the map is completely displayed.

The complete code is shown below.


class MyListener extends DisplayAdapter{

int m_requesting = 0;
int count=0;

// When a drawing thread is started, the method is called.
public void start( de){
// System.out.println("Start()...");


// When a drawing thread is cancelled, the method is called.
public void cancel( de) {

public void finish( de) {

public void extent( e) {


private synchronized void setCounter(int change) {
if (change > 0 && m_requesting == 0) {
// Do nothing.
m_requesting += change;
if (change < 0 && m_requesting == 0) {
// Call the function here.


In MapObjects-Java 2.0, the finish event is invoked only once after the data is completely displayed. So there is no need to keep track of individual threads for this version.

The above code is suitable for a local data source. If using data from ArcIMS Feature Server, it might still return multiple 'finished' messages. In such a case, make sure data is completely downloaded to the client before performing the map display. DataListener can be used to manage the DataEvents.

Article ID:000005954

  • Legacy Products

Receive notifications and find solutions for new or common issues

Get summarized answers and video solutions from our new AI chatbot.

Download the Esri Support App

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options