Package VASSAL.build

Class Widget

java.lang.Object

VASSAL.search.AbstractImageFinder

VASSAL.build.AbstractBuildable

VASSAL.build.AbstractConfigurable

VASSAL.build.Widget

All Implemented Interfaces:

AutoConfigurable, Buildable, Configurable, PropertyNameSource, ComponentDescription, ValidityChecker, Translatable, Auditable, ImageSearchTarget, SearchTarget

Direct Known Subclasses:

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

public abstract class Widget
extends AbstractConfigurable
implements ComponentDescription

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
protected String	description
static final String	DESCRIPTION
static final String	HEIGHT
static final String	NAME
protected Widget	parent
static final 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 determined by its parent's Child-Allowable method.
Element	getBuildElement(Document doc)
Class<?>[]	getChildAllowableConfigureComponents()	Allowable components for a CHILD of this class - default is to ask our parent for this list.
abstract Component	getComponent()
Configurable[]	getConfigureComponents()
String	getDescription()
HelpFile	getHelpFile()
Widget	getParent()
double	getScale()
boolean	hasScalablePieces()
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, getExpressionList, getFormattedStringList, getI18nData, getI18nPrefix, getLocalizedConfigureName, getMenuTextList, getNamedKeyStrokeList, getPropertyList, getTypeName, remove, removePropertyChangeListener, setAllAttributesUntranslatable, setAttributeTranslatable, setConfigureName

Methods inherited from class VASSAL.build.AbstractBuildable

addImageNamesRecursively, buildString, getAllDescendantComponentsOf, getAncestor, getAttributeNames, getAttributeValueString, getBuildables, getBuildComponents, getComponents, getComponentsOf, getNonFolderAncestor, getPropertyNames, setAncestor, setAttribute, validate

Methods inherited from class VASSAL.search.AbstractImageFinder

addLocalImageNames, getAllImageNames, getLocalImageNames

Methods inherited from class java.lang.Object

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

Methods inherited from interface VASSAL.script.expression.Auditable

getComponentName, getComponentTypeName

Methods inherited from interface VASSAL.build.AutoConfigurable

getAttributeNames, getAttributeValueString, setAttribute

Methods inherited from interface VASSAL.build.Buildable

isMandatory, isMovable, isUnique

Field Details

DESCRIPTION

public static final String DESCRIPTION

See Also:

• Constant Field Values

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

description

protected String description

Constructor Details

Widget

protected Widget()

Method Details

hasScale

public boolean hasScale()

hasScalablePieces

public boolean hasScalablePieces()

Returns:

false if we're a child of a ChartWindow, meaning there won't be pieces to scale

getScale

public double getScale()

getDescription

public String getDescription()

Specified by:

getDescription in interface ComponentDescription

Returns:

Description to be displayed next to component type/name in the main Editor window. Or null or "" to not display anything.

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

Parameters:

doc - XML file

Returns:

an XML element from which this component can be built

getChildAllowableConfigureComponents

public Class<?>[] getChildAllowableConfigureComponents()

Allowable components for a CHILD of this class - default is to ask our parent for this list. Top-level parents must override this with the proper child list for their trees.

Returns:

configure components allowed for children of this class

getAllowableConfigureComponents

public Class<?>[] getAllowableConfigureComponents()

The allowable Configurable components of a Widget determined by its parent's Child-Allowable method.

Specified by:

getAllowableConfigureComponents in interface Configurable

Returns:

a list of valid sub-component Classes. If a Class appears in this list, then instances of that class may be added to this component from the Editor's ConfigureTree window by right-clicking on the component and selecting the appropriate "Add" option.

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 responsible for adding itself to the parent. That way, Buildable subcomponents can be defined in an extension package without needing to modify the containing class.

Specified by:

addTo in interface Buildable

Parameters:

b - parent Buildable to add this component to as a subcomponent.

removeFrom

public void removeFrom(Buildable b)

Description copied from interface: Configurable

Remove this component from its parent

Specified by:

removeFrom in interface Configurable

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()

Specified by:

getHelpFile in interface Configurable

Returns:

a HelpFile describing how to use and configure * this component