Functions | |
void | Delete_By_Key (HC_KEY key) |
void Delete_By_Key | ( | HC_KEY | key | ) |
Throws away a segment identified by key rather than by name, or throws away a particular geometry item.
key | - Key returned by a previous call to one of the "K" routines. |
If the given key refers to a geometric primitive, such as a line or a polygon, that single primitive is deleted from the database and (at the next Update) from the screen. For comparison, Flush_Contents() deletes all the primitives from the specified segment. Delete_Segment() deletes the primitives and the segment structure itself.
Finally, if the given key was returned from KInclude_Segment() or KStyle_Segment() , that segment cross-reference is removed from the database---the "include" or "style" is no longer performed. The segments themselves remain unaffected.
NOTE
If the item is currently open ( Open_Segment() or Open_Geometry() ) an error will be reported and the deletion will fail.