a
    §ˆc
  ã                   @   s0   d Z ddlmZ ddlmZ G dd„ deƒZdS )zq Defines the Include class, which is used to represent a substitutable
    element within a user interface View.
é    )ÚStré   )ÚViewSubElementc                       s.   e Zd ZdZeƒ Z‡ fdd„Zdd„ Z‡  ZS )ÚIncludea}  A substitutable user interface element, i.e., a placeholder in a view
    definition.

    When a view object constructs an attribute-editing window, any Include
    objects within the view definition are replaced with a group or item
    defined elsewhere in the object's inheritance tree, based on matching of the
    name of the element. If no matching element is found, the Include object
    is ignored.

    An Include object can reference a group or item attribute on a parent class
    or on a subclass. For example, the following class contains a view
    definition that provides for the possibility that a subclass might add
    "extra" attributes in the middle of the view::

        class Person(HasTraits):
            name = Str()
            age = Int()
            person_view = View('name', Include('extra'), 'age', kind='modal')

    If you directly create an instance of Person, and edit its attributes,
    the Include object is ignored.

    The following class extends Person, and defines a group of "extra"
    attributes to add to the view defined on Person::

        class LocatedPerson(Person):
            street = Str()
            city = Str()
            state = Str()
            zip = Int()
            extra = Group('street', 'city', 'state', 'zip')

    The attribute-editing window for an instance of LocatedPerson displays
    editors for these extra attributes.
    c                    s   t ƒ jf i |¤Ž || _dS )zInitializes the Include object.N)ÚsuperÚ__init__Úid)Úselfr   Ztraits©Ú	__class__© úS/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/traitsui/include.pyr   A   s    zInclude.__init__c                 C   s
   d| j  S )z7Returns a "pretty print" version of the Include object.z<%s>)r   )r	   r   r   r   Ú__repr__F   s    zInclude.__repr__)	Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r   r   Ú__classcell__r   r   r
   r   r      s   )r   N)r   Z
traits.apir   Zview_elementr   r   r   r   r   r   Ú<module>   s   