File: delete_dxf_attributes.rst

package info (click to toggle)
ezdxf 1.4.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, trixie
  • size: 104,528 kB
  • sloc: python: 182,341; makefile: 116; lisp: 20; ansic: 4
file content (34 lines) | stat: -rw-r--r-- 885 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
.. _delete_dxf_attributes:

Delete DXF Attributes from Entities
===================================

All DXF attributes of an entity are grouped in the namespace attribute :attr:`dxf`. 
You can delete a DXF attribute by the `del` operator:

.. code-block:: Python

    line = msp.add_line((0, 0), (1, 0))
    line.dxf.layer = "MyLayer"
    del line.dxf.layer

    assert line.dxf.layer == "0"  # the default layer for all entities

The `del` operator raises an :class:`DXFAttributeError` if the attribute doesn't exist 
or isn't supported.  The :meth:`discard` method ignores these errors:

.. code-block:: Python

    line.dxf.discard('text')  # doesn't raise an exception

.. seealso::

    **Tasks**

    - :ref:`Common graphical DXF attributes`
    - :ref:`get_dxf_attributes`
    - :ref:`modify_dxf_attributes`

    **Tutorials:**
   
    - :ref:`tut_common_graphical_attributes`