< Dice
Revision as of 20:35, 12 April 2017 by Skizzerz (talk | contribs)

MacroCallback Delegate

From DiceRoller Documentation

Encapsulates a method which executes macro logic.

  • Namespace: Dice
  • Assembly: DiceRoller (in DiceRoller.dll)

Syntax

public delegate void MacroCallback(
    MacroContext context
)

Parameters

context
Type: Dice.MacroContext
Macro context, to be filled in by the delegate.

Remarks

The MacroCallback delegate is used alongside RollerConfig.ExecuteMacro. The delegate can gain insight into the context of the macro call by examining the passed-in context object, and it must also modify the context object's Value. If no delegate in the chain modifies the context's Value or Values, a DiceException is thrown with DiceErrorCode.InvalidMacro.

If the macro does not roll dice, its Value should be added to the Values list as a Literal die type.