net.sf.magicproject.action.listener
Interface WaitingAbility

All Superinterfaces:

Waiting

All Known Implementing Classes:

PayMana, WaitActivatedChoice, WaitChoosenActionChoice

public interface WaitingAbility
extends Waiting

Since:

0.86

Author:

Fabrice Daugan

Method Summary

java.util.List<Ability>	abilitiesOf(MCard card) Return activated abilities of the specified card.
java.util.List<Ability>	advancedAbilitiesOf(MCard card) Return activated advanced abilities of the specified card.
boolean	clickOn(Ability ability) Called to specify the triggered card chosen for the current action by the handed player
void	finished() Called when this action is finished (aborted or completed).
boolean	manualSkip() Called by the handed player when he/she wants to skip/abort this action.
boolean	succeedClickOn(Ability ability) This function should be called by the 'clickOn' caller in case of the specified ability has been handled during the checking validity of this click in the clickOn(Ability) function.

Method Detail

clickOn

boolean clickOn(Ability ability)

Called to specify the triggered card chosen for the current action by the handed player

Parameters:

ability - the clicked card by the handed player for the current action

Returns:

true if this click has been managed. Return false if this click has been ignored

abilitiesOf

java.util.List<Ability> abilitiesOf(MCard card)

Return activated abilities of the specified card.

Parameters:

card - the requesting card the abilities will be listed from.

Returns:

activated abilities of the specified card.

advancedAbilitiesOf

java.util.List<Ability> advancedAbilitiesOf(MCard card)

Return activated advanced abilities of the specified card.

Parameters:

card - the requesting card the abilities will be listed from.

Returns:

activated advanced abilities of the specified card.

succeedClickOn

boolean succeedClickOn(Ability ability)

This function should be called by the 'clickOn' caller in case of the specified ability has been handled during the checking validity of this click in the clickOn(Ability) function.

The calls chain is :
• actionListener call clickOn(Ability)
• if returned value is false we give hand to the player and exit, else we continue
• actionListener call succeedClickOn(Ability)

Parameters:

ability - the ability that was clicked and successfuly handled by the clickOn(Ability) function.

Returns:

true if this action is completed

See Also:

clickOn(Ability)

finished

void finished()

Description copied from interface: Waiting

Called when this action is finished (aborted or completed). No stack operation should be done here.

Specified by:

finished in interface Waiting

manualSkip

boolean manualSkip()

Description copied from interface: Waiting

Called by the handed player when he/she wants to skip/abort this action. No stack operation should be done here.

Specified by:

manualSkip in interface Waiting

Returns:

true if this action allow the skip/cancel.