C++ Syntax

MKI_HatchInsert(

Inserts the provisional dynamic hatching (see MKI_HatchOpen) to a memory list. If no provisional clipping surface, extended object, group, or block is currently open, the dynamic hatching is inserted to the main memory list of the drawing behind the object pointed to by RefEntity. If RefEntity is nullptr, the dynamic hatching is appended at the end.

If a provisional clipping surface, extended object, group, or block is currently open (in that order), the dynamic hatching is appended to that entity. RefEntity is ignored in this case.

In most cases, you can use MKI_HatchFastInsert instead of this procedure to speed up execution and to reduce code size. See the description of that procedure for details.

Parameters

RefEntity

[MKI_CONST_ENTITY_PTR] Address of a reference entity behind which the dynamic hatching shall be inserted. If RefEntity is nullptr, the dynamic hatching is appended at the end.

Return Value

Returns the address of the inserted dynamic hatching. Returns nullptr if the insertion was not successful, normally due to insufficient memory.

The returned dynamic hatching address is valid (and therefore can be used for subsequent modifications) even after the provisional dynamic hatching has been closed using MKI_HatchClose. The dynamic hatching pointer remains valid until the plug-in returns control to the serving application or the plug-in modifies the dynamic hatching by itself, e.g. deleting it.