setOwnedByAll: Difference between revisions
Jump to navigation
Jump to search
(Created page with "{{MacroFunction |name=setOwnedByAll |version=1.4.2.0 |description= Allows you to set or unset the ownedByAll value of the token. |usage= <source lang="mtmacro" line> setOwned...") |
No edit summary |
||
(7 intermediate revisions by 5 users not shown) | |||
Line 3: | Line 3: | ||
|version=1.4.2.0 | |version=1.4.2.0 | ||
|description= | |description= | ||
Allows | Allows changing the '''ownedByAll''' value of a token. | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
setOwnedByAll( | setOwnedByAll(owned) | ||
setOwnedByAll(owned, id) | setOwnedByAll(owned, id) | ||
</ | setOwnedByAll(owned, id, mapname) | ||
</syntaxhighlight> | |||
'''Parameter''' | '''Parameter''' | ||
{{param|owned|The value of the setting to set, {{ | {{param|owned|The value of the setting to set, {{true}} or {{false}}.}} | ||
{{param|id|The token {{code|id}} of the token which has its [[Owned by All]] status set, defaults to the [[Current Token]]. {{TrustedParameter}} }} | {{param|id|The token {{code|id}} of the token which has its [[Introduction_to_Tokens#Ownership|Owned by All]] status set, defaults to the [[Current Token]]. {{TrustedParameter}} }} | ||
{{param|mapname|The name of the map to find the token. Defaults to the current map.}} | |||
|example= | |example= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: setOwnedByAll(1)] | [h: setOwnedByAll(1)] | ||
[h: setOwnedByAll(0, "Dragon")] | [h: setOwnedByAll(0, "Dragon")] | ||
</ | </syntaxhighlight> | ||
|also= | |also= | ||
{{func|getOwners}}, {{func|isOwner}}, {{func|isOwnedByAll}} | |||
|changes= | |changes= | ||
{{change|1. | {{change|1.5.4|Added {{code|mapname}} parameter option.}} | ||
}} | }} | ||
[[Category:Token Function]] | [[Category:Token Function]] |
Latest revision as of 20:47, 14 March 2023
setOwnedByAll() Function
• Introduced in version 1.4.2.0
Allows changing the ownedByAll value of a token.
Usage
setOwnedByAll(owned)
setOwnedByAll(owned, id)
setOwnedByAll(owned, id, mapname)
Parameter
owned
- The value of the setting to set,true
(1
) orfalse
(0
).id
- The tokenid
of the token which has its Owned by All status set, defaults to the Current Token.Note: This parameter can only be used in a Trusted Macro.
mapname
- The name of the map to find the token. Defaults to the current map.
Example
[h: setOwnedByAll(1)]
[h: setOwnedByAll(0, "Dragon")]
See Also
Version Changes
- 1.5.4 - Added
mapname
parameter option.