XRecord

Important class for storing application defined data in DXF files.

The XRECORD entities are used to store and manage arbitrary data. They are composed of DXF group codes ranging from 1 through 369. This object is similar in concept to XDATA but is not limited by size or order.

To reference a XRECORD by an DXF entity, store the handle of the XRECORD in the XDATA section, application defined data or the ExtensionDict of the DXF entity.

See also

• Extended Data (XDATA)

• Extension Dictionary

• Storing Custom Data in DXF Files

Subclass of	ezdxf.entities.DXFObject
DXF type	'XRECORD'
Factory function	ezdxf.sections.objects.ObjectsSection.add_xrecord()

Warning

Do not instantiate object classes by yourself - always use the provided factory functions!

class ezdxf.entities.XRecord

dxf.cloning

Duplicate record cloning flag (determines how to merge duplicate entries, ignored by ezdxf):

0	not applicable
1	keep existing
2	use clone
3	<xref>$0$<name>
4	$0$<name>
5	Unmangle name

tags

Raw DXF tag container Tags. Be careful ezdxf does not validate the content of XRECORDS.

clear() → None

Remove all DXF tags.

reset(tags: Iterable[tuple[int, Any] | DXFTag]) → None

Reset DXF tags.

extend(tags: Iterable[tuple[int, Any] | DXFTag]) → None

Extend DXF tags.