U cqeU@s|dZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZmZGd d d e Zd S) zsz&Styles.__contains__..)r ui2internalanyr style_lst)rnamerrr __contains__s zStyles.__contains__str)keycCs`|jt|}|dk r"t|S|j|}|dk rPd}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 rrrrr5sz"Styles.__iter__..)rrrrrr__iter__4szStyles.__iter__cCs t|jjSr )lenrrr)rrr__len__7szStyles.__len__FcCs6t|}||krtd||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_style:s   zStyles.add_styler)r.cCs |j|}|dkrdSt|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.rrrrdefaultFs zStyles.defaultz str | None)style_idr.cCs|dkr||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)r2 _get_by_id)rr3r.rrrr$Ns zStyles.get_by_idcCs2|dkr 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_idXs   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_stylesgszStyles.latent_stylescCs8|r|j|nd}|dks&|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$typer2r )rr3r.rrrrr4ns zStyles._get_by_id)r0r.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`. )r6)rr0r.rrrr7ys zStyles._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-r2r3)rrr.rrrr6s  zStyles._get_style_id_from_style)F)__name__ __module__ __qualname____doc__rrr(r*r,r1r2r$r8propertyr9r4r7r6 __classcell__rrrrr s     r N)r? __future__rwarningsrZdocx.enum.stylerZdocx.oxml.stylesrZ docx.sharedrZ docx.stylesrZdocx.styles.latentrZdocx.styles.styler r r rrrrs