CadSetPlineMark

Vecad CadSetPlineMark — a temporary GIS highlight drawn ALONG hEnt's contour from `Start` for `Len` drawing units (Len==0 => a point marker).

Parameters

hDwg (YuHandle)

Handle to the drawing, as returned by CadCreate.

Id (std::int32_t)

Mark identifier. Re-using an Id overwrites that mark; 0 deletes ALL marks.

hEnt (YuHandle)

Entity whose contour carries the mark; 0 deletes the mark with this Id.

Start (double)

Start distance along the contour, in drawing units.

Len (double)

Mark length in drawing units; 0 draws the mark as a point.

Color (std::uint32_t)

Mark colour as a Win32 COLORREF (0x00BBGGRR).

Width (std::int32_t)

Mark width in pixels.

bBlink (std::int32_t)

Reserved (Vecad: "not used in current version").

Return Value

Nonzero (TRUE) on success, 0 (FALSE) on failure.

Remarks

The mark is transient overlay chrome, not an entity, and is not saved to file. Id keys the mark: Id==0 clears ALL marks; hEnt==0 deletes the mark with this Id; otherwise the mark is set/overwritten. bBlink is reserved in Vecad ("not used in current version") and ignored here.

See Also