hm_registerentitysubtypefilter

Registers an entity sub-type filter for usage by *createmarkpanel or *createentitypanel.

Syntax

hm_registerentitysubtypefilter entity_type sub_type filter_value

Type

HyperMesh Tcl Query Command

Description

Registers an entity sub-type filter for usage by *createmarkpanel or *createentitypanel. Note that filters persist through an entire HyperMesh session unless they are cleared.

Inputs

entity_type
The type of entity to register the filter for.
sub_type
The sub-type identifier. Valid values are cardimage, config, and idpool.
filter_value
The value of the sub-type filter.
For sub_type cardimage a filter_value of &PRESENT filters solely on the existence of any card image for the entity.

Example

To register a filter for properties with the card image PSHELL, prompt the user to select, and unregister:

hm_registerentitysubtypefilter props cardimage PSHELL
*createmarkpanel props 1 "Select a PSHELL property."
hm_unregisterentitysubtypefilter props

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

13.0