Statistics
| Revision:

svn-gvsig-desktop / trunk / org.gvsig.desktop / org.gvsig.desktop.plugin / org.gvsig.app / org.gvsig.app.mainplugin / src / main / java / org / gvsig / app / prepareAction / PrepareContextView.java @ 45679

History | View | Annotate | Download (2.2 KB)

1 40558 jjdelcerro
/**
2
 * gvSIG. Desktop Geographic Information System.
3
 *
4
 * Copyright (C) 2007-2013 gvSIG Association.
5
 *
6
 * This program is free software; you can redistribute it and/or
7
 * modify it under the terms of the GNU General Public License
8
 * as published by the Free Software Foundation; either version 3
9
 * of the License, or (at your option) any later version.
10
 *
11
 * This program is distributed in the hope that it will be useful,
12
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14
 * GNU General Public License for more details.
15
 *
16
 * You should have received a copy of the GNU General Public License
17
 * along with this program; if not, write to the Free Software
18
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
19
 * MA  02110-1301, USA.
20
 *
21
 * For any additional information, do not hesitate to contact us
22
 * at info AT gvsig.com, or visit our website www.gvsig.com.
23
 */
24 40435 jjdelcerro
25
package org.gvsig.app.prepareAction;
26
27
import org.gvsig.fmap.mapcontrol.MapControl;
28
29
/**
30 41434 cmartinez
 * Object containing the context to prepare the loading process
31
 * of a layer.
32
 *
33 40435 jjdelcerro
 * @author jmvivo
34 41434 cmartinez
 * @see PrepareContextView_1
35 40435 jjdelcerro
 */
36
public interface PrepareContextView extends PrepareContext {
37
38 41434 cmartinez
    /**
39
     * You can use it to interact with the MapControl component that will
40
     * receive the new layer, in order to get user feedback
41
     * (for instance a bounding box). Check the
42
     * {@link PrepareContextView_v1#isMapControlAvailable()} method before
43
     * accessing the MapControl
44
     * because it may not be available (for instance when adding layers
45
     * to a MapContext not associated with a View).
46
     *
47
     * For the moment, this method will return a non-null MapControl for
48
     * compatibility reasons, but you should still check
49
     * {@link PrepareContextView_v1#isMapControlAvailable()} to be sure it
50
     * is a valid one, as it could only be a fake MapControl.
51
     *
52
     * It is recommended to use {@link PrepareContextView_v1#getMapContext()}
53
     * method when no interaction is needed with the map user interface
54
     * (for instance to get the active projection, visible extent, etc)
55
     *
56
     * @return Returns the mapCtrl.
57
     */
58 40435 jjdelcerro
        MapControl getMapControl();
59
60
}