MKI_HatchFastInsert (Entity Creation) Changed in Version 2022.2

C++ Syntax

MKI_ENTITY_HATCH_PTR

MKI_HatchFastInsert(

 MKI_CONST_ENTITY_PTR f_pRefEntity );

This procedure terminates a currently opened provisional dynamic hatching (see MKI_HatchOpen) and inserts it to a provisional clipping surface, extended object, group, block, or to the current drawing (in that order).

Parameters

RefEntity New in Version 2022.2

[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 new dynamic hatching if it was successfully inserted. Returns nullptr if the insertion was not successful, normally due to insufficient memory.

Regardless of the result, the provisional dynamic hatching is closed afterwards (either because it was not open to start with, or because it was just closed before trying to insert it).

Comment

This procedure is a kind of macro that executes steps similar to the following code segment:

MKI_HatchAddEnd();

MKI_ENTITY_HATCH_PTR pNewHatch = MKI_HatchInsert( f_pRefEntity );

MKI_HatchClose();

return( pNewHatch );

This causes the provisional dynamic hatching to be terminated, initialized and then inserted to the current drawing. Afterwards, it is closed. For a detailed description, see the referenced procedures' descriptions.

If possible, you should use this command instead of calling the separate procedures to increase speed and to reduce code size.