acm.util

Class JTFTools

java.lang.Object

acm.util.JTFTools

public class JTFTools
extends java.lang.Object

This class provides a small collection of static utility methods that are used elsewhere in the ACM packages.

Constructor Summary

Constructors

Constructor and Description
JTFTools()

Method Summary

Methods

Modifier and Type	Method and Description
static java.awt.Container	createEmptyContainer() Returns an empty lightweight container.
static java.awt.Color	decodeColor(java.lang.String name) Decodes a color name.
static java.awt.Font	decodeFont(java.lang.String str) Decodes a font in the style of Font.decode.
static java.awt.Font	decodeFont(java.lang.String str, java.awt.Font oldFont) Decodes a font in the style of Font.decode.
static java.applet.Applet	getApplet() Returns the current applet.
static java.awt.Frame	getEnclosingFrame(java.awt.Component comp) Returns the frame that encloses the specified component.
static java.awt.Font	getStandardFont(java.awt.Font font) Returns a font that will approximate the specified font in this environment.
static boolean	isAnonymous(java.lang.Thread t) Returns true if the supplied thread is an anonymous one created automatically by the system.
static void	pause(double milliseconds) Delays the calling thread for the specified time, which is expressed in milliseconds.
static void	registerApplet(java.applet.Applet applet) Adds this applet to a table indexed by the current thread.
static void	registerApplet(java.applet.Applet applet, java.lang.Thread thread) Adds this applet to a table indexed by the specified thread.
static void	terminateAppletThreads(java.applet.Applet applet) Terminates all of the threads that are registered as belonging to the specified applet.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JTFTools

public JTFTools()

Method Detail

createEmptyContainer

public static java.awt.Container createEmptyContainer()

Returns an empty lightweight container. Several packages need to create such components as placeholders. Defining it in JTFTools gives those pacakges access to a common mechanism.

Returns:

An empty lightweight container that can be used as a placeholder

getEnclosingFrame

public static java.awt.Frame getEnclosingFrame(java.awt.Component comp)

Returns the frame that encloses the specified component.

Parameters:

comp - The component at which to start the search

Returns:

The nearest enclosing Frame object

getStandardFont

public static java.awt.Font getStandardFont(java.awt.Font font)

Returns a font that will approximate the specified font in this environment. This method is required because some browsers do not support the standard fonts Serif, SansSerif, and Monospaced.

Parameters:

font - The font being checked

Returns:

The new font

decodeFont

public static java.awt.Font decodeFont(java.lang.String str)

Decodes a font in the style of Font.decode.

Parameters:

str - The string to decode

Returns:

The new font

decodeFont

public static java.awt.Font decodeFont(java.lang.String str,
                       java.awt.Font oldFont)

Decodes a font in the style of Font.decode. The only difference is that this method takes a font parameter that gives default values for the different parts of the font. If the family, size, or style is specified as an asterisk, the corresponding value is taken from the supplied font.

Parameters:

str - The string to decode

oldFont - The font whose properties are used as defaults

Returns:

The new font

decodeColor

public static java.awt.Color decodeColor(java.lang.String name)

Decodes a color name. This method is similar to Color.decode except in that it allows named colors and system colors.

Parameters:

name - The string name of the color

Returns:

The color corresponding to the specified name

registerApplet

public static void registerApplet(java.applet.Applet applet)

Adds this applet to a table indexed by the current thread.

Parameters:

applet - The applet being registered

registerApplet

public static void registerApplet(java.applet.Applet applet,
                  java.lang.Thread thread)

Adds this applet to a table indexed by the specified thread.

Parameters:

applet - The applet being registered

thread - The thread used as the key

getApplet

public static java.applet.Applet getApplet()

Returns the current applet. This implementation may fail in multithreaded programs. Such programs should therefore not rely on this facility. It is appropriate to use this facility, for example, during the init method of a program, which is the only context in which it is applied in the JTF tools.

Returns:

The currently running applet

pause

public static void pause(double milliseconds)

Delays the calling thread for the specified time, which is expressed in milliseconds. Unlike Thread.sleep, this method never throws an exception.

Parameters:

milliseconds - The sleep time in milliseconds

terminateAppletThreads

public static void terminateAppletThreads(java.applet.Applet applet)

Terminates all of the threads that are registered as belonging to the specified applet.

Parameters:

applet - The applet whose threads are being terminated

isAnonymous

public static boolean isAnonymous(java.lang.Thread t)

Returns true if the supplied thread is an anonymous one created automatically by the system.

Parameters:

t - The thread being tested