o 'fU@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__keystrcCs\|jt|}|durt|S|j|}|dur(d}t|tddt|Std|)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') r get_by_namerrr get_by_idr UserWarningKeyError)rr" 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__7s zStyles.__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 ValueErrorradd_style_of_typer )rr style_typebuiltin style_namerrrr add_style:s  zStyles.add_styler3rcCs |j|}|dur dSt|S)zpReturn the default style for `style_type` or |None| if no default is defined for that type (not common).N)r default_forr )rr3rrrrdefaultFs zStyles.defaultstyle_id str | NonecCs|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)r8 _get_by_id)rr9r3rrrr'Ns  zStyles.get_by_idcCs.|durdSt|tr|||S|||S)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)r style_or_namer3rrr 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.)rrget_or_add_latentStylesr-rrr latent_stylesgszStyles.latent_stylescCs8|r|j|nd}|dus|j|kr||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'typer8r )rr9r3rrrrr;ns zStyles._get_by_idr5returncCs||||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`. )r=)rr5r3rrrr>ys zStyles._get_style_id_from_namerr cCs4|j|krtd|j|f|||krdS|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)rCr1r8r9)rrr3rrrr=s  zStyles._get_style_id_from_style)r r)r"r#)F)r3r)r9r:r3r)r5r#r3rrDr:)rr r3rrDr:)__name__ __module__ __qualname____doc__rr!r,r.r0r6r8r'r@propertyrBr;r>r= __classcell__rrrrr s         r N)rH __future__rwarningsrdocx.enum.stylerdocx.oxml.stylesr docx.sharedr docx.stylesrdocx.styles.latentrdocx.styles.styler r r rrrrs