source: josm/trunk/src/org/openstreetmap/josm/data/SelectionChangedListener.java@ 13808

// License: GPL. For details, see LICENSE file.
package org.openstreetmap.josm.data;

import java.util.Collection;

import org.openstreetmap.josm.data.osm.DataSelectionListener;
import org.openstreetmap.josm.data.osm.OsmPrimitive;
import org.openstreetmap.josm.data.osm.event.SelectionEventManager;

/**
 * This is a listener for selection changes through the dataset's data. Whenever
 * a selection of any data member changes, the dataSet gets informed about this
 * and fires a selectionChanged event.
 *
 * Note that these events are not fired immediately but are inserted in the
 * Swing event queue and packed together. So only one selection changed event
 * is issued within a one message dispatch routine.
 *
 * @see DataSelectionListener For a more advanced listener class.
 * @see SelectionEventManager For managing your selection events.
 *
 * @author imi
 * @since     8 (creation)
 * @since 10600 (functional interface)
 */
@FunctionalInterface
public interface SelectionChangedListener {

    /**
     * Informs the listener that the selection in the dataset has changed.
     * @param newSelection The new selection.
     */
    void selectionChanged(Collection<? extends OsmPrimitive> newSelection);
}