Difference between revisions of "Dice/RollerConfig/ExecuteMacro"

From DiceRoller Documentation
(Created page with "{{APIdoc|RollerConfig.ExecuteMacro Property}} Gets or sets the function used to execute macros. {{ns}} == Syntax == <syntaxhighlight lang="C#"> public MacroCallback ExecuteM...")
 
Line 22: Line 22:
 
The following example registers two callbacks to handle macro executions.
 
The following example registers two callbacks to handle macro executions.
 
<syntaxhighlight lang="C#">
 
<syntaxhighlight lang="C#">
 +
using Dice;
 +
 
class Sample
 
class Sample
 
{
 
{

Revision as of 05:20, 9 April 2017

Gets or sets the function used to execute macros.

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

Syntax

public MacroCallback ExecuteMacro { get; set; }

Property Value

Type: Dice.MacroCallback

The callback delegate which is executed whenever a macro is encountered in the dice expression.

Remarks

If ExecuteMacro is null, a DiceException will be thrown with the ErrorCode DiceErrorCode.InvalidMacro. As the MacroCallback type is a delegate, multiple callback functions can be registered, and all of them will be invoked in sequence when a macro is encountered.

The callback should modify the Value of the passed-in MacroContext to indicate that the macro was run successfully. If the Value field is not modified by any callback, a DiceException will be thrown with ErrorCode DiceErrorCode.InvalidMacro.

Examples

The following example registers two callbacks to handle macro executions.

using Dice;

class Sample
{
    public static void Main()
    {
        Roller.DefaultConfig.ExecuteMacro += MacroCallback1;
        Roller.DefaultConfig.ExecuteMacro += MacroCallback2;
        var result1 = Roller.Roll("1d20+[WIS-mod]"); // rolls 1d20+2
        var result2 = Roller.Roll("1d20+[proficiency]"); // throws DiceException with DiceErrorCode.InvalidMacro
    }

    public static void MacroCallback1(MacroContext context)
    {
        switch (context.Param)
        {
            case "STR-mod":
                context.Value = 0;
                break;
            case "DEX-mod":
                context.Value = 3;
                break;
            case "CON-mod":
                context.Value = -1;
                break;
        }
    }

    public static void MacroCallback2(MacroContext context)
    {
        switch (context.Param)
        {
            case "INT-mod":
                context.Value = -1;
                break;
            case "WIS-mod":
                context.Value = 2;
                break;
            case "CHA-mod":
                context.Value = 0;
                break;
        }
    }
}