o `TT@sdZddlmZmZmZGdddeZGdddeZGdddeZGd d d eZ Gd d d eZ Gd ddeZ GdddeZ Gddde ZddZddZGdddeZGdddeZdS)z! Objects shared by docx modules. )absolute_importprint_functionunicode_literalsc@steZdZdZdZdZdZdZdZddZ e d d Z e d d Z e d dZ e ddZe ddZe ddZdS)Lengtha Base class for length constructor classes Inches, Cm, Mm, Px, and Emu. Behaves as an int count of English Metric Units, 914,400 to the inch, 36,000 to the mm. Provides convenience unit conversion methods in the form of read-only properties. Immutable. i i@~ii1i{cCs t||SN)int__new__clsemur ;D:\Projects\ConvertPro\env\Lib\site-packages\docx\shared.pyrs zLength.__new__cC|t|jS)zI The equivalent length expressed in centimeters (float). )float _EMUS_PER_CMselfr r r cmz Length.cmcCs|S)zP The equivalent length expressed in English Metric Units (int). r rr r r r !sz Length.emucCr)zD The equivalent length expressed in inches (float). )r_EMUS_PER_INCHrr r r inches(rz Length.inchescCr)zI The equivalent length expressed in millimeters (float). )r _EMUS_PER_MMrr r r mm/rz Length.mmcCr)z1 Floating point length in points )r _EMUS_PER_PTrr r r pt6rz Length.ptcCstt|t|jS)zA The equivalent length expressed in twips (int). )rroundr_EMUS_PER_TWIPrr r r twips=sz Length.twipsN)__name__ __module__ __qualname____doc__rrrrrrpropertyrr rrrrr r r r r s(     rc@eZdZdZddZdS)IncheszY Convenience constructor for length in inches, e.g. ``width = Inches(0.5)``. cCt|tj}t||Sr)rrrr)r rr r r r rJ zInches.__new__Nrrr r!rr r r r r$E r$c@r#)CmzZ Convenience constructor for length in centimeters, e.g. ``height = Cm(12)``. cCr%r)rrrr)r rr r r r rTr&z Cm.__new__Nr'r r r r r)Or(r)c@r#)Emuzg Convenience constructor for length in English Metric Units, e.g. ``width = Emu(457200)``. cCst|t|Sr)rrrr r r r r^sz Emu.__new__Nr'r r r r r*Yr(r*c@r#)Mmz\ Convenience constructor for length in millimeters, e.g. ``width = Mm(240.5)``. cCr%r)rrrr)r rr r r r rgr&z Mm.__new__Nr'r r r r r+br(r+c@r#)PtzC Convenience value class for specifying a length in points cCr%r)rrrr)r Zpointsr r r r rpr&z Pt.__new__Nr'r r r r r,ls r,c@r#)Twipsz Convenience constructor for length in twips, e.g. ``width = Twips(42)``. A twip is a twentieth of a point, 635 EMU. cCr%r)rrrr)r rr r r r rzr&z Twips.__new__Nr'r r r r r-ur(r-cs<eZdZdZfddZddZddZedd ZZ S) RGBColorzA Immutable value object defining a particular RGB color. csNd}|||fD]}t|tr|dks|dkrt|qtt|||||fS)Nz+RGBColor() takes three integer values 0-255r) isinstancer ValueErrorsuperr.r)r rgbmsgval __class__r r rs zRGBColor.__new__cCd|S)Nz RGBColor(0x%02x, 0x%02x, 0x%02x)r rr r r __repr__szRGBColor.__repr__cCr:)z> Return a hex string rgb value, like '3C2F80' z %02X%02X%02Xr rr r r __str__szRGBColor.__str__cCsBt|ddd}t|ddd}t|ddd}||||S)zW Return a new instance from an RGB color hex string like ``'3C2F80'``. N)r)r Z rgb_hex_strr3r4r5r r r from_strings zRGBColor.from_string) rrr r!rr;r< classmethodr@ __classcell__r r r8r r.s r.cs*djj}fdd}t||dS)z @lazyprop decorator. Decorated method will be called only on first access to calculate a cached property value. After that, the cached value is returned. z_%scs8zt|WSty|}t|||YSwr)getattrAttributeErrorsetattr)objvalueZcache_attr_namefr r get_prop_values   z$lazyproperty..get_prop_value)doc)rr!r")rI docstringrJr rHr lazypropertys  rMcCs|j}t||dS)z @write_only_property decorator. Creates a property (descriptor attribute) that accepts assignment, but not getattr (use in an expression). )fsetrK)r!r")rIrLr r r write_only_propertys rOc@sFeZdZdZdZdddZddZdd Zed d Z ed d Z dS) ElementProxya0 Base class for lxml element proxy classes. An element proxy class is one whose primary responsibilities are fulfilled by manipulating the attributes and child elements of an XML element. They are the most common type of class in python-docx other than custom element (oxml) classes. _element_parentNcCs||_||_dSrrQ)relementparentr r r __init__s zElementProxy.__init__cCst|tsdS|j|juS)a\ Return |True| if this proxy object refers to the same oxml element as does *other*. ElementProxy objects are value objects and should maintain no mutable local state. Equality for proxy objects is defined as referring to the same XML element, whether or not they are the same proxy object instance. Fr0rPrRrotherr r r __eq__s  zElementProxy.__eq__cCst|tsdS|j|juS)NTrWrXr r r __ne__s  zElementProxy.__ne__cCs|jS)z: The lxml element proxied by this object. )rRrr r r rTszElementProxy.elementcC|jjSz9 The package part containing this object rSpartrr r r r_zElementProxy.partr) rrr r! __slots__rVrZr[r"rTr_r r r r rPs   rPcs,eZdZdZfddZeddZZS)Parentedz Provides common services for document elements that occur below a part but may occasionally require an ancestor object to provide a service, such as add or drop a relationship. Provides ``self._parent`` attribute to subclasses. cstt|||_dSr)r2rbrVrS)rrUr8r r rVs zParented.__init__cCr\r]r^rr r r r_r`z Parented.part)rrr r!rVr"r_rBr r r8r rbs  rbN)r!Z __future__rrrrrr$r)r*r+r,r-tupler.rMrOobjectrPrbr r r r s;       .