onChangeToken

From RPTools Wiki
Jump to navigation Jump to search

This event is triggered whenever a token is changed.

As a frame-based event, a frame containing the event code has to be opened.

This event can be tricky. It can be fired many times, and can result in loops if the event handler goes on to itself modify tokens.

Set up

Create a frame that has this special html tag in it:

<link rel='onChangeToken' type='macro' href='macroLink'>

Replace macroLink by an actual macroLinkText-call to a macro of your choice (the returned value of macroLinkText()).

The changed token's ID is passed to the macro as the value of macro.args.

See Also

Forms tutorial#Events