001: //$HeadURL: https://svn.wald.intevation.org/svn/deegree/base/trunk/src/org/deegree/graphics/Selector.java $
002: /*---------------- FILE HEADER ------------------------------------------
003:
004: This file is part of deegree.
005: Copyright (C) 2001-2008 by:
006: EXSE, Department of Geography, University of Bonn
007: http://www.giub.uni-bonn.de/deegree/
008: lat/lon GmbH
009: http://www.lat-lon.de
010:
011: This library is free software; you can redistribute it and/or
012: modify it under the terms of the GNU Lesser General Public
013: License as published by the Free Software Foundation; either
014: version 2.1 of the License, or (at your option) any later version.
015:
016: This library is distributed in the hope that it will be useful,
017: but WITHOUT ANY WARRANTY; without even the implied warranty of
018: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
019: Lesser General Public License for more details.
020:
021: You should have received a copy of the GNU Lesser General Public
022: License along with this library; if not, write to the Free Software
023: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
024:
025: Contact:
026:
027: Andreas Poth
028: lat/lon GmbH
029: Aennchenstr. 19
030: 53115 Bonn
031: Germany
032: E-Mail: poth@lat-lon.de
033:
034: Prof. Dr. Klaus Greve
035: Department of Geography
036: University of Bonn
037: Meckenheimer Allee 166
038: 53115 Bonn
039: Germany
040: E-Mail: greve@giub.uni-bonn.de
041:
042: ---------------------------------------------------------------------------*/
043:
044: package org.deegree.graphics;
045:
046: import org.deegree.model.spatialschema.Envelope;
047: import org.deegree.model.spatialschema.Position;
048:
049: /**
050: *
051: * <p>
052: * ------------------------------------------------------------------------
053: * </p>
054: *
055: * @author <a href="mailto:poth@lat-lon.de">Andreas Poth</a>
056: * @version $Revision: 9340 $ $Date: 2007-12-27 04:32:12 -0800 (Thu, 27 Dec 2007) $
057: */
058: public interface Selector {
059:
060: /**
061: * adds a Theme to the Selector that shall be notified if something happens.
062: */
063: void addTheme(Theme theme);
064:
065: /**
066: * @see Selector#addTheme(Theme)
067: */
068: void removeTheme(Theme theme);
069:
070: /**
071: * selects all features (display elements) that are located within the submitted bounding box.
072: *
073: * @return ids of the selected features (display elements)
074: */
075: String[] select(Envelope boundingbox);
076:
077: /**
078: * selects all features (display elements) that intersects the submitted point. if a feature is
079: * already selected it remains selected.
080: *
081: * @return ids of the selected features (display elements)
082: */
083: String[] select(Position position);
084:
085: /**
086: * selects all features (display elements) that are located within the circle described by the
087: * position and the radius. if a feature is already selected it remains selected.
088: *
089: * @return ids of the selected features (display elements)
090: */
091: String[] select(Position position, double radius);
092:
093: /**
094: * selects all features (display elements) that are specified by the submitted ids. if a feature
095: * is already selected it remains selected.
096: *
097: * @return ids of the selected features (display elements)
098: */
099: String[] select(String[] ids);
100:
101: /**
102: * invertes the current selection.
103: */
104: String[] invertSelection();
105:
106: /**
107: * marks all features as unselected
108: */
109: void reset();
110:
111: }
|