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.