*collectormarkmove

Moves and/or sorts the entities on a mark.

Syntax

*collectormarkmove entity_type mark_id move_to_front sort

Type

HyperMesh Tcl Modify Command

Description

This command moves and/or sorts the entities on a mark. This affects their order within the browser and the advanced entity selection menus.

Inputs

entity_type
The type of entity to move. Valid values can be found from the organize panel.
mark_id
The ID of the mark containing the entities to move. Valid values are 1 and 2.
move_to_front
A flag that indicates if the selected entities should be moved to the front of the list. Valid values are:
  • 0 - Move the marked entities to the end of the list.
  • 1 - Move the marked entities to the front of the list.
sort
A flag that indicates how the entities will be sorted. Valid values are:
  • 0 - The marked entities are not to be sorted.
  • 1 - The marked entities are sorted by name.
  • 2 - The marked entities are sorted by ID.

Examples

To move the displayed components to the top of the list with no sorting:
*createmark comps 1 displayed
*collectormarkmove comps 1 1 0

Errors

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