HyperWorks Tools

::hwat::utils::CreateTag

::hwat::utils::CreateTag

Previous topic Next topic No expanding text in this topic  

::hwat::utils::CreateTag

Previous topic Next topic JavaScript is required for expanding text JavaScript is required for the print function  

NAME

::hwat::utils::CreateTag - Creates a tag in HM.

 

SYNTAX

::hwat::utils::CreateTag entityType n_entIDorLocationList label body [color]

 

ARGUMENTS

entityType

Type of entity to which the tag is attached. Legal values include “node” or “element”.

n_entIDorLocationList

ID of the entity to which the tag is to be attached.

or

Location at which node should be created and tag attached to newly created node.

label

Content for the tag label.

body

Content for the tag body.

color

The color for the tag. (default = 1).

 

RETURNS

ID of the newly created tag if successful, {} otherwise.

 

EXAMPLE

::hwat::utils::CreateTag node {99} “Node1” “Strike Node”

or

::hwat::utils::CreateTag node {101 203 405} “Node2” “Strike Node”

 

Comments

If n_entIDorLocationList has 3 members AND entityType = “node”, a new node will be created at the given location and the tag will attached to that new node.

For all other cases, the first member of the n_entIDorLocationList will be treated as the entity ID and the tag will be attached accordingly. If no such entity exists, no tag is created and {} is returned to the caller.

 

See also

::hwat::utils::EntityExists

Utils Functions