a ]j@s|dZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZmZGd d d e Zd S) zz&Styles.__contains__..)r ui2internalanyr style_lst)rnamerrr __contains__s zStyles.__contains__str)keycCs`|jt|}|dur"t|S|j|}|durPd}t|tddt|Std|dS)zEnables 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)rr"Z style_elmmsgrrr __getitem__s zStyles.__getitem__cCsdd|jjDS)Ncss|]}t|VqdSr )r rrrrr2rz"Styles.__iter__..)rrrrrr__iter__1szStyles.__iter__cCs t|jjSr )lenrrr*rrr__len__4szStyles.__len__FcCs6t|}||vrtd||j|||}t|S)zReturn 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_namerrrr add_style7s   zStyles.add_styler)r/cCs |j|}|durdSt|S)zpReturn the default style for `style_type` or |None| if no default is defined for that type (not common).N)rZ default_forr )rr/rrrrdefaultCs zStyles.defaultz str | None)style_idr/cCs|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)r3 _get_by_id)rr4r/rrrr%Ks zStyles.get_by_idcCs2|dur dSt|tr"|||S|||SdS)arReturn 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/rrr get_style_idUs   zStyles.get_style_idcCst|jS)zA |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.)rrZget_or_add_latentStylesr*rrr latent_stylesdszStyles.latent_stylescCs8|r|j|nd}|dus&|j|kr0||St|S)zReturn 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)rr%typer3r )rr4r/rrrrr5ks zStyles._get_by_id)r1r/returncCs||||S)aReturn 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`. )r7)rr1r/rrrr8vszStyles._get_style_id_from_namer )rr/r<cCs4|j|krtd|j|f|||kr.dS|jS)zId 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)r;r.r3r4)rrr/rrrr7s  zStyles._get_style_id_from_style)F)__name__ __module__ __qualname____doc__rr r)r+r-r2r3r%r9propertyr:r5r8r7 __classcell__rrrrr s     r N)r@ __future__rwarningsrZdocx.enum.stylerZdocx.oxml.stylesrZ docx.sharedrZ docx.stylesrZdocx.styles.latentrZdocx.styles.styler r r rrrrs