abstractcanvas.html

Geotools是一个开源的Java GIS工具包,可利用它来开发符合标准的地理信息系统。Geotools提供了OGC(Open Geospatial Consortium)规范的一个实现来作为他们的

<DT><B>Specified by:</B><DD><CODE>setTitle</CODE> in interface <CODE>Canvas</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setTitle(org.opengis.util.InternationalString)"><!-- --></A><H3>
setTitle</H3>
<PRE>
public void <B>setTitle</B>(InternationalString&nbsp;title)</PRE>
<DL>
<DD>Sets the localized title of this . The title of a 
 may or may not be displayed on the titlebar of an application's window.
 <p>
 This method fires a {@value}
 property change event.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="add(org.opengis.go.display.primitive.Graphic)"><!-- --></A><H3>
add</H3>
<PRE>
public Graphic <B>add</B>(Graphic&nbsp;graphic)
                                             throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></PRE>
<DL>
<DD>Adds the given  to this . This implementation respect the
 <var>z</var>-order retrieved by calling <CODE>Graphic.getZOrderHint()</CODE>. When two added
 s have the same <var>z</var>-order, the most recently added will be on top.
 <p>
 Most  do not draw anything as long as at least one graphic hasn't be added.
 In Geotools implementation, an <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html" title="class in org.geotools.display.canvas"><CODE>AbstractGraphic</CODE></A> can be added to only one
 <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html" title="class in org.geotools.display.canvas"><CODE>AbstractCanvas</CODE></A> object. If the specified graphic has already been added to
 an other canvas, then this method <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#clone()">creates a clone</A>
 before to add the graphic.
 <p>
 This method fires a {@value}
 property change event.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>add</CODE> in interface <CODE>Canvas</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>graphic</CODE> - Graphic to add to this canvas. This method call will be ignored if
          has already been added to this canvas.
<DT><B>Returns:</B><DD>The graphic added. This is usually the supplied graphic, but may also be a
         new one if this method cloned the graphic.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - If  has already been added to an other
          and the graphic is not cloneable.<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#remove(org.opengis.go.display.primitive.Graphic)"><CODE>remove(org.opengis.go.display.primitive.Graphic)</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#removeAll()"><CODE>removeAll()</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getGraphics()"><CODE>getGraphics()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="addAsEditable(org.opengis.go.display.primitive.Graphic)"><!-- --></A><H3>
addAsEditable</H3>
<PRE>
public Graphic <B>addAsEditable</B>(Graphic&nbsp;graphic)</PRE>
<DL>
<DD>Adds the given  to this , immediately placing the
  in an editing/drawing mode.  A  added as editable
 may or may not be visible when it is added, as it may wait for user input to define
 the 's values through mouse gestures or key input.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>addAsEditable</CODE> in interface <CODE>Canvas</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="remove(org.opengis.go.display.primitive.Graphic)"><!-- --></A><H3>
remove</H3>
<PRE>
public void <B>remove</B>(Graphic&nbsp;graphic)
            throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></PRE>
<DL>
<DD>Removes the given  from this . Note that if the graphic is
 going to be added back to the same canvas later, then it is more efficient to invoke
 <CODE>Graphic.setVisible(boolean)</CODE> instead.
 <p>
 This method fires a {@value}
 property change event.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>remove</CODE> in interface <CODE>Canvas</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>graphic</CODE> - The graphic to remove. This method call will be ignored if 
         has already been removed from this canvas.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - If  is owned by an other 
         than .<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#add(org.opengis.go.display.primitive.Graphic)"><CODE>add(org.opengis.go.display.primitive.Graphic)</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#removeAll()"><CODE>removeAll()</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getGraphics()"><CODE>getGraphics()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="removeAll()"><!-- --></A><H3>
removeAll</H3>
<PRE>
public void <B>removeAll</B>()</PRE>
<DL>
<DD>Remove all graphics from this canvas.
 <p>
 This method fires a {@value}
 property change event.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#add(org.opengis.go.display.primitive.Graphic)"><CODE>add(org.opengis.go.display.primitive.Graphic)</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#remove(org.opengis.go.display.primitive.Graphic)"><CODE>remove(org.opengis.go.display.primitive.Graphic)</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#getGraphics()"><CODE>getGraphics()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getGraphics()"><!-- --></A><H3>
getGraphics</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/List.html" title="class or interface in java.util">List</A> <B>getGraphics</B>()</PRE>
<DL>
<DD>Returns all graphics in this canvas. The returned list is sorted in increasing
 z-order: element at index 0 contains the first
 graphic to be drawn.
 <p>
 This method returns an unmodifiable snapshot of current canvas state.
 <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#add(org.opengis.go.display.primitive.Graphic)">Adding</A> or <A HREF="../../../../org/geotools/display/canvas/AbstractCanvas.html#remove(org.opengis.go.display.primitive.Graphic)">removing</A> graphics will
 not affect the content of previous list returned by previous call to this method.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="graphicPropertyChanged(org.geotools.display.canvas.AbstractGraphic, java.beans.PropertyChangeEvent)"><!-- --></A><H3>
graphicPropertyChanged</H3>
<PRE>
protected void <B>graphicPropertyChanged</B>(<A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html" title="class in org.geotools.display.canvas">AbstractGraphic</A>&nbsp;graphic,
                                      <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/beans/PropertyChangeEvent.html" title="class or interface in java.beans">PropertyChangeEvent</A>&nbsp;event)</PRE>
<DL>
<DD>Invoked automatically when a graphic registered in this canvas changed. Subclasses can
 override this method if they need to react to some graphic change events, but should
 always invoke .
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>graphic</CODE> - The graphic that changed.<DD><CODE>event</CODE> - The property change event.</DL>
</DD>
</DL>
<HR>

<A NAME="addEventManager(org.opengis.go.display.event.EventManager)"><!-- --></A><H3>
addEventManager</H3>
<PRE>
public void <B>addEventManager</B>(EventManager&nbsp;eventManager)</PRE>
<DL>
<DD>Adds the  subinterface if it not currently in
 the 's collection of s.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>addEventManager</CODE> in interface <CODE>Canvas</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="findEventManager(java.lang.Class)"><!-- --></A><H3>
findEventManager</H3>
<PRE>
public EventManager <B>findEventManager</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Class.html" title="class or interface in java.lang">Class</A>&nbsp;type)</PRE>
<DL>
<DD>Returns the  subinterface, based on the class type.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>findEventManager</CODE> in interface <CODE>Canvas</CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>type</CODE> - The class type of the  subinterface.
<DT><B>Returns:</B><DD>a class that implements the requested  subinterface,
         or  if there is no implementing class.</DL>
</DD>
</DL>
<HR>

<A NAME="disposeEventManagers()"><!-- --></A><H3>
disposeEventManagers</H3>
<PRE>
public void <B>disposeEventManagers</B>()</PRE>
<DL>
<DD>Method that may be called when the s of a  are no longer
 needed. Implementations may use this method to release resources or to return the object to
 an object pool. It is an error to reference any s of a 
 after this method has been called.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>disposeEventManagers</CODE> in interface <CODE>Canvas</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="addCanvasListener(org.opengis.go.display.canvas.CanvasListener)"><!-- --></A><H3>
addCanvasListener</H3>
<PRE>
public void <B>addCanvasListener</B>(CanvasListener&nbsp;listener)</PRE>
<DL>
<DD>Adds the given listener that will be notified when the state of this
  has changed.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE>addCanvasListener</CODE> in interface <CODE>Canvas</CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="removeCanvasListener(org.opengis.go.display.canvas.CanvasListener)"><!-- --></A><H3>
removeCanvasListener</H3>
<PRE>
public void <B>removeCanvasListener</B>(CanvasListener&nbsp;listener)</PRE>
<DL>