Functions | |
void | Flush_By_Key (HC_KEY key) |
void Flush_By_Key | ( | HC_KEY | key | ) |
Throws away the contents of a geometric primitive or a segment but leaves the structure intact.
key | - Key returned by a previous call to one of the "K" routines. |
If key refers to text, all the characters are removed. New characters can be added with Edit_Text() or via user input with Enable_String_Events() .
Flush_By_Key() is a quick method of making sure all the contents of a piece of geometry are gone. The "Edit" routines take more work and only remove some of the contents.
Lastly, if key refers to a segment, this call becomes a call to Flush_Geometry() on the segment. If the key refers to a Style or an Include, nothing happens.