hm_highlightlist

Control the highlighting of a list of entities.

Syntax

hm_highlightlist entity_type list_id highlight ?panel_sensitive?

Type

HyperMesh Tcl GUI Command

Description

Control the highlighting of a list of entities.

Inputs

entity_type
The type of entity to control the highlighting for.
list_id
The ID of the entity list. Valid values are 1 and 2.
highlight
The state of the highlighting. Valid values are:
  • l, low or lowlight - set to low (gray) highlighting
  • n, norm or normal - set to normal (no) highlighting
  • h, high or highlight - set to high (white) highlighting
panel_sensitive
Can be used when multiple panel levels have been pushed, either using the shortcut function keys, or the hm_pushpanel command. This option determines whether to use the current panel or the previous panel for the operation. This option is relevant only when the list has been created from a panel entity selector under the above conditions. Valid options are:
  • 0 - Use the previous panel (default).
  • 1 - Use the current panel.

Example

To display a list of elements in a low state:

*createlistpanel elems 1 "Select the element list"
hm_highlightlist elems 1 "low"

Errors

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