org.openide.filesystems 7.13.1 1

org.openide.filesystems
Interface FileSystem.HtmlStatus

All Superinterfaces:
FileSystem.Status
Enclosing class:
FileSystem

public static interface FileSystem.HtmlStatus
extends FileSystem.Status

Extension interface for Status provides HTML-formatted annotations. Principally this is used to deemphasize status text by presenting it in a lighter color, by placing it inside <font color=!controlShadow> tags. Note that it is preferable to use logical colors (such as controlShadow) which are resolved by calling UIManager.getColor(key) - this way they will always fit with the look and feel. To use a logical color, prefix the color name with a ! character.

Please use only the limited markup subset of HTML supported by the lightweight HTML renderer.

Since:
4.30
See Also:
HtmlRenderer

Method Summary
 String annotateNameHtml(String name, Set<? extends FileObject> files)
          Annotate a name such that the returned value contains HTML markup.
 
Methods inherited from interface org.openide.filesystems.FileSystem.Status
annotateIcon, annotateName
 

Method Detail

annotateNameHtml

String annotateNameHtml(String name,
                        Set<? extends FileObject> files)
Annotate a name such that the returned value contains HTML markup. The return value less the HTML content should typically be the same as the return value from annotateName(). This is used, for example, by VCS filesystems to deemphasize the status information included in the file name by using a light grey font color.

For consistency with Node.getHtmlDisplayName(), filesystems that proxy other filesystems (and so must implement this interface to supply HTML annotations) should return null if the filesystem they proxy does not provide an implementation of FileSystem.HtmlStatus.

Parameters:
name - the name suggested by default. It cannot contain HTML markup tags but must escape HTML metacharacters. For example "<default package>" is illegal but "&lt;default package&gt;" is fine.
files - an immutable set of FileObjects belonging to this filesystem
Returns:
the annotated name. It may be the same as the passed-in name. It may be null if getStatus returned status that doesn't implement HtmlStatus but plain Status.
Since:
4.30
See Also:
DataNode.getHtmlDisplayName(), Node.getHtmlDisplayName()

org.openide.filesystems 7.13.1 1

Built on April 7 2009.  |  Portions Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.