Difference between revisions of "Container Target References"

Revision as of 15:48, 5 December 2008

Context: HL Kit … Kit Reference … Target References 

There are a wide assortment of operations that can be performed on containers, some of which modify the container and some that simply retrieve information about the container. The complete list of these operations is presented in the table below.

NOTE! When a container is accessed from within a visual script, all operations are restricted to read-only behavior. Any attempts to modify a container from within a visual script will fail.

live	(Read-Only) Returns non-zero if the container is currently considered "live", else zero if non-live. The live state for a gizmo is dictated by the live state of its parent pick that attaches it, while a hero is always considered live. Example: result = this.live
ishero	(Read-Only) Returns non-zero if the container is a hero, else zero for a gizmo. Example: result = this.ishero
isactive	(Read-Only) Returns non-zero if the container either is or resides within the currently active actor within the HL interface. If the container is or resides within a different actor, zero is returned. Example: result = this.isactive
livename	(Read-Only) Returns a suitable name for the container that is based on dynamic changes made via scripts. If the container is an actor, the name of the actor is returned, else the name of the parent pick of the gizmo is returned. Example: result = this.livename
actorname	(Read-Only) Returns the name of the actor that encompasses the current container context. The name is whatever has been assigned by the user. Example: result = this.actorname
playername	(Read-Only) Returns the name of the player that is associated with the current lead. The name is whatever has been entered by the user. Example: result = this.playername
setactor	(Read-Only) Memorizes the current actor context as the "actor focus", allowing it to be instantly accessed thereafter via the "actor." initial script context. The current container context must be an actor and not a gizmo. Always returns a value of zero. Example: perform this.setactor
assign[tag]	(Read-Only) Assigns the indicated tag to the container. The tag must be specified using the standard "group.id" syntax. The tag is verified to exist during compilation of the script. Always returns a value of zero. Example: perform this.assign[skill.appraise]
delete[tmpl]	(Read-Only) Deletes all tags from the container that match the tag template tmpl. The template must use the standard "group.id" syntax and may contain a wildcard. If the template employs a wildcard, all tags matching the template are deleted. If the template specifies an explicit tag, and the tag has been assigned to the container multiple times, the tag is deleted only once, thereby providing detailed control to authors when needed. Always returns a value of zero. Example: perform this.delete[skill.craft?]
assignstr[str]	(Read-Only) This target reference is identical to "assign", except that the str parameter is a string expression that is evaluated within the script. This allows the tag to be dynamically determined via the script instead of being hard-wired at compilation. Always returns a value of zero. Example: perform this.assignstr[skill.appraise]
deletestr[str]	(Read-Only) This target reference is identical to "delete", except that the str parameter is a string expression that is evaluated within the script. This allows the tag template to be dynamically determined via the script instead of being hard-wired at compilation. Always returns a value of zero. Example: perform this.deletestr["skill.craft?"]
tagis[tmpl]	(Read-Only) Returns non-zero if any tags assigned to the container match the tag template tmpl, else zero if no tags match. The template must use the standard "group.id" syntax and may contain a wildcard. Example: this.tagis[skill.?]
tagcount[tmpl]	(Read-Only) Returns the number of tags assigned to the container that match the tag template tmpl. The template must use the standard "group.id" syntax and may contain a wildcard. Example: result = this.tagcount[skill.?]
tagvalue[tmpl]	(Read-Only) Returns the value of a tag assigned to the container that matches the tag template tmpl. The rules associated with tag values in tag expressions apply. The template must use the standard "group.id" syntax and may contain a wildcard. Example: result = this.tagvalue[spelllevel.wizard?]
tagmin[tmpl]	(Read-Only) Returns the minimum value of all tags assigned to the container that match the tag template tmpl. The rules associated with tag values in tag expressions apply. The template must use the standard "group.id" syntax and may contain a wildcard. Example: result = this.tagmin[spelllevel.wizard?]
tagmax[tmpl]	(Read-Only) Returns the maximum value of all tags assigned to the container that match the tag template tmpl. The rules associated with tag values in tag expressions apply. The template must use the standard "group.id" syntax and may contain a wildcard. Example: result = this.tagmax[spelllevel.wizard?]
tagunique[tmpl]	(Read-Only) Returns the number of unique tags assigned to the container that match the tag template tmpl. If a tag is assigned multiple times, it is only counted once. The template must use the standard "group.id" syntax and may contain a wildcard. Example: result = this.tagunique[skill.?]
tagexpr[expr]	(Read-Only) Returns non-zero if the tags assigned to the container match the tag expression expr, else zero is returned. The expr parameter must be a valid tag expression. Example: result = this.tagexpr[class.wizard & (val:spelllevel.wizard? > 5)]
tagcountstr[str]	(Read-Only) This target reference is identical to "tagcount", except that the str parameter is a string expression that is evaluated within the script. This allows the tag template to be dynamically determined via the script instead of being hard-wired at compilation. Example: result = this.tagcountstr["skill.?"]
tagvaluestr[str]	(Read-Only) This target reference is identical to "tagvalue", except that the str parameter is a string expression that is evaluated within the script. This allows the tag template to be dynamically determined via the script instead of being hard-wired at compilation. Example: result = this.tagvaluestr["spelllevel.wizard?"]
tagminstr[str]	(Read-Only) This target reference is identical to "tagmin", except that the str parameter is a string expression that is evaluated within the script. This allows the tag template to be dynamically determined via the script instead of being hard-wired at compilation. Example: result = this.tagminstr["spelllevel.wizard?"]
tagmaxstr[str]	(Read-Only) This target reference is identical to "tagmax", except that the str parameter is a string expression that is evaluated within the script. This allows the tag template to be dynamically determined via the script instead of being hard-wired at compilation. Example: result = this.tagmaxstr["spelllevel.wizard?"]
taguniquestr[str]	(Read-Only) This target reference is identical to "tagunique", except that the str parameter is a string expression that is evaluated within the script. This allows the tag template to be dynamically determined via the script instead of being hard-wired at compilation. Example: result = this.taguniquestr["skill.?"]
tagexprstr[str]	(Read-Only) This target reference is identical to "tagexpr", except that the str parameter is a string expression that is evaluated within the script. This allows the tag expression to be dynamically determined via the script instead of being hard-wired at compilation. Example: result = this.tagexprstr["class.wizard & (val:spelllevel.wizard? > 5)"]
tagmatch[refgrp,match,ref]
tagsearch[str]
intersect[src,targ]
inherit[id]
tagnames[tmpl,delim]
tagabbrevs[tmpl,delim]
tagids[tmpl,delim]
childexists[id]	(Read-Only) Returns non-zero if any child pick with the given id exists within the container, else zero if no matching pick is found. Example: result = this.childexists[mypick]
childlives[id]	(Read-Only) Returns non-zero if any child pick with the given id exists within the container and is "live". If either no matching pick is found or all matching picks found are "non-live", zero is returned. Example: result = this.childlives[mypick]
childcount[id]	(Read-Only) Returns the number of child picks with the given id that exist within the container. A value of zero indicates that no matching picks were found. Example: result = this.childcount[mypick]
haschild[str]
setidentity[grp]	(Read-Only) Assigns to the container the identity tag from the tag group grp that corresponds to the initial context of the script. The identity source is determined based on the initial context of the script, so a script that starts out in a pick context would treat the initial pick as the identity source. The unique id of the identity source is used as the tag id within the tag group grp. If the identity tag does not exist an error is reported. Example: result = this.setidentity[groupid] NOTE! Since the identity source is based on the initial script context, and only things and picks possess identity tags, this target reference can only be used from within a script whose initial context is either a thing or a pick. Use from any other script will result in a compilation error.
isidentity[grp]
countidentity[grp]
isminion
ismaster
hasminion[id]
miniontext
sourcetree
isdynalink[expr]
istransact
weight	(Read-Only) Returns the total weight of all "gear" picks within the container. Example: result = this.weight
gearlist[delim,expr]
geartree[expr]
panelvalid[id]
errorcount
errorlist
combatant
initchange
ismoveup
ismovedown
combatmove[expr]
combatmovenow
combatact
combatdefer