referencedgraphic.html

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

<CODE>protected &nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/javax/swing/Action.html" title="class or interface in javax.swing">Action</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#getAction(org.geotools.display.event.ReferencedEvent)">getAction</A></B>(<A HREF="../../../../org/geotools/display/event/ReferencedEvent.html" title="interface in org.geotools.display.event">ReferencedEvent</A>&nbsp;event)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the action to run when some action occured over this graphic. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;Envelope</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#getEnvelope()">getEnvelope</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an envelope that completly encloses the graphic. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;CoordinateReferenceSystem</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#getObjectiveCRS()">getObjectiveCRS</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the objective coordinate reference system.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#getToolTipText(org.geotools.display.event.ReferencedEvent)">getToolTipText</A></B>(<A HREF="../../../../org/geotools/display/event/ReferencedEvent.html" title="interface in org.geotools.display.event">ReferencedEvent</A>&nbsp;event)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the string to be used as the tooltip for a given event. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;double[]</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#getTypicalCellDimension(org.opengis.spatialschema.geometry.DirectPosition)">getTypicalCellDimension</A></B>(DirectPosition&nbsp;position)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a typical cell dimension in terms of <A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#getObjectiveCRS()">objective CRS</A>.
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#setEnvelope(org.opengis.spatialschema.geometry.Envelope)">setEnvelope</A></B>(Envelope&nbsp;newEnvelope)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the envelope for this graphic. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)">setObjectiveCRS</A></B>(CoordinateReferenceSystem&nbsp;crs)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the objective coordinate refernece system for this graphic. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#setTypicalCellDimension(double[])">setTypicalCellDimension</A></B>(double[]&nbsp;size)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the typical cell dimension. </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#transform(org.opengis.referencing.operation.MathTransform)">transform</A></B>(MathTransform&nbsp;mt)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Notifies subclasses that a new <A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#getObjectiveCRS()">objective CRS</A> has been set
 and the internal data should be transformed accordingly. </TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_AbstractGraphic"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html" title="class in org.geotools.display.canvas">AbstractGraphic</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#addGraphicListener(org.opengis.go.display.event.GraphicListener)">addGraphicListener</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#clone()">clone</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#cloneGraphic()">cloneGraphic</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#dispose()">dispose</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#fireGraphicEvent(org.opengis.go.display.event.GraphicEvent)">fireGraphicEvent</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getAutoEdit()">getAutoEdit</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getBlinking()">getBlinking</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getBlinkPattern()">getBlinkPattern</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getClientProperty(java.lang.Object)">getClientProperty</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getDragSelectable()">getDragSelectable</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getGraphicStyle()">getGraphicStyle</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getLocale()">getLocale</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getLogger()">getLogger</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getMaxScale()">getMaxScale</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getMinScale()">getMinScale</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getName()">getName</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getParent()">getParent</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getPickable()">getPickable</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getSelected()">getSelected</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getSymbology()">getSymbology</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getTreeLock()">getTreeLock</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getVisible()">getVisible</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#getZOrderHint()">getZOrderHint</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#isPassingEventsToParent()">isPassingEventsToParent</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#isShowingAnchorHandles()">isShowingAnchorHandles</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#isShowingEditHandles()">isShowingEditHandles</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#putClientProperty(java.lang.Object, java.lang.Object)">putClientProperty</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#refresh()">refresh</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#removeGraphicListener(org.opengis.go.display.event.GraphicListener)">removeGraphicListener</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setAutoEdit(boolean)">setAutoEdit</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setBlinking(boolean)">setBlinking</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setBlinkPattern(float[])">setBlinkPattern</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setDragSelectable(boolean)">setDragSelectable</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setGraphicStyle(org.opengis.go.display.style.GraphicStyle)">setGraphicStyle</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setMaxScale(double)">setMaxScale</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setMinScale(double)">setMinScale</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setName(java.lang.String)">setName</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setParent(org.opengis.go.display.primitive.Graphic)">setParent</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setPassingEventsToParent(boolean)">setPassingEventsToParent</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setPickable(boolean)">setPickable</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setSelected(boolean)">setSelected</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setShowingAnchorHandles(boolean)">setShowingAnchorHandles</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setShowingEditHandles(boolean)">setShowingEditHandles</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setSymbology(org.opengis.go.display.style.Symbology)">setSymbology</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setVisible(boolean)">setVisible</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setZOrderHint(double)">setZOrderHint</A>, <A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#toString()">toString</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_DisplayObject"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html" title="class in org.geotools.display.canvas">DisplayObject</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#addPropertyChangeListener(java.beans.PropertyChangeListener)">addPropertyChangeListener</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)">addPropertyChangeListener</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#clearCache()">clearCache</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#getImplHint(java.lang.String)">getImplHint</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#getRenderingHint(java.awt.RenderingHints.Key)">getRenderingHint</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#handleException(java.lang.String, java.lang.String, java.lang.Exception)">handleException</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#removePropertyChangeListener(java.beans.PropertyChangeListener)">removePropertyChangeListener</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)">removePropertyChangeListener</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#setImplHint(java.lang.String, java.lang.Object)">setImplHint</A>, <A HREF="../../../../org/geotools/display/canvas/DisplayObject.html#setRenderingHint(java.awt.RenderingHints.Key, java.lang.Object)">setRenderingHint</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="ReferencedGraphic(org.opengis.referencing.crs.CoordinateReferenceSystem)"><!-- --></A><H3>
ReferencedGraphic</H3>
<PRE>
protected <B>ReferencedGraphic</B>(CoordinateReferenceSystem&nbsp;crs)
                     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>Constructs a new graphic using the specified objective CRS.
<P>
<DT><B>Parameters:</B><DD><CODE>crs</CODE> - The objective coordinate reference system.
<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 null.<DT><B>See Also:</B><DD><A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)"><CODE>setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#setEnvelope(org.opengis.spatialschema.geometry.Envelope)"><CODE>setEnvelope(org.opengis.spatialschema.geometry.Envelope)</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#setTypicalCellDimension(double[])"><CODE>setTypicalCellDimension(double[])</CODE></A>, 
<A HREF="../../../../org/geotools/display/canvas/AbstractGraphic.html#setZOrderHint(double)"><CODE>AbstractGraphic.setZOrderHint(double)</CODE></A></DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getObjectiveCRS()"><!-- --></A><H3>
getObjectiveCRS</H3>
<PRE>
public final CoordinateReferenceSystem <B>getObjectiveCRS</B>()</PRE>
<DL>
<DD>Returns the objective coordinate reference system.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)"><!-- --></A><H3>
setObjectiveCRS</H3>
<PRE>
protected void <B>setObjectiveCRS</B>(CoordinateReferenceSystem&nbsp;crs)
                        throws TransformException</PRE>
<DL>
<DD>Sets the objective coordinate refernece system for this graphic. This method is usually
 invoked in any of the following cases:
 <p>
 <ul>
   <li>From the graphic constructor.</li>
   <li>When this graphic has just been added to a canvas.</li>
   <li>When canvas objective CRS is modified.</li>
 </ul>
 <p>
 This method transforms the <A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#getEnvelope()">envelope</A> if needed. If a
 subclass need to transform some additional internal data, it should override the
 <A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#transform(org.opengis.referencing.operation.MathTransform)"><CODE>transform(org.opengis.referencing.operation.MathTransform)</CODE></A> method.
 <p>
 This method fires a {@value}
 property change event.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>crs</CODE> - The new objective CRS.
<DT><B>Throws:</B>
<DD><CODE>TransformException</CODE> - If this method do not accept the new CRS. In such case,
         this method should keep the old CRS and leaves this graphic in a consistent state.</DL>
</DD>
</DL>
<HR>

<A NAME="transform(org.opengis.referencing.operation.MathTransform)"><!-- --></A><H3>
transform</H3>
<PRE>
protected void <B>transform</B>(MathTransform&nbsp;mt)
                  throws TransformException</PRE>
<DL>
<DD>Notifies subclasses that a new <A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#getObjectiveCRS()">objective CRS</A> has been set
 and the internal data should be transformed accordingly. This method is a hook invoked
 automatically by <A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)"><CODE>setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)</CODE></A>. The default implementation does nothing.
 Subclasses should override this method if they need to transform their internal data.
 <p>
 When <A HREF="../../../../org/geotools/display/canvas/ReferencedGraphic.html#setObjectiveCRS(org.opengis.referencing.crs.CoordinateReferenceSystem)"><CODE>setObjectiveCRS</CODE></A> invokes this method, this 
 object still in its old state. This method should have a <cite>all or nothing</cite>
 behavior: in case of failure, it should throws an exception and leave this 
 as if no change were applied at all.
<P>