Package VASSAL.build.module
Class DiceButton
java.lang.Object
VASSAL.search.AbstractImageFinder
VASSAL.build.AbstractBuildable
VASSAL.build.AbstractConfigurable
VASSAL.build.AbstractToolbarItem
VASSAL.build.module.DiceButton
- All Implemented Interfaces:
AutoConfigurable
,Buildable
,Configurable
,PropertyNameSource
,ValidityChecker
,Translatable
,ImageSearchTarget
,SearchTarget
- Direct Known Subclasses:
InternetDiceButton
,RandomTextButton
This component places a button into the controls window toolbar.
Pressing the button generates random numbers and displays the
result in the Chatter
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
Deprecated, for removal: This API element is subject to removal in a future version.static class
Nested classes/interfaces inherited from interface VASSAL.build.AutoConfigurable
AutoConfigurable.Util
-
Field Summary
Modifier and TypeFieldDescriptionstatic String
protected int
static String
Deprecated, for removal: This API element is subject to removal in a future version.static String
static String
Deprecated, for removal: This API element is subject to removal in a future version.static String
Deprecated, for removal: This API element is subject to removal in a future version.protected LaunchButton
Deprecated, for removal: This API element is subject to removal in a future version.use launch from the superclassstatic String
static String
static String
Deprecated, for removal: This API element is subject to removal in a future version.protected int
protected int
protected int
static String
static String
protected boolean
protected MutableProperty.Impl
protected Random
static String
static String
static String
protected FormattedString
protected boolean
static String
Variable name for reporting formatstatic String
protected boolean
protected String
static String
Deprecated, for removal: This API element is subject to removal in a future version.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
-
Method Summary
Modifier and TypeMethodDescriptionvoid
In case reports use HTML and refer to any image filesvoid
Expects to be added to a GameModule.protected void
DR()
Forwards the result of the roll to theChatter.send(java.lang.String)
method of theChatter
of theGameModule
.protected String
formatResult(String result)
Use the configured FormattedString to format the result of a rollClass<?>[]
String[]
This getAttributeDescriptions() will return the items specific to the Toolbar Button - classes extending this should add their own items as well.String[]
This getAttributeNames() will return the items specific to the Toolbar Button - classes extending this should add their own items as well.Class<?>[]
This getAttributeTypes() will return the items specific to the Toolbar Button - classes extending this should add their own items as well.Classes extending AbstractToolbarItem can call this as a super() method after checking for their own keys, to avoid needing to deal with the nitty gritty of the toolbar button.getAttributeVisibility(String name)
By default, all attributes are visiblestatic String
Implement PropertyNameSource - Expose roll result propertyprotected String
Deprecated, for removal: This API element is subject to removal in a future version.No Replacementprotected String
Deprecated, for removal: This API element is subject to removal in a future version.No Replacementprotected void
void
setAttribute(String key, Object o)
Classes extending AbstractToolbarItem can call this as a super() method after checking for their own keys, to avoid needing to deal with the nitty gritty of the toolbar button.Methods inherited from class VASSAL.build.AbstractToolbarItem
getComponent, getLaunchButton, getMenuTextList, getNamedKeyStrokeList, makeLaunchButton, removeFrom, setButtonTextKey, setHotKeyKey, setIconKey, setLaunchButton, setNameKey, setTooltipKey
Methods inherited from class VASSAL.build.AbstractConfigurable
add, addPropertyChangeListener, getConfigureComponents, getConfigureName, getConfigurer, getExpressionList, getFormattedStringList, getI18nData, getI18nPrefix, getLocalizedConfigureName, getPropertyList, remove, removePropertyChangeListener, setAllAttributesUntranslatable, setAttributeTranslatable, setConfigureName
Methods inherited from class VASSAL.build.AbstractBuildable
addImageNamesRecursively, build, getAllDescendantComponents, getAllDescendantComponentsOf, getBuildables, getBuildComponents, getBuildElement, getComponents, getComponentsOf, validate
Methods inherited from class VASSAL.search.AbstractImageFinder
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.build.Buildable
build, getBuildElement
-
Field Details
-
ran
-
nSides
protected int nSides -
nDice
protected int nDice -
plus
protected int plus -
addToTotal
protected int addToTotal -
reportTotal
protected boolean reportTotal -
promptAlways
protected boolean promptAlways -
sortDice
protected boolean sortDice -
reportFormat
-
launch
Deprecated, for removal: This API element is subject to removal in a future version.use launch from the superclass -
tooltip
-
property
-
BUTTON_TEXT
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
- Constant Field Values
-
TOOLTIP
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
- Constant Field Values
-
NAME
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
- Constant Field Values
-
ICON
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
- Constant Field Values
-
HOTKEY
Deprecated, for removal: This API element is subject to removal in a future version.- See Also:
- Constant Field Values
-
DEPRECATED_NAME
- See Also:
- Constant Field Values
-
N_DICE
- See Also:
- Constant Field Values
-
N_SIDES
- See Also:
- Constant Field Values
-
PLUS
- See Also:
- Constant Field Values
-
ADD_TO_TOTAL
- See Also:
- Constant Field Values
-
REPORT_TOTAL
- See Also:
- Constant Field Values
-
PROMPT_ALWAYS
- See Also:
- Constant Field Values
-
REPORT_FORMAT
- See Also:
- Constant Field Values
-
SORT_DICE_RESULTS
- See Also:
- Constant Field Values
-
RESULT
Variable name for reporting format- See Also:
- Constant Field Values
-
REPORT_NAME
- See Also:
- Constant Field Values
-
-
Constructor Details
-
DiceButton
public DiceButton()
-
-
Method Details
-
initLaunchButton
protected void initLaunchButton() -
getConfigureTypeName
-
getReportPrefix
Deprecated, for removal: This API element is subject to removal in a future version.No ReplacementThe text reported before the results of the roll -
getReportSuffix
Deprecated, for removal: This API element is subject to removal in a future version.No ReplacementThe text reported after the results of the roll; -
DR
protected void DR()Forwards the result of the roll to theChatter.send(java.lang.String)
method of theChatter
of theGameModule
. Format is prefix+[comma-separated roll list]+suffix -
formatResult
Use the configured FormattedString to format the result of a roll- Parameters:
result
- Result format- Returns:
- Formatted result
-
getAttributeNames
Description copied from class:AbstractToolbarItem
This getAttributeNames() will return the items specific to the Toolbar Button - classes extending this should add their own items as well. If the "nameKey" is blank, then no "name" configure entry will be generated. Extending classes can use ArrayUtils.addAll(super.getAttributeNames(), key1, ..., keyN), or supply their own order from scratch.Lists all the buildFile (XML) attribute names for this component. If this component is ALSO an
AbstractConfigurable
, then this list of attributes determines the appropriate attribute order forAbstractConfigurable.getAttributeDescriptions()
andAbstractConfigurable.getAttributeTypes()
.- Specified by:
getAttributeNames
in interfaceAutoConfigurable
- Overrides:
getAttributeNames
in classAbstractToolbarItem
- Returns:
- a list of all buildFile (XML) attribute names for this component
-
getAttributeDescriptions
Description copied from class:AbstractToolbarItem
This getAttributeDescriptions() will return the items specific to the Toolbar Button - classes extending this should add their own items as well. If the "nameKey" is blank, then no "name" configure entry will be generated. Extending classes can use ArrayUtils.addAll(super.getAttributeDescriptions(), key1, ..., keyN), or supply their own order from scratch.- Specified by:
getAttributeDescriptions
in interfaceAutoConfigurable
- Overrides:
getAttributeDescriptions
in classAbstractToolbarItem
- Returns:
- an array of Strings describing the buildFile (XML) attributes of this component. These strings are used as prompts in the
Properties window for this object, when the component is configured in the Editor. The order of descriptions should
be the same as the order of names in
AbstractBuildable.getAttributeNames()
-
getAttributeTypes
Description copied from class:AbstractToolbarItem
This getAttributeTypes() will return the items specific to the Toolbar Button - classes extending this should add their own items as well. If the "nameKey" is blank, then no "name" configure entry will be generated. Extending classes can use ArrayUtils.addAll(super.getAttributeTypes(), key1, ..., keyN), or supply their own order from scratch.- Specified by:
getAttributeTypes
in interfaceAutoConfigurable
- Overrides:
getAttributeTypes
in classAbstractToolbarItem
- Returns:
- the Class for the buildFile (XML) attributes of this component. Valid classes include: String, Integer, Double, Boolean, Image,
Color, and KeyStroke, along with any class for which a Configurer exists in VASSAL.configure. The class determines, among other things,
which type of
AutoConfigurer
will be used to configure the attribute when the object is configured in the Editor.The order of classes should be the same as the order of names in
AbstractBuildable.getAttributeNames()
-
getAttributeVisibility
Description copied from class:AbstractConfigurable
By default, all attributes are visible- Specified by:
getAttributeVisibility
in interfaceAutoConfigurable
- Overrides:
getAttributeVisibility
in classAbstractConfigurable
- Parameters:
name
- Name (key) of one of this component's attributes- Returns:
- a
VisibilityCondition
for this attribute, or null if attribute should always be visible.
-
addTo
Expects to be added to a GameModule. Adds the button to the control window's toolbar and registers itself as a @link KeyStrokeListener- Specified by:
addTo
in interfaceBuildable
- Overrides:
addTo
in classAbstractToolbarItem
- Parameters:
parent
- parent Buildable to add this component to as a subcomponent.
-
setAttribute
Description copied from class:AbstractToolbarItem
Classes extending AbstractToolbarItem can call this as a super() method after checking for their own keys, to avoid needing to deal with the nitty gritty of the toolbar button. Sets a buildFile (XML) attribute value for this component. Thekey
parameter will be one of those listed inAbstractToolbarItem.getAttributeNames()
. If thevalue
parameter is a String, it will be the value returned byAbstractToolbarItem.getAttributeValueString(java.lang.String)
for the samekey
. If the implementing class extendsAbstractConfigurable
, thenvalue
will be an instance of the corresponding Class listed inAbstractConfigurable.getAttributeTypes()
- Specified by:
setAttribute
in interfaceAutoConfigurable
- Specified by:
setAttribute
in interfaceTranslatable
- Overrides:
setAttribute
in classAbstractToolbarItem
- Parameters:
key
- the name of the attribute. Will be one of those listed inAbstractToolbarItem.getAttributeNames()
o
- If thevalue
parameter is a String, it will be the value returned byAbstractToolbarItem.getAttributeValueString(java.lang.String)
for the samekey
. If the implementing class extendsAbstractConfigurable
, thenvalue
can also be an instance of the corresponding Class listed inAbstractConfigurable.getAttributeTypes()
-
getAttributeValueString
Description copied from class:AbstractToolbarItem
Classes extending AbstractToolbarItem can call this as a super() method after checking for their own keys, to avoid needing to deal with the nitty gritty of the toolbar button.- Specified by:
getAttributeValueString
in interfaceAutoConfigurable
- Specified by:
getAttributeValueString
in interfaceTranslatable
- Overrides:
getAttributeValueString
in classAbstractToolbarItem
- Parameters:
key
- the name of the attribute. Will be one of those listed inAbstractToolbarItem.getAttributeNames()
- Returns:
- a String representation of the XML buildFile attribute with the given name. When initializing a module,
this String value will loaded from the XML and passed to
AbstractToolbarItem.setAttribute(java.lang.String, java.lang.Object)
. It is also frequently used for checking the current value of an attribute.
-
getAllowableConfigureComponents
- 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.
-
getHelpFile
- Returns:
- a HelpFile describing how to use and configure * this component
-
getPropertyNames
Implement PropertyNameSource - Expose roll result property- Specified by:
getPropertyNames
in interfacePropertyNameSource
- Overrides:
getPropertyNames
in classAbstractBuildable
- Returns:
- Default implementation of PropertyNameSource - No properties exposed
-
addLocalImageNames
In case reports use HTML and refer to any image files- Specified by:
addLocalImageNames
in interfaceImageSearchTarget
- Overrides:
addLocalImageNames
in classAbstractToolbarItem
- Parameters:
s
- Collection to add image names to
-