VASSAL.build.module.documentation
Class HelpFile

java.lang.Object
  |
  +--VASSAL.build.AbstractBuildable
        |
        +--VASSAL.build.AbstractConfigurable
              |
              +--VASSAL.build.module.documentation.HelpFile

All Implemented Interfaces:

AutoConfigurable, Buildable, Configurable

public class HelpFile

extends AbstractConfigurable

Places an entry in the Help menu. Selecting the entry displays a window with stored text on it.

Nested Class Summary

Nested classes inherited from class VASSAL.build.AutoConfigurable

AutoConfigurable.Util

Field Summary

static java.lang.String	ARCHIVE_ENTRY
static java.lang.String	FILE
static java.lang.String	LOCAL_FILE
static java.lang.String	RESOURCE
static java.lang.String	TITLE
static java.lang.String	TYPE

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

HelpFile()

HelpFile(java.lang.String title, java.io.File contents)

HelpFile(java.lang.String title, java.io.File contents, java.lang.String ref)

HelpFile(java.lang.String title, java.net.URL contents)

Method Summary

void	addTo(Buildable b) Adds this component to its parent.
java.lang.Class[]	getAllowableConfigureComponents() Return a list of valid sub-component Classes.
java.lang.String[]	getAttributeDescriptions() Return an array of Strings describing the attributes of this object.
java.lang.String[]	getAttributeNames() The attributes of a HelpFile are: TITLE the text of the menu entry in the Help menu FILE the name of an text file in the DataArchive.
java.lang.Class[]	getAttributeTypes() Return the Class for the attributes of this object.
java.lang.String	getAttributeValueString(java.lang.String key) Called by the AbstractBuildable.getBuildElement(org.w3c.dom.Document) method to write the attributes into an XML element
static java.lang.String	getConfigureTypeName()
java.net.URL	getContents()
HelpFile	getHelpFile()
protected HelpWindow	getHelpWindow()
void	removeFrom(Buildable b) Remove this component from its parent
void	setAttribute(java.lang.String key, java.lang.Object val) Called by the AbstractBuildable.build(org.w3c.dom.Element) method, where value is the String value read by the XML attribute.
void	showWindow() Create and display a new HelpWindow with the contents of this HelpFile
static java.net.URL	toURL(java.io.File f)

Methods inherited from class VASSAL.build.AbstractConfigurable

addPropertyChangeListener, getAttributeVisibility, getConfigureComponents, getConfigureName, getConfigurer, remove, setConfigureName

Methods inherited from class VASSAL.build.AbstractBuildable

add, build, getBuildComponents, getBuildElement, getComponents

Methods inherited from class java.lang.Object

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

Methods inherited from interface VASSAL.build.Buildable

add, build, getBuildElement

Field Detail

TITLE

public static final java.lang.String TITLE

See Also:

Constant Field Values

FILE

public static final java.lang.String FILE

See Also:

Constant Field Values

TYPE

public static final java.lang.String TYPE

See Also:

Constant Field Values

ARCHIVE_ENTRY

public static final java.lang.String ARCHIVE_ENTRY

See Also:

Constant Field Values

RESOURCE

public static final java.lang.String RESOURCE

See Also:

Constant Field Values

LOCAL_FILE

public static final java.lang.String LOCAL_FILE

See Also:

Constant Field Values

Constructor Detail

HelpFile

public HelpFile()

HelpFile

public HelpFile(java.lang.String title,
                java.io.File contents,
                java.lang.String ref)
         throws java.net.MalformedURLException

HelpFile

public HelpFile(java.lang.String title,
                java.io.File contents)
         throws java.net.MalformedURLException

HelpFile

public HelpFile(java.lang.String title,
                java.net.URL contents)

Method Detail

getConfigureTypeName

public static java.lang.String getConfigureTypeName()

showWindow

public void showWindow()

Create and display a new HelpWindow with the contents of this HelpFile

getHelpWindow

protected HelpWindow getHelpWindow()

getContents

public java.net.URL getContents()

toURL

public static java.net.URL toURL(java.io.File f)
                          throws java.net.MalformedURLException

java.net.MalformedURLException

getHelpFile

public HelpFile getHelpFile()

Returns:

a HelpFilte describing how to use and configure this component

getAttributeNames

public java.lang.String[] getAttributeNames()

The attributes of a HelpFile are: TITLE the text of the menu entry in the Help menu FILE the name of an text file in the DataArchive. The text is displayed in a window with the same title

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

getAttributeValueString

public java.lang.String getAttributeValueString(java.lang.String key)

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:

key - the name of the attribute. Will be one of those listed in AbstractBuildable.getAttributeNames()

setAttribute

public void setAttribute(java.lang.String key,
                         java.lang.Object val)

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:

key - the name of the attribute. Will be one of those listed in AbstractBuildable.getAttributeNames()

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

getAllowableConfigureComponents

public java.lang.Class[] getAllowableConfigureComponents()

Description copied from interface: Configurable

Return 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 Configuration Window.

removeFrom

public void removeFrom(Buildable b)

Description copied from interface: Configurable

Remove this component from 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.