HC_Move_By_Key

void HC_Move_By_Key(Key key, char const *newowner)
void HC_Move_By_Key(Key key, char const newowner)

Moves a single geometric primitive or segment from one segment to another.

Oftentimes it’s handy to be able to change the appearance of a single item on the screen, for example, to highlight the item after the user has selected it.

The usual way to do this is to put each item into a segment of its own, and then to change the attributes on the segment. If your “items” consist of single geometric primitive, an alternative is to use Move_By_Key() to pull the primitive out of a big group of them all in the same segment, and put it in a segment of its own, which presumably will have a different color attribute or something.

You can also move one segment from one parent to another using this function; however, include segments cannot be moved.

Move_By_Key() cannot be applied to string cursor keys.

HC_Rename_Segment, HC_Delete_By_Key, HC_Show_Selection_Element.

Parameters

key: Key returned by a previous call to one of the “Insert” or “Open” routines.

newowner: Name of the segment which is to become the new container of the piece of geometry.