VASSAL.build.widget
Class PanelWidget

java.lang.Object
  |
  +--VASSAL.build.AbstractBuildable
        |
        +--VASSAL.build.AbstractConfigurable
              |
              +--VASSAL.build.Widget
                    |
                    +--VASSAL.build.widget.PanelWidget
All Implemented Interfaces:
AutoConfigurable, Buildable, Configurable

public class PanelWidget
extends Widget

A Widget that corresponds to a JPanel with a GridLayout or BoxLayout layout. Adding a Widget to a PanelWidget adds the child Widget's component to the JPanel. The attributes of the PanelWidget determine the layout parameters


Nested Class Summary
 
Nested classes inherited from class VASSAL.build.Widget
Widget.MyCellRenderer
 
Nested classes inherited from class VASSAL.build.AutoConfigurable
AutoConfigurable.Util
 
Field Summary
static java.lang.String COLS
           
static java.lang.String FIXED
           
static java.lang.String VERTICAL
           
 
Fields inherited from class VASSAL.build.Widget
buildElement, NAME, parent
 
Fields inherited from class VASSAL.build.AbstractConfigurable
changeSupport, config, name
 
Fields inherited from class VASSAL.build.AbstractBuildable
buildComponents
 
Fields inherited from interface VASSAL.build.Configurable
NAME_PROPERTY
 
Constructor Summary
PanelWidget()
           
 
Method Summary
 void add(Buildable b)
          Adds a child component.
 java.lang.String[] getAttributeDescriptions()
          Return an array of Strings describing the attributes of this object.
 java.lang.String[] getAttributeNames()
          The attributes of a PanelWidget are: NAME for the name of the Widget FIXED uses GridLayout if true.
 java.lang.Class[] getAttributeTypes()
          Return the Class for the attributes of this object.
 java.lang.String getAttributeValueString(java.lang.String name)
          Called by the Widget.getBuildElement(org.w3c.dom.Document) method to write the attributes into an XML element
 VisibilityCondition getAttributeVisibility(java.lang.String name)
          By default, all attributes are visible
 java.awt.Component getComponent()
           
static java.lang.String getConfigureTypeName()
           
 void remove(Buildable b)
          Remove a Buildable object from this object
 void setAttribute(java.lang.String name, java.lang.Object value)
          Called by the Widget.build(org.w3c.dom.Element) method, where value is the String value read by the XML attribute.
 
Methods inherited from class VASSAL.build.Widget
addTo, build, getAllowableConfigureComponents, getBuildElement, getConfigureComponents, getHelpFile, getParent, rebuild, removeFrom
 
Methods inherited from class VASSAL.build.AbstractConfigurable
addPropertyChangeListener, getConfigureName, getConfigurer, setConfigureName
 
Methods inherited from class VASSAL.build.AbstractBuildable
getBuildComponents, getComponents
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

FIXED

public static final java.lang.String FIXED
See Also:
Constant Field Values

COLS

public static final java.lang.String COLS
See Also:
Constant Field Values

VERTICAL

public static final java.lang.String VERTICAL
See Also:
Constant Field Values
Constructor Detail

PanelWidget

public PanelWidget()
Method Detail

getConfigureTypeName

public static java.lang.String getConfigureTypeName()

getComponent

public java.awt.Component getComponent()
Specified by:
getComponent in class Widget
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

add

public void add(Buildable b)
Description copied from interface: Buildable
Adds a child component. Both this method and Buildable.addTo(VASSAL.build.Buildable) are invoked when adding a child to a parent

Specified by:
add in interface Buildable
Overrides:
add in class AbstractBuildable

remove

public void remove(Buildable b)
Description copied from class: AbstractConfigurable
Remove a Buildable object from this object

Specified by:
remove in interface Configurable
Overrides:
remove in class AbstractConfigurable

getAttributeNames

public java.lang.String[] getAttributeNames()
The attributes of a PanelWidget are: NAME for the name of the Widget FIXED uses GridLayout if true. Otherwise uses BoxLayout COLS for the number of columns. Ignored unless FIXED is true VERTICAL Uses a vertical BoxLayout if true. otherwise uses a horizontal layout. Ignored unless FIXED is false

Specified by:
getAttributeNames in interface AutoConfigurable
Specified by:
getAttributeNames in class AbstractBuildable
Returns:
an array of Strings giving all attributes of this Buildable component that will be written to/read from an XML element

getAttributeDescriptions

public java.lang.String[] getAttributeDescriptions()
Description copied from class: AbstractConfigurable
Return an array of Strings describing the attributes of this object. These strings are used as prompts in the Properties window for this object. The order of descriptions should be the same as the order of names in AbstractBuildable.getAttributeNames()

Specified by:
getAttributeDescriptions in interface AutoConfigurable
Specified by:
getAttributeDescriptions in class AbstractConfigurable

getAttributeTypes

public java.lang.Class[] getAttributeTypes()
Description copied from class: AbstractConfigurable
Return the Class for the attributes of this object. Valid classes are: String, Integer, Double, Boolean, Image, Color, and KeyStroke The order of classes should be the same as the order of names in AbstractBuildable.getAttributeNames()

Specified by:
getAttributeTypes in interface AutoConfigurable
Specified by:
getAttributeTypes in class AbstractConfigurable

getAttributeVisibility

public VisibilityCondition getAttributeVisibility(java.lang.String name)
Description copied from class: AbstractConfigurable
By default, all attributes are visible

Specified by:
getAttributeVisibility in interface AutoConfigurable
Overrides:
getAttributeVisibility in class AbstractConfigurable
Parameters:
name -
Returns:

setAttribute

public void setAttribute(java.lang.String name,
                         java.lang.Object value)
Description copied from interface: AutoConfigurable
Called by the Buildable.build(org.w3c.dom.Element) method, where value is the String value read by the XML attribute. Can also be called with Object value to set the attribute.

Specified by:
setAttribute in interface AutoConfigurable
Specified by:
setAttribute in class AbstractBuildable
Parameters:
name - the name of the attribute. Will be one of those listed in AbstractBuildable.getAttributeNames()

getAttributeValueString

public java.lang.String getAttributeValueString(java.lang.String name)
Description copied from interface: AutoConfigurable
Called by the Buildable.getBuildElement(org.w3c.dom.Document) method to write the attributes into an XML element

Specified by:
getAttributeValueString in interface AutoConfigurable
Specified by:
getAttributeValueString in class AbstractBuildable
Parameters:
name - the name of the attribute. Will be one of those listed in AbstractBuildable.getAttributeNames()