Package VASSAL.counters

Class GlobalCommand

java.lang.Object

VASSAL.counters.GlobalCommand

All Implemented Interfaces:

Auditable

Direct Known Subclasses:

DeckGlobalKeyCommand.DeckGlobalCommand

public class GlobalCommand
extends Object
implements Auditable

The heart of all the different forms of Global Key Command, GlobalCommand handles sending a key command to multiple pieces, potentially on multiple maps, as long as they match its filtering condition. The various forms of Global Key Command that use GlobalCommand are: GlobalKeyCommand - Global Key Commands from a Module window StartupGlobalKeyCommand - Startup Global Key Commands from a Module MassKeyCommand - Global Key Commands from a specific Map window DeckGlobalKeyCommand - Global Key Commands from a Deck CounterGlobalKeyCommand - Global Key Command from a Game Piece Other important classes: GlobalCommandTarget - "Fast Match" parameters GlobalCommandTargetConfigurer - configurer for "Fast Match" parameters

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	GlobalCommand.Visitor

Field Summary

Fields

Modifier and Type	Field	Description
protected KeyStroke	keyStroke
protected RecursionLimiter.Loopable	owner
protected FormattedString	reportFormat
protected boolean	reportSingle
protected int	selectFromDeck
protected String	selectFromDeckExpression
protected PropertySource	source
protected GlobalCommandTarget	target

Constructor Summary

Constructors

Constructor	Description
GlobalCommand(RecursionLimiter.Loopable l)
GlobalCommand(RecursionLimiter.Loopable l, PropertySource p)

Method Summary

Modifier and Type	Method	Description
Command	apply(Map[] maps, PieceFilter filter)	(Legacy - applies GKC without Fast Match)
Command	apply(Map[] maps, PieceFilter filter, GlobalCommandTarget fastMatch)	Apply the key command to all pieces that pass the given filter invalid input: '&' our Fast Match GlobalCommandTarget parameters on all the given maps
Command	apply(Map[] maps, PieceFilter filter, GlobalCommandTarget fastMatch, AuditTrail audit)	Apply the key command to all pieces that pass the given filter invalid input: '&' our Fast Match GlobalCommandTarget parameters on all the given maps
Command	apply(Map map, PieceFilter filter)	(Legacy - applies GKC without Fast Match)
Command	apply(Map map, PieceFilter filter, GlobalCommandTarget fastMatch)	Apply the key command on ONE SPECIFIC MAP to all pieces that pass the given filter and our Fast Match parameters.
Command	apply(Map map, PieceFilter filter, GlobalCommandTarget fastMatch, AuditTrail audit)
boolean	equals(Object obj)
String	getComponentName()	Return the name of the trait or Component an Auditable is
String	getComponentTypeName()	Return a description of the Type of trait or Component an Auditable is
KeyStroke	getKeyStroke()
String	getReportFormat()
int	getSelectFromDeck()
String	getSelectFromDeckExpression()
GlobalCommandTarget	getTarget()
int	hashCode()
boolean	isReportSingle()
void	setKeyStroke(KeyStroke keyStroke)
void	setKeyStroke(NamedKeyStroke keyStroke)
void	setPropertySource(PropertySource ps)
void	setReportFormat(String format)
void	setReportSingle(boolean reportSingle)
void	setSelectFromDeck(int selectFromDeck)	Set the number of pieces to select from a deck that the command will apply to.
void	setSelectFromDeckExpression(String selectFromDeck)	Set the number of pieces to select from a deck that the command will apply to.
void	setTarget(GlobalCommandTarget target)

Methods inherited from class java.lang.Object

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

Field Details

keyStroke

protected KeyStroke keyStroke

reportSingle

protected boolean reportSingle

selectFromDeck

protected int selectFromDeck

selectFromDeckExpression

protected String selectFromDeckExpression

reportFormat

protected FormattedString reportFormat

owner

protected RecursionLimiter.Loopable owner

source

protected PropertySource source

target

protected GlobalCommandTarget target

Constructor Details

GlobalCommand

public GlobalCommand(RecursionLimiter.Loopable l)

GlobalCommand

public GlobalCommand(RecursionLimiter.Loopable l,
 PropertySource p)

Method Details

getComponentTypeName

public String getComponentTypeName()

Description copied from interface: Auditable

Return a description of the Type of trait or Component an Auditable is

Specified by:

getComponentTypeName in interface Auditable

Returns:

Component Type

getComponentName

public String getComponentName()

Description copied from interface: Auditable

Return the name of the trait or Component an Auditable is

Specified by:

getComponentName in interface Auditable

Returns:

Component name

setPropertySource

public void setPropertySource(PropertySource ps)

setKeyStroke

public void setKeyStroke(KeyStroke keyStroke)

setKeyStroke

public void setKeyStroke(NamedKeyStroke keyStroke)

setReportFormat

public void setReportFormat(String format)

getKeyStroke

public KeyStroke getKeyStroke()

getReportFormat

public String getReportFormat()

isReportSingle

public boolean isReportSingle()

setReportSingle

public void setReportSingle(boolean reportSingle)

setTarget

public void setTarget(GlobalCommandTarget target)

getTarget

public GlobalCommandTarget getTarget()

apply

public Command apply(Map[] maps,
 PieceFilter filter,
 GlobalCommandTarget fastMatch)

Apply the key command to all pieces that pass the given filter invalid input: '&' our Fast Match GlobalCommandTarget parameters on all the given maps

Parameters:

maps - Array of Maps

filter - Filter to apply (created e.g. with PropertyExpression.getFilter(VASSAL.build.module.properties.PropertySource, VASSAL.script.expression.Auditable, java.lang.String)

fastMatch - Fast matching parameters, or null. GlobalCommandTarget and GlobalCommandTargetConfigurer

Returns:

the corresponding Command that would reproduce all the things this GKC just did, on another client.

apply

public Command apply(Map[] maps,
 PieceFilter filter,
 GlobalCommandTarget fastMatch,
 AuditTrail audit)

Apply the key command to all pieces that pass the given filter invalid input: '&' our Fast Match GlobalCommandTarget parameters on all the given maps

Parameters:

maps - Array of Maps

filter - Filter to apply (created e.g. with PropertyExpression.getFilter(VASSAL.build.module.properties.PropertySource, VASSAL.script.expression.Auditable, java.lang.String)

fastMatch - Fast matching parameters, or null. GlobalCommandTarget and GlobalCommandTargetConfigurer

audit - Audit trail of evaluation of the filter so far

Returns:

the corresponding Command that would reproduce all the things this GKC just did, on another client.

apply

public Command apply(Map map,
 PieceFilter filter)

(Legacy - applies GKC without Fast Match)

Parameters:

map - a single map

filter - filter

Returns:

command

apply

public Command apply(Map[] maps,
 PieceFilter filter)

(Legacy - applies GKC without Fast Match)

Parameters:

maps - list of maps

filter - filter

Returns:

command

apply

public Command apply(Map map,
 PieceFilter filter,
 GlobalCommandTarget fastMatch)

Apply the key command on ONE SPECIFIC MAP to all pieces that pass the given filter and our Fast Match parameters.

Parameters:

map - a single map

filter - Filter to apply (created e.g. with PropertyExpression.getFilter(VASSAL.build.module.properties.PropertySource, VASSAL.script.expression.Auditable, java.lang.String)

fastMatch - Fast matching parameters, or null. GlobalCommandTarget and GlobalCommandTargetConfigurer

Returns:

the corresponding Command that would reproduce all the things this GKC just did, on another client.

apply

public Command apply(Map map,
 PieceFilter filter,
 GlobalCommandTarget fastMatch,
 AuditTrail audit)

getSelectFromDeck

public int getSelectFromDeck()

getSelectFromDeckExpression

public String getSelectFromDeckExpression()

setSelectFromDeckExpression

public void setSelectFromDeckExpression(String selectFromDeck)

Set the number of pieces to select from a deck that the command will apply to. A value invalid input: '<'0 means to apply to all pieces in the deck

Parameters:

selectFromDeck - Number of pieces to select

setSelectFromDeck

public void setSelectFromDeck(int selectFromDeck)

Set the number of pieces to select from a deck that the command will apply to. A value invalid input: '<'0 means to apply to all pieces in the deck

Parameters:

selectFromDeck - Number of pieces to select

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object