onChangeImpersonated

From RPTools Wiki
Revision as of 22:43, 24 November 2022 by Kwvanderlinde (talk | contribs) (Add details for the onChangeImpersonated frame event)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This event is triggered whenever the user changes which token is impersonated.

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

Set up

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

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

Replace macroLink by an actual macroLinkText-call to a macro of your choice (the returned value of macroLinkText()). A common practice is to call the frame opening macro itself to actualize the content.

No arguments are passed to the event, so to find the impersonated token we have to call getImpersonated():

[h: vImpersonated = getImpersonated(1)]

See Also

Forms tutorial#Events