View All Attachments for Bug 41955

This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Attachment #14386
HtmlRenderer javadoc	text/html	2004-04-14 14:43:42 UTC	38.84 KB	no flags	Details

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.4.2_04) on Tue Apr 13 15:47:00 CEST 2004 -->
<TITLE>
HtmlRenderer (NetBeans APIs)
</TITLE>

<META NAME="keywords" CONTENT="org.openide.awt.HtmlRenderer class">

<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../javadoc.css" TITLE="Style">

<SCRIPT type="text/javascript">
function windowTitle()
{
    parent.document.title="HtmlRenderer (NetBeans APIs)";
}
</SCRIPT>

</HEAD>

<BODY BGCOLOR="white" onload="windowTitle();">


<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/HtmlRenderer.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../org/openide/awt/HtmlLabelUI.html" title="class in org.openide.awt"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../org/openide/awt/JInlineMenu.html" title="class in org.openide.awt"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="HtmlRenderer.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>

</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;<A HREF="#nested_class_summary">NESTED</A>&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->

<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
org.openide.awt</FONT>
<BR>
Class HtmlRenderer</H2>
<PRE>
<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A>
  <IMG SRC="../../../resources/inherit.gif" ALT="extended by"><B>org.openide.awt.HtmlRenderer</B>
</PRE>
<HR>
<DL>
<DT>public final class <B>HtmlRenderer</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></DL>

<P>
A generic cell renderer class which implements
 a lightweight html renderer supporting a minimal subset of HTML used for
 markup purposes only - basic font styles, colors, etc.  Also supports
 named logical colors specified by a preceding ! character for specifying
 colors that should be looked up in the current look and feel's UIDefaults
 (e.g. <code>&lt;font color=&amp;!textText&amp&gt;</code>).
 <p>
 If you only need to paint some HTML quickly, use the static methods for
 painting - <code>renderString</code>, <code>renderPlainString</code> or
 <code>renderHtml</code>.  These methods differ as follows:
 <ul>
 <li><b>renderString</b> will check the string for opening HTML tags
 (upper or lower but not mixed case) and call either <code>renderPlainString</code>
 or <code>renderHtml</code> as appropriate.  Note this method does not tolerate
 whitespace in opening html tags - it expects exactly 6 characters to make up
 the opening tag if present.</li>
 <li><b>renderPlainString</b> simply renders a string to the graphics context,
 takes the same agruments as <code>renderHtml</code>, but will also honor
 <code>STYLE_TRUNCATE</code>, so strings can be rendered with trailing
 elipsis if there is not enough space</li>
 <li><b>renderHtml</b> renders whatever is passed to it as HTML, regardless
 of whether it has opening HTML tags or not.  It can be used to render plain
 strings, but <code>renderPlainString</code> is faster for that. It is useful
 if you want to render a string you <strong>know</strong> to be compliant
 HTML markup, but which does not have opening and closing HTML tags (though
 they are harmless if present). </li>
 <p>
 <strong>To reiterate: This is not a forgiving HTML parser - the HTML supplied
 must follow the guidelines documented here!</strong>
 <p>
 The following tags are supported, in upper or lower (but not mixed) case, with no excess whitespace in the tags:

 <table>
 <tr>
  <td>&lt;B&gt;</td>
  <td>Boldface text</td>
 </tr>
 <tr>
  <td>&lt;S&gt;</td>
  <td>Strikethrough text</td>
 </tr>
 <tr>
  <td>&lt;U&gt;</td>
  <td>Underline text</td>
 </tr>
 <tr>
  <td>&lt;I&gt;</td>
  <td>Italic text</td>
 </tr>
 <tr>
  <td>&lt;EM&gt;</td>
  <td>Emphasized text (same as italic)</td>
 </tr>
 <tr>
  <td>&lt;STRONG&gt;</td>
  <td>Strong text (same as bold)</td>
 </tr>
 <tr>
  <td>&lt;font&gt;</td>
  <td>Font color - font attributes other than color are not supported.  Colors
  may be specified as hexidecimal strings, such as #FF0000 or as logical colors
  defined in the current look and feel by specifying a ! character as the first
  character of the color name.  Logical colors are colors available from the
  current look and feel's UIManager.  For example, <code>&lt;font
  color=&quot;!Tree.background&quot;&gt;</code> will set the font color to the
  result of <code>UIManager.getColor(&quot;Tree.background&quot;)</code>.
 <strong>Font size tags are not supported.</strong>
 </td>
 </tr>
 </table>
 The lightweight html renderer supports the following named sgml character
 entities: <code>quot, lt, amp, lsquo, rsquo, ldquo, rdquo, ndash, mdash, ne,
 le, ge, copy, reg, trade.  </code>.  It also supports numeric entities
 (e.g. <code>&amp;8822;</code>).
 <p><b>Why not use the JDK's HTML support?</b> The JDK's HTML support works
 well for stable components, but suffers from performance problems in the
 case of cell renderers - each call to set the text (which happens once per
 cell, per paint) causes a document tree to be created in memory.  For small,
 markup only strings, this is a huge performance penalty.   For rendering short strings
 (for example, in a tree or table cell renderer)
 with limited HTML, this method is approximately 10x faster than standard
 Swing HTML rendering.

 <P><B><U>Specifying logical colors</U></B><BR>
 Hardcoded text colors are undesirable, as they can be incompatible (even
 invisible) on some look and feels or themes, depending on the background
 color.
 The lightweight HTML renderer supports a non-standard syntax for specifying
 font colors via a key for a color in the UI defaults for the current look
 and feel.  This is accomplished by prefixing the key name with a <code>!</code>
 character.  For example: <code>&lt;font color='!controlShadow'&gt;</code>.

 <P><B><U>Modes of operation</U></B><BR>
 This method supports two modes of operation:
 <OL>
 <LI><CODE>STYLE_CLIP</CODE> - as much text as will fit in the pixel width passed
 to the method should be painted, and the text should be cut off at the maximum
 width or clip rectangle maximum X boundary for the graphics object, whichever is
 smaller.</LI>
 <LI><CODE>STYLE_TRUNCATE</CODE> - paint as much text as will fit in the pixel
 width passed to the method, but paint the last three characters as .'s, in the
 same manner as a JLabel truncates its text when the available space is too
 small.</LI>
 </OL>
 <P>
 The paint methods can also be used in non-painting mode to establish the space
 necessary to paint a string.  This is accomplished by passing the value of the
 <code>paint</code> argument as false.  The return value will be the required
 width in pixels
 to display the text.  Note that in order to retrieve an
 accurate value, the argument for available width should be passed
 as <code>Integer.MAX_VALUE</code> or an appropriate maximum size - otherwise
 the return value will either be the passed maximum width or the required
 width, whichever is smaller.  Also, the clip shape for the passed graphics
 object should be null or a value larger than the maximum possible render size,
 or text size measurement will stop at the clip bounds.  <code>HtmlRenderer.getGraphics()</code>
 will always return non-null and non-clipped, and is suitable to pass in such a
 situation.
 <P>
 <b><u>Using the shared renderer instance</u></b><br>
 <code>HtmlRenderer</code> provides a simple cell renderer instance which can be used in trees, lists,
 tables, combo boxes, etc.  The nested <code>Renderer</code> interface extends all of the appropriate
 interfaces (<code>TreeCellRenderer, TableCellRenderer, ListCellRenderer</code>), to make it easy to
 drop it into a table, tree, list, etc.  If the objects you want to render do not return their display
 name from their <code>toString()</code> method, you may need a wrapper renderer class which will
 set the text appropriately before painting.
 <p>
 The <code>Renderer</code> interface has a <code>reset()</code> method, which resets all of the
 things that may have been altered (color, border, text alignment, icon, etc.).  This is called
 whenever <code>get[nnn]CellRenderer</code> is called, to ensure that its previous use in one
 component does not affect its appearance in another.
 <p>
 When <code>get[nnn]CellRenderer</code> is called, the renderer does not know if it has HTML text to
 render or plain text.  If nothing else is done, it will check for an opening HTML and thus decide
 whether to use plain text or HTML rendering.
 <p>
 If you <strong>know</strong> the text is going to contain compliant HTML markup, or the string contains
 HTML markup without opening/closing HTML tags, call <code>Renderer.setHtml(true)</code> after
 <code>get[nnn]CellRenderer()</code> is called, but before painting happens.  This may be before or
 after setting the text.  If your string contains HTML markup which you want rendered literally,
 call <code>Renderer.setHtml(false)</code> at the same point, and plain text rendering will be used
 regardless of the content of the string.
 <p>
 A convenience method exists to fetch a HTML renderer JLabel.  This is useful either for painting
 a string onto the screen using the html renderer - just call <code>HtmlRenderer.sharedLabel()</code>,
 set its text, icon, etc., and call <code>paint()</code>.  It is also useful if you need to measure
 the number of screen pixels a string will consume - set the text and font and call
 <code>getPreferredSize()</code><sup><font size=-2>*</font></sup>.  The returned label is guaranteed
 to be able to paint itself and calculate its preferred size correctly without needing to be added
 to a parent component.
 <p>
 <sup><font size=-2>*</font></sup><font size="-1">The size measured will be the size this HTML
 renderer will use on the screen for the text in question.  While usually close, this is not guaranteed to
 be exactly the same as a JLabel with the standard UI delegate would required.</font>
 <p>
 <strong>This class is absolutely not thread safe, and may not be called on any thread but the
 AWT event dispatch thread.</strong>
<P>

<P>
<HR>

<P>
<!-- ======== NESTED CLASS SUMMARY ======== -->

<A NAME="nested_class_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Nested Class Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;interface</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html" title="interface in org.openide.awt">HtmlRenderer.Renderer</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Interface aggregating TableCellRenderer, TreeCellRenderer and ListCellRenderer.</TD>
</TR>
</TABLE>
&nbsp;
<!-- =========== FIELD SUMMARY =========== -->

<A NAME="field_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Field Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.html#STYLE_CLIP">STYLE_CLIP</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constant used by <code>renderString</code>, <code>renderPlainString</code>
 <code>renderHTML</code>, and <code>HtmlRenderer.setRenderStyle</code>
 if painting should simply be cut off at the boundary of the cooordinates passed.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.html#STYLE_TRUNCATE">STYLE_TRUNCATE</A></B></CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constant used by <code>renderString</code>, <code>renderPlainString</code>
 <code>renderHTML</code>  and <code>HtmlRenderer.setRenderStyle</code> if
 painting should produce an ellipsis (...)
 if the text would overlap the boundary of the coordinates passed</TD>
</TR>
</TABLE>
&nbsp;
<!-- ======== CONSTRUCTOR SUMMARY ======== -->


<!-- ========== METHOD SUMMARY =========== -->

<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Method Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;double</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.html#renderHTML(java.lang.String, java.awt.Graphics, int, int, int, int, java.awt.Font, java.awt.Color, int, boolean)">renderHTML</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;s,
           <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Graphics.html" title="class or interface in java.awt">Graphics</A>&nbsp;g,
           int&nbsp;x,
           int&nbsp;y,
           int&nbsp;w,
           int&nbsp;h,
           <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Font.html" title="class or interface in java.awt">Font</A>&nbsp;f,
           <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Color.html" title="class or interface in java.awt">Color</A>&nbsp;defaultColor,
           int&nbsp;style,
           boolean&nbsp;paint)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Render a string as HTML using a fast, lightweight renderer supporting a limited
 subset of HTML.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;double</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.html#renderPlainString(java.lang.String, java.awt.Graphics, int, int, int, int, java.awt.Font, java.awt.Color, int, boolean)">renderPlainString</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;s,
                  <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Graphics.html" title="class or interface in java.awt">Graphics</A>&nbsp;g,
                  int&nbsp;x,
                  int&nbsp;y,
                  int&nbsp;w,
                  int&nbsp;h,
                  <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Font.html" title="class or interface in java.awt">Font</A>&nbsp;f,
                  <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Color.html" title="class or interface in java.awt">Color</A>&nbsp;defaultColor,
                  int&nbsp;style,
                  boolean&nbsp;paint)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Render a string to a graphics instance, using the same API as renderHTML().</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;double</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.html#renderString(java.lang.String, java.awt.Graphics, int, int, int, int, java.awt.Font, java.awt.Color, int, boolean)">renderString</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;s,
             <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Graphics.html" title="class or interface in java.awt">Graphics</A>&nbsp;g,
             int&nbsp;x,
             int&nbsp;y,
             int&nbsp;w,
             int&nbsp;h,
             <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Font.html" title="class or interface in java.awt">Font</A>&nbsp;f,
             <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Color.html" title="class or interface in java.awt">Color</A>&nbsp;defaultColor,
             int&nbsp;style,
             boolean&nbsp;paint)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Render a string to a graphics context, using HTML markup if the string
 begins with html tags.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/JLabel.html" title="class or interface in javax.swing">JLabel</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.html#sharedLabel()">sharedLabel</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;For HTML rendering jobs outside of trees/lists/tables, returns a JLabel which will paint its text using
 the lightweight HTML renderer.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;<A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html" title="interface in org.openide.awt">HtmlRenderer.Renderer</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.html#sharedRenderer()">sharedRenderer</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an instance of Renderer which may be used as a table/tree/list cell renderer.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/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.2/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/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.2/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.2/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.2/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.2/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.2/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.2/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.4.2/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.2/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.2/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 =========== -->

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

<A NAME="STYLE_CLIP"><!-- --></A><H3>
STYLE_CLIP</H3>
<PRE>
public static final int <B>STYLE_CLIP</B></PRE>
<DL>
<DD>Constant used by <code>renderString</code>, <code>renderPlainString</code>
 <code>renderHTML</code>, and <code>HtmlRenderer.setRenderStyle</code>
 if painting should simply be cut off at the boundary of the cooordinates passed.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openide.awt.HtmlRenderer.STYLE_CLIP">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="STYLE_TRUNCATE"><!-- --></A><H3>
STYLE_TRUNCATE</H3>
<PRE>
public static final int <B>STYLE_TRUNCATE</B></PRE>
<DL>
<DD>Constant used by <code>renderString</code>, <code>renderPlainString</code>
 <code>renderHTML</code>  and <code>HtmlRenderer.setRenderStyle</code> if
 painting should produce an ellipsis (...)
 if the text would overlap the boundary of the coordinates passed
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#org.openide.awt.HtmlRenderer.STYLE_TRUNCATE">Constant Field Values</A></DL>
</DL>

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


<!-- ============ 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="sharedRenderer()"><!-- --></A><H3>
sharedRenderer</H3>
<PRE>
public static final <A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html" title="interface in org.openide.awt">HtmlRenderer.Renderer</A> <B>sharedRenderer</B>()</PRE>
<DL>
<DD>Returns an instance of Renderer which may be used as a table/tree/list cell renderer.
 This method must be called on the AWT event thread.  If you <strong>know</strong> you will
 be passing it legal HTML (legal as documented here), call <code>setHtml(true)</code> on the
 result of this call <strong>after calling getNNNCellRenderer</code> to provide this hint.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>A cell renderer that can render HTML.</DL>
</DD>
</DL>
<HR>

<A NAME="sharedLabel()"><!-- --></A><H3>
sharedLabel</H3>
<PRE>
public static final <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/JLabel.html" title="class or interface in javax.swing">JLabel</A> <B>sharedLabel</B>()</PRE>
<DL>
<DD>For HTML rendering jobs outside of trees/lists/tables, returns a JLabel which will paint its text using
 the lightweight HTML renderer.  The result of this call will implement the <code>Renderer</code> interface.
 The state of the renderer is reset before it is returned, so any artifacts of previous usage (border, etc)
 are eliminated.
 <p>
 Do <strong>not</strong> add the result of this call to the AWT hierarchy - it is designed for offscreen
 painting, and may be reconfigured to paint something else at any time.
 <p>
 This method must be called from the AWT event thread.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>A JLabel</DL>
</DD>
</DL>
<HR>

<A NAME="renderPlainString(java.lang.String, java.awt.Graphics, int, int, int, int, java.awt.Font, java.awt.Color, int, boolean)"><!-- --></A><H3>
renderPlainString</H3>
<PRE>
public static double <B>renderPlainString</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;s,
                                       <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Graphics.html" title="class or interface in java.awt">Graphics</A>&nbsp;g,
                                       int&nbsp;x,
                                       int&nbsp;y,
                                       int&nbsp;w,
                                       int&nbsp;h,
                                       <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Font.html" title="class or interface in java.awt">Font</A>&nbsp;f,
                                       <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Color.html" title="class or interface in java.awt">Color</A>&nbsp;defaultColor,
                                       int&nbsp;style,
                                       boolean&nbsp;paint)</PRE>
<DL>
<DD>Render a string to a graphics instance, using the same API as renderHTML().
 Can render a string using JLabel-style ellipsis (...) in the case that
 it will not fit in the passed rectangle, if the style parameter is
 STYLE_CLIP. Returns the width in pixels successfully painted.
 <strong>This method is not thread-safe and should not be called off
 the AWT thread.</strong>
<P>
<DD><DL>
<DT><B>See Also:</B><DD><A HREF="../../../org/openide/awt/HtmlRenderer.html#renderHTML(java.lang.String, java.awt.Graphics, int, int, int, int, java.awt.Font, java.awt.Color, int, boolean)"><CODE>renderHTML(java.lang.String, java.awt.Graphics, int, int, int, int, java.awt.Font, java.awt.Color, int, boolean)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="renderString(java.lang.String, java.awt.Graphics, int, int, int, int, java.awt.Font, java.awt.Color, int, boolean)"><!-- --></A><H3>
renderString</H3>
<PRE>
public static double <B>renderString</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;s,
                                  <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Graphics.html" title="class or interface in java.awt">Graphics</A>&nbsp;g,
                                  int&nbsp;x,
                                  int&nbsp;y,
                                  int&nbsp;w,
                                  int&nbsp;h,
                                  <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Font.html" title="class or interface in java.awt">Font</A>&nbsp;f,
                                  <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Color.html" title="class or interface in java.awt">Color</A>&nbsp;defaultColor,
                                  int&nbsp;style,
                                  boolean&nbsp;paint)</PRE>
<DL>
<DD>Render a string to a graphics context, using HTML markup if the string
 begins with html tags.  Delegates to <code>renderPlainString()</code>
 or <code>renderHTML()</code> as appropriate.  See the documentation for
 <code>renderHTML()</code> for details of the subset of HTML that is
 supported.
 <P><strong>This method is not thread-safe and should not be called off
 the AWT thread.</strong>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>s</CODE> - The string to render<DD><CODE>g</CODE> - A graphics object into which the string should be drawn, or which should be
 used for calculating the appropriate size<DD><CODE>x</CODE> - The x coordinate to paint at.<DD><CODE>y</CODE> - The y position at which to paint.  Note that this method does not calculate font
 height/descent - this value should be the baseline for the line of text, not
 the upper corner of the rectangle to paint in.<DD><CODE>w</CODE> - The maximum width within which to paint.<DD><CODE>h</CODE> - The maximum height within which to paint.<DD><CODE>f</CODE> - The base font to be used for painting or calculating string width/height.<DD><CODE>defaultColor</CODE> - The base color to use if no font color is specified as html tags<DD><CODE>style</CODE> - The wrapping style to use, either <code>STYLE_CLIP</CODE>,
 or <CODE>STYLE_TRUNCATE</CODE><DD><CODE>paint</CODE> - True if actual painting should occur.  If false, this method will not actually
 paint anything, only return a value representing the width/height needed to
 paint the passed string.
<DT><B>Returns:</B><DD>The width in pixels required
 to paint the complete string, or the passed parameter <code>w</code> if it is
 smaller than the required width.</DL>
</DD>
</DL>
<HR>

<A NAME="renderHTML(java.lang.String, java.awt.Graphics, int, int, int, int, java.awt.Font, java.awt.Color, int, boolean)"><!-- --></A><H3>
renderHTML</H3>
<PRE>
public static double <B>renderHTML</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;s,
                                <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Graphics.html" title="class or interface in java.awt">Graphics</A>&nbsp;g,
                                int&nbsp;x,
                                int&nbsp;y,
                                int&nbsp;w,
                                int&nbsp;h,
                                <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Font.html" title="class or interface in java.awt">Font</A>&nbsp;f,
                                <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Color.html" title="class or interface in java.awt">Color</A>&nbsp;defaultColor,
                                int&nbsp;style,
                                boolean&nbsp;paint)</PRE>
<DL>
<DD>Render a string as HTML using a fast, lightweight renderer supporting a limited
 subset of HTML.  The following tags are supported, in upper or lower case:

 <table>
 <tr>
  <td>&lt;B&gt;</td>
  <td>Boldface text</td>
 </tr>
 <tr>
  <td>&lt;S&gt;</td>
  <td>Strikethrough text</td>
 </tr>
 <tr>
  <td>&lt;U&gt;</td>
  <td>Underline text</td>
 </tr>
 <tr>
  <td>&lt;I&gt;</td>
  <td>Italic text</td>
 </tr>
 <tr>
  <td>&lt;EM&gt;</td>
  <td>Emphasized text (same as italic)</td>
 </tr>
 <tr>
  <td>&lt;STRONG&gt;</td>
  <td>Strong text (same as bold)</td>
 </tr>
 <tr>
  <td>&lt;font&gt;</td>
  <td>Font color - font attributes other than color are not supported.  Colors
  may be specified as hexidecimal strings, such as #FF0000 or as logical colors
  defined in the current look and feel by specifying a ! character as the first
  character of the color name.  Logical colors are colors available from the
  current look and feel's UIManager.  For example, <code>&lt;font
  color=&quot;!Tree.background&quot;&gt;</code> will set the font color to the
  result of <code>UIManager.getColor(&quot;Tree.background&quot)</code>.
 <strong>Font size tags are not supported.</strong>
 </td>
 </tr>
 </table>
 The lightweight html renderer supports the following named sgml character
 entities: <code>quot, lt, amp, lsquo, rsquo, ldquo, rdquo, ndash, mdash, ne,
 le, ge, copy, reg, trade.  </code>.  It also supports numeric entities
 (e.g. <code>&amp;8822;</code>).
 <p><b>When to use this method instead of the JDK's HTML support: </b> when
 rendering short strings (for example, in a tree or table cell renderer)
 with limited HTML, this method is approximately 10x faster than JDK HTML
 rendering (it does not build and parse a document tree).

 <P><B><U>Specifying logical colors</U></B><BR>
 Hardcoded text colors are undesirable, as they can be incompatible (even
 invisible) on some look and feels or themes.
 The lightweight HTML renderer supports a non-standard syntax for specifying
 font colors via a key for a color in the UI defaults for the current look
 and feel.  This is accomplished by prefixing the key name with a <code>!</code>
 character.  For example: <code>&lt;font color='!controlShadow'&gt;</code>.

 <P><B><U>Modes of operation</U></B><BR>
 This method supports two modes of operation:
 <OL>
 <LI><CODE>STYLE_CLIP</CODE> - as much text as will fit in the pixel width passed
 to the method should be painted, and the text should be cut off at the maximum
 width or clip rectangle maximum X boundary for the graphics object, whichever is
 smaller.</LI>
 <LI><CODE>STYLE_TRUNCATE</CODE> - paint as much text as will fit in the pixel
 width passed to the method, but paint the last three characters as .'s, in the
 same manner as a JLabel truncates its text when the available space is too
 small.</LI>
 </OL>
 <P>
 This method can also be used in non-painting mode to establish the space
 necessary to paint a string.  This is accomplished by passing the value of the
 <code>paint</code> argument as false.  The return value will be the required
 width in pixels
 to display the text.  Note that in order to retrieve an
 accurate value, the argument for available width should be passed
 as <code>Integer.MAX_VALUE</code> or an appropriate maximum size - otherwise
 the return value will either be the passed maximum width or the required
 width, whichever is smaller.  Also, the clip shape for the passed graphics
 object should be null or a value larger than the maximum possible render size.
 <P>
 This method will log a warning if it encounters HTML markup it cannot
 render.  To aid diagnostics, if NetBeans is run with the argument
 <code>-J-Dnetbeans.lwhtml.strict=true</code> an exception will be thrown
 when an attempt is made to render unsupported HTML.</code><p>
 <strong>This method is not thread-safe and should not be called off
 the AWT thread!</strong>
 <p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>s</CODE> - The string to render<DD><CODE>g</CODE> - A graphics object into which the string should be drawn, or which should be
 used for calculating the appropriate size<DD><CODE>x</CODE> - The x coordinate to paint at.<DD><CODE>y</CODE> - The y position at which to paint.  Note that this method does not calculate font
 height/descent - this value should be the baseline for the line of text, not
 the upper corner of the rectangle to paint in.<DD><CODE>w</CODE> - The maximum width within which to paint.<DD><CODE>h</CODE> - The maximum height within which to paint.<DD><CODE>f</CODE> - The base font to be used for painting or calculating string width/height.<DD><CODE>defaultColor</CODE> - The base color to use if no font color is specified as html tags<DD><CODE>style</CODE> - The wrapping style to use, either <code>STYLE_CLIP</CODE>,
 or <CODE>STYLE_TRUNCATE</CODE><DD><CODE>paint</CODE> - True if actual painting should occur.  If false, this method will not actually
 paint anything, only return a value representing the width/height needed to
 paint the passed string (height only in the case of word wrap, which is currently not exposed
 in the API).
<DT><B>Returns:</B><DD>The width in pixels required
 to paint the complete string, or the passed parameter <code>w</code> if it is
 smaller than the required width.</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/HtmlRenderer.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../org/openide/awt/HtmlLabelUI.html" title="class in org.openide.awt"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../org/openide/awt/JInlineMenu.html" title="class in org.openide.awt"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="HtmlRenderer.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>

</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;<A HREF="#nested_class_summary">NESTED</A>&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<span class="footnote">Built on April 13 2004.&nbsp;&nbsp;|&nbsp;&nbsp;Portions Copyright 1997-2003 Sun Microsystems, Inc. All rights reserved.</span>
</BODY>
</HTML>

Attachment #14388
HtmlRenderer.Renderer javadoc	text/html	2004-04-14 14:46:13 UTC	19.18 KB	no flags	Details

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.4.2_04) on Tue Apr 13 15:46:59 CEST 2004 -->
<TITLE>
HtmlRenderer.Renderer (NetBeans APIs)
</TITLE>

<META NAME="keywords" CONTENT="org.openide.awt.HtmlRenderer.Renderer interface">

<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../javadoc.css" TITLE="Style">

<SCRIPT type="text/javascript">
function windowTitle()
{
    parent.document.title="HtmlRenderer.Renderer (NetBeans APIs)";
}
</SCRIPT>

</HEAD>

<BODY BGCOLOR="white" onload="windowTitle();">


<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/HtmlRenderer.Renderer.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../org/openide/awt/HtmlBrowser.Factory.html" title="interface in org.openide.awt"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../org/openide/awt/SpinButtonListener.html" title="interface in org.openide.awt"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="HtmlRenderer.Renderer.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>

</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->

<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
org.openide.awt</FONT>
<BR>
Interface HtmlRenderer.Renderer</H2>
<DL>
<DT><B>All Superinterfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/ListCellRenderer.html" title="class or interface in javax.swing">ListCellRenderer</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/table/TableCellRenderer.html" title="class or interface in javax.swing.table">TableCellRenderer</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/tree/TreeCellRenderer.html" title="class or interface in javax.swing.tree">TreeCellRenderer</A></DD>
</DL>
<DL>
<DT><B>Enclosing interface:</B><DD><A HREF="../../../org/openide/awt/HtmlRenderer.html" title="class in org.openide.awt">HtmlRenderer</A></DD>
</DL>
<HR>
<DL>
<DT>public static interface <B>HtmlRenderer.Renderer</B><DT>extends <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/table/TableCellRenderer.html" title="class or interface in javax.swing.table">TableCellRenderer</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/tree/TreeCellRenderer.html" title="class or interface in javax.swing.tree">TreeCellRenderer</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/ListCellRenderer.html" title="class or interface in javax.swing">ListCellRenderer</A></DL>

<P>
Interface aggregating TableCellRenderer, TreeCellRenderer and ListCellRenderer.
 Return type of <code>sharedInstance()</code>.
<P>

<P>
<HR>

<P>
<!-- ======== NESTED CLASS SUMMARY ======== -->


<!-- =========== FIELD SUMMARY =========== -->


<!-- ======== CONSTRUCTOR SUMMARY ======== -->


<!-- ========== METHOD SUMMARY =========== -->

<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Method Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html#reset()">reset</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Clear any stale data from previous use by other components,
 clearing the icon, text, disabled state and other customizations, returning the component
 to its initialized state.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html#setCentered(boolean)">setCentered</A></B>(boolean&nbsp;centered)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Indicate that the text should be painted centered below the icon.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html#setHtml(boolean)">setHtml</A></B>(boolean&nbsp;val)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Explicitly tell the renderer it is going to receive HTML markup, or it is not.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html#setIcon(javax.swing.Icon)">setIcon</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/Icon.html" title="class or interface in javax.swing">Icon</A>&nbsp;icon)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the icon to be used for painting</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html#setIconTextGap(int)">setIconTextGap</A></B>(int&nbsp;gap)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Convenience method to set the gap between the icon and text.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html#setIndent(int)">setIndent</A></B>(int&nbsp;pixels)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set a number of pixels the icon and text should be indented.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html#setParentFocused(boolean)">setParentFocused</A></B>(boolean&nbsp;parentFocused)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Indicate that the component being rendered has keyboard focus.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html#setRenderStyle(int)">setRenderStyle</A></B>(int&nbsp;style)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the rendering style - this can be JLabel-style truncated-with-elipsis (...) text, or clipped text.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/openide/awt/HtmlRenderer.Renderer.html#setText(java.lang.String)">setText</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;txt)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the text to be displayed.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.swing.table.TableCellRenderer"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from interface javax.swing.table.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/table/TableCellRenderer.html" title="class or interface in javax.swing.table">TableCellRenderer</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/table/TableCellRenderer.html#getTableCellRendererComponent(javax.swing.JTable, java.lang.Object, boolean, boolean, int, int)" title="class or interface in javax.swing.table">getTableCellRendererComponent</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.swing.tree.TreeCellRenderer"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from interface javax.swing.tree.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/tree/TreeCellRenderer.html" title="class or interface in javax.swing.tree">TreeCellRenderer</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/tree/TreeCellRenderer.html#getTreeCellRendererComponent(javax.swing.JTree, java.lang.Object, boolean, boolean, boolean, int, boolean)" title="class or interface in javax.swing.tree">getTreeCellRendererComponent</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_javax.swing.ListCellRenderer"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from interface javax.swing.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/ListCellRenderer.html" title="class or interface in javax.swing">ListCellRenderer</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/ListCellRenderer.html#getListCellRendererComponent(javax.swing.JList, java.lang.Object, int, boolean, boolean)" title="class or interface in javax.swing">getListCellRendererComponent</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

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


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


<!-- ============ 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="setParentFocused(boolean)"><!-- --></A><H3>
setParentFocused</H3>
<PRE>
public void <B>setParentFocused</B>(boolean&nbsp;parentFocused)</PRE>
<DL>
<DD>Indicate that the component being rendered has keyboard focus.  NetBeans requires that a different
 selection color be used depending on whether the view has focus.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>parentFocused</CODE> - Whether or not the focused selection color should be used</DL>
</DD>
</DL>
<HR>

<A NAME="setCentered(boolean)"><!-- --></A><H3>
setCentered</H3>
<PRE>
public void <B>setCentered</B>(boolean&nbsp;centered)</PRE>
<DL>
<DD>Indicate that the text should be painted centered below the icon.  This is primarily used
 by org.openide.explorer.view.IconView
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>centered</CODE> - Whether or not centered painting should be used.</DL>
</DD>
</DL>
<HR>

<A NAME="setIndent(int)"><!-- --></A><H3>
setIndent</H3>
<PRE>
public void <B>setIndent</B>(int&nbsp;pixels)</PRE>
<DL>
<DD>Set a number of pixels the icon and text should be indented.  Used by ChoiceView and ListView to
 fake tree-style nesting.  This value has no effect if <code>setCentered(true)</code> has been called.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pixels</CODE> - The number of pixels to indent</DL>
</DD>
</DL>
<HR>

<A NAME="setHtml(boolean)"><!-- --></A><H3>
setHtml</H3>
<PRE>
public void <B>setHtml</B>(boolean&nbsp;val)</PRE>
<DL>
<DD>Explicitly tell the renderer it is going to receive HTML markup, or it is not.  If the renderer should
 check the string for opening HTML tags to determine this, don't call this method.  If you <strong>know</strong>
 the string will be compliant HTML, it is preferable to call this method with true; if you want to intentionally
 render HTML markup literally, call this method with false.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>val</CODE> - </DL>
</DD>
</DL>
<HR>

<A NAME="setRenderStyle(int)"><!-- --></A><H3>
setRenderStyle</H3>
<PRE>
public void <B>setRenderStyle</B>(int&nbsp;style)</PRE>
<DL>
<DD>Set the rendering style - this can be JLabel-style truncated-with-elipsis (...) text, or clipped text.
 The default is STYLE_CLIP.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>style</CODE> - The text style</DL>
</DD>
</DL>
<HR>

<A NAME="setIcon(javax.swing.Icon)"><!-- --></A><H3>
setIcon</H3>
<PRE>
public void <B>setIcon</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/javax/swing/Icon.html" title="class or interface in javax.swing">Icon</A>&nbsp;icon)</PRE>
<DL>
<DD>Set the icon to be used for painting
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>icon</CODE> - An icon or null</DL>
</DD>
</DL>
<HR>

<A NAME="reset()"><!-- --></A><H3>
reset</H3>
<PRE>
public void <B>reset</B>()</PRE>
<DL>
<DD>Clear any stale data from previous use by other components,
 clearing the icon, text, disabled state and other customizations, returning the component
 to its initialized state.  This is done automatically when get*CellRenderer() is called.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setText(java.lang.String)"><!-- --></A><H3>
setText</H3>
<PRE>
public void <B>setText</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;txt)</PRE>
<DL>
<DD>Set the text to be displayed.  Use this if the object being rendered's toString() does not
 return a real user-displayable string, after calling get**CellRenderer().  Typically after calling
 this one calls setHtml() if the text is known to either be or not be HTML markup.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>txt</CODE> - The text that should be displayed</DL>
</DD>
</DL>
<HR>

<A NAME="setIconTextGap(int)"><!-- --></A><H3>
setIconTextGap</H3>
<PRE>
public void <B>setIconTextGap</B>(int&nbsp;gap)</PRE>
<DL>
<DD>Convenience method to set the gap between the icon and text.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>gap</CODE> - an integer number of pixels</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/HtmlRenderer.Renderer.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../org/openide/awt/HtmlBrowser.Factory.html" title="interface in org.openide.awt"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../org/openide/awt/SpinButtonListener.html" title="interface in org.openide.awt"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="HtmlRenderer.Renderer.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>

</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<span class="footnote">Built on April 13 2004.&nbsp;&nbsp;|&nbsp;&nbsp;Portions Copyright 1997-2003 Sun Microsystems, Inc. All rights reserved.</span>
</BODY>
</HTML>