herolab.hasChanged: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| (One intermediate revision by the same user not shown) | |||
| Line 9: | Line 9: | ||
<syntaxhighlight lang="mtmacro" line> | <syntaxhighlight lang="mtmacro" line> | ||
herolab.hasChanged() | herolab.hasChanged() | ||
herolab.hasChanged( | herolab.hasChanged(tokenRef) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
See {{func|herolab.refresh}} to update the token's portfolio information. | See {{func|herolab.refresh}} to update the token's portfolio information. | ||
'''Parameters''' | '''Parameters''' | ||
{{param|id| | {{param|tokenRef|Either the token [[getSelected|{{code|id}}]] or [[getTokenName|Token Name]] of the token. Defaults to the Current Token.}} | ||
{{Note|Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.}} | |||
|example= | |example= | ||
Latest revision as of 23:59, 17 May 2024
herolab.hasChanged() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.5
Returns a boolean value of true if the portfolio file has been modified compared to the current stored data on the token, otherwise returns false.
Usage
herolab.hasChanged()
herolab.hasChanged(tokenRef)See herolab.refresh() to update the token's portfolio information.
Parameters
tokenRef- Either the tokenidor Token Name of the token. Defaults to the Current Token.
Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.
Example
Determine if the associated Hero Lab portfolio has changed.
[r: isDirty = herolab.hasChanged()]Returns:
0 or 1See Also
Version Changes
- 1.5 - Added to main MapTool build.