Package VASSAL.build

Class Widget

java.lang.Object

VASSAL.build.AbstractBuildable

VASSAL.build.AbstractConfigurable

VASSAL.build.Widget

All Implemented Interfaces:

AutoConfigurable, Buildable, Configurable, PropertyNameSource, ValidityChecker, Translatable

Direct Known Subclasses:

BoxWidget, Chart, ChartWindow, HtmlChart, ListWidget, MapWidget, PanelWidget, PieceSlot, PieceWindow, TabWidget

public abstract class Widget
extends AbstractConfigurable

A general-purpose configurable GUI container Widgets are Configurable objects that represent AWT components. Adding a Widget to another Widget during a Buildable.build(org.w3c.dom.Element) operation will add the corresponding AWT component of the child to the component of the parent

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Widget.MyCellRenderer

Nested classes/interfaces inherited from interface VASSAL.build.AutoConfigurable

AutoConfigurable.Util

Field Summary

Fields

Modifier and Type	Field	Description
protected Element	buildElement
static String	HEIGHT
static String	NAME
protected Widget	parent
static String	WIDTH

Fields inherited from class VASSAL.build.AbstractConfigurable

changeSupport, config, localizedName, myI18nData, name

Fields inherited from class VASSAL.build.AbstractBuildable

buildComponents, validator

Fields inherited from interface VASSAL.build.Configurable

NAME_PROPERTY

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Widget()

Method Summary

Modifier and Type	Method	Description
void	addTo(Buildable b)	Adds this component to its parent.
void	build(Element el)	For memory efficiency reasons, a Widget is initialized lazily.
Class<?>[]	getAllowableConfigureComponents()	The allowable Configurable components of a Widget are the same as its parent
Element	getBuildElement(Document doc)
abstract Component	getComponent()
Configurable[]	getConfigureComponents()
HelpFile	getHelpFile()
Widget	getParent()
double	getScale()
boolean	hasScale()
protected void	rebuild()	Perform the build of this Buildable component using the element stored from when the the build(org.w3c.dom.Element) method was invoked
void	removeFrom(Buildable b)	Remove this component from its parent

Methods inherited from class VASSAL.build.AbstractConfigurable

add, addPropertyChangeListener, getAttributeDescriptions, getAttributeTypes, getAttributeVisibility, getConfigureName, getConfigurer, getI18nData, getI18nPrefix, getLocalizedConfigureName, remove, removePropertyChangeListener, setAllAttributesUntranslatable, setAttributeTranslatable, setConfigureName

Methods inherited from class VASSAL.build.AbstractBuildable

getAllDescendantComponents, getAllDescendantComponentsOf, getAttributeNames, getAttributeValueString, getBuildables, getBuildComponents, getComponents, getComponentsOf, getPropertyNames, setAttribute, validate

Methods inherited from class java.lang.Object

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

Methods inherited from interface VASSAL.build.AutoConfigurable

getAttributeNames, getAttributeValueString, setAttribute

Field Details

NAME

public static final String NAME

See Also:

Constant Field Values

WIDTH

public static final String WIDTH

See Also:

Constant Field Values

HEIGHT

public static final String HEIGHT

See Also:

Constant Field Values

buildElement

protected Element buildElement

parent

protected Widget parent

Constructor Details

Widget

protected Widget()

Method Details

hasScale

public boolean hasScale()

getScale

public double getScale()

build

public void build(Element el)

For memory efficiency reasons, a Widget is initialized lazily. This method only stores the element from which the build the Widget. The Widget is built from the stored element by invoking rebuild(). Subclasses should invoke rebuild() before invoking getComponent()

Specified by:

build in interface Buildable

Overrides:

build in class AbstractBuildable

Parameters:

el - the XML element containing the object data

rebuild

protected void rebuild()

Perform the build of this Buildable component using the element stored from when the the build(org.w3c.dom.Element) method was invoked

getBuildElement

public Element getBuildElement(Document doc)

Specified by:

getBuildElement in interface Buildable

Overrides:

getBuildElement in class AbstractBuildable

Returns:

an XML element from which this component can be built

getAllowableConfigureComponents

public Class<?>[] getAllowableConfigureComponents()

The allowable Configurable components of a Widget are the same as its parent

addTo

public void addTo(Buildable b)

Description copied from interface: Buildable

Adds this component to its parent. In order to make Buildable objects extensible, the child is reponsible for adding itself to the parent. That way, Buildable subcomponents can be defined in an extension package without needing to modify the containing class.

removeFrom

public void removeFrom(Buildable b)

Description copied from interface: Configurable

Remove this component from its parent

getParent

public Widget getParent()

getConfigureComponents

public Configurable[] getConfigureComponents()

Specified by:

getConfigureComponents in interface Configurable

Overrides:

getConfigureComponents in class AbstractConfigurable

Returns:

A list of all child components (i.e. subcomponents) of this component that are configurable.

getComponent

public abstract Component getComponent()

Returns:

the Component for this widget. For efficiency, the Component may be initialized lazily instead of being created in the Buildable.build(org.w3c.dom.Element) method

getHelpFile

public HelpFile getHelpFile()

Returns:

a HelpFilte describing how to use and configure this component