o 4\@spdZddlmZmZmZmZddlmZddlm Z ddl m Z ddl m Z ddlmZmZGdd d e Zd S) z;Styles object, container for all objects in the styles part)absolute_importdivisionprint_functionunicode_literals)warn) ElementProxy) BabelFish) LatentStyles) BaseStyle StyleFactoryc@szeZdZdZdZddZddZddZd d Zdd d Z ddZ ddZ ddZ e ddZddZddZddZdS)StyleszProvides access to the styles defined in a document. Accessed using the :attr:`.Document.styles` property. Supports ``len()``, iteration, and dictionary-style access by style name. cCs,t|}|jjD] }|j|krdSq dS)z6 Enables `in` operator on style name. TF)r ui2internal_element style_lstZname_val)selfnameZ internal_namestyler r BD:\Projects\ConvertPro\env\Lib\site-packages\docx\styles\styles.py __contains__s   zStyles.__contains__cCs\|jt|}|durt|S|j|}|dur(d}t|tddt|Std|)z Enables dictionary-style access by UI name. Lookup by style id is deprecated, triggers a warning, and will be removed in a near-future release. NzFstyle lookup by style_id is deprecated. Use style name as key instead.) stacklevelzno style with name '%s') rZ get_by_namerrr get_by_idr UserWarningKeyError)rkeyZ style_elmmsgr r r __getitem__"s  zStyles.__getitem__cCsdd|jjDS)Ncss|]}t|VqdSN)r ).0rr r r 8sz"Styles.__iter__..)rrrr r r__iter__7szStyles.__iter__cCs t|jjSr)lenrrr!r r r__len__:s zStyles.__len__FcCs6t|}||vrtd||j|||}t|S)z Return a newly added style object of *style_type* and identified by *name*. A builtin style can be defined by passing True for the optional *builtin* argument. z$document already contains style '%s')rr ValueErrorrZadd_style_of_typer )rr style_typebuiltin style_namerr r r add_style=s  zStyles.add_stylecCs |j|}|dur dSt|S)z Return the default style for *style_type* or |None| if no default is defined for that type (not common). N)rZ default_forr )rr&rr r rdefaultKs zStyles.defaultcCs|dur ||S|||S)zReturn the style of *style_type* matching *style_id*. Returns the default for *style_type* if *style_id* is not found or is |None|, or if the style having *style_id* is not of *style_type*. N)r* _get_by_id)rstyle_idr&r r rrUs  zStyles.get_by_idcCs.|durdSt|tr|||S|||S)a Return the id of the style corresponding to *style_or_name*, or |None| if *style_or_name* is |None|. If *style_or_name* is not a style object, the style is looked up using *style_or_name* as a style name, raising |ValueError| if no style with that name is defined. Raises |ValueError| if the target style is not of *style_type*. N) isinstancer _get_style_id_from_style_get_style_id_from_name)rZ style_or_namer&r r r get_style_id_s     zStyles.get_style_idcCst|jS)z A |LatentStyles| object providing access to the default behaviors for latent styles and the collection of |_LatentStyle| objects that define overrides of those defaults for a particular named latent style. )r rZget_or_add_latentStylesr!r r r latent_stylesoszStyles.latent_stylescCs0|j|}|dus|j|kr||St|S)z Return the style of *style_type* matching *style_id*. Returns the default for *style_type* if *style_id* is not found or if the style having *style_id* is not of *style_type*. N)rrtyper*r )rr,r&rr r rr+ys  zStyles._get_by_idcCs||||S)a Return the id of the style of *style_type* corresponding to *style_name*. Returns |None| if that style is the default style for *style_type*. Raises |ValueError| if the named style is not found in the document or does not match *style_type*. )r.)rr(r&r r rr/szStyles._get_style_id_from_namecCs4|j|krtd|j|f|||krdS|jS)z Return the id of *style*, or |None| if it is the default style of *style_type*. Raises |ValueError| if style is not of *style_type*. z'assigned style is type %s, need type %sN)r2r%r*r,)rrr&r r rr.s zStyles._get_style_id_from_styleN)F)__name__ __module__ __qualname____doc__ __slots__rrr"r$r)r*rr0propertyr1r+r/r.r r r rr s        r N)r6Z __future__rrrrwarningsrZ docx.sharedrZ docx.stylesrZdocx.styles.latentr Zdocx.styles.styler r r r r r rs