BPc]zdZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z dd lmZGd d eZd S) z^ When elements are selected, these structures provide an advanced API. .. versionadded:: 1.1 ) OrderedDict)AnyoverloadUnionOptional) IBaseElementnatural_sort_key) inkex_gettext)AbortExtensionceZdZdZdfd ZdZfdZfdZfdZe ddd e d e fd Z e de e eefd e d efd Z dd efd Z fdZdZdfd ZdZdZdZdddeefdZdZdZdZdZxZS) ElementListaf A list of elements, selected by id, iterator or xpath This may look like a dictionary, but it is really a list of elements. The default iterator is the element objects themselves (not keys) and it is possible to key elements by their numerical index. It is also possible to look up items by their id and the element object itself. Nc||_t|_t||jt |dSdSN)svgridssuper__init__setlist)selfr_iter __class__s :/usr/share/inkscape/extensions/inkex/elements/_selected.pyrzElementList.__init__-sT==    DHd5kk " " " "  cN|Sr)values__iter__rs rr zElementList.__iter__4s{{}}%%'''rclt||Sr)r __getitem___to_keyrkeyrs rr#zElementList.__getitem__7s'ww""4<<#4#4555rclt||Sr)r __contains__r$r%s rr(zElementList.__contains__:s'ww##DLL$5$5666rc||kr+||dkrtd|t|tr"|}|j|d}|dSt|t rL|j}|d}| ||j|<t ||dSt|j }td|)Nidz'Refusing to set bad key in ElementList T)literalzUnknown element type: ) get ValueError isinstancestrrgetElementByIdr xml_pathrr __setitem__type__name__)rorig_keyelemr& element_idkindrs rr2zElementList.__setitem__=s t  DHHTNN : :QxQQRR R dC  C8**4*>>D| dL ) ) >-C$J%'*$ GG  T * * * * *::&Drc:|r||}t|tr't||St|tr|jSt|t r'|ddkr|j||S|S)z:Takes a key (id, element, etc) and returns an xml_path keyNr/) r.intrkeysr r1r/rr,r=s rr$zElementList._to_keyYs  CKC c3   * $$S) ) c< ( ( <  c3   *CFcMM8<<S)) ) rcz|jtdS)zAlso clear idsN)rclearr)rrs rrEzElementList.clearfs*   rcB||j|dS)a Sets the currently selected elements to these ids, any existing selection is cleared. Arguments a list of element ids, element objects or a single xpath expression starting with ``//``. All element objects must have an id to be correctly set. >>> selection.set("rect123", "path456", "text789") >>> selection.set(elem1, elem2, elem3) >>> selection.set("//rect") N)rEadd)rrs rrzElementList.setks" #rct||d}|j|d|S)z4Remove the key item or remove the last item selected)r9r*)rpopr$rr,)rr&itemrs rrJzElementList.pop|sKww{{4<<R<8899  TXXd^^$$$ rct|dkrVt|dtr;|ddr |j|d}|D]}|||<dS)z#Like set() but does not clear firstr rz//N)lenr.r/ startswithrxpath)rrr6s rrGzElementList.addsv s88q==ZA44=Q9J9J49P9P=(..Q((C  DDJJ  rct|j}|jdt|dD|S)zGet the selected elements by z-order (stacking order), ordered from bottom to top .. versionadded:: 1.2 :func:`paint_order` has been renamed to :func:`rendering_order`cg|]\}}|Sr<r<).0_r6s r z/ElementList.rendering_order..s,Atrc,t|dS)Nrr )xs rz-ElementList.rendering_order..s0@10F0Fr)r&)rrrsorteditems)rnew_lists rrendering_orderzElementList.rendering_ordersi tx((  %JJLL&F&F     rcFt|jfd|DS)zYFilter selected elements of the given type, returns a new SelectedElements objectc8g|]}rt||Sr<r.)rRetypess rrTz&ElementList.filter..s-LLLQeLz!U7K7KLqLLLrrr)rr`s `rfilterzElementList.filters3 HLLLL$LLL   r) error_msgrcc|j|}|sP|?tddd|D}t ||S)aFilter selected elements of the given type, returns a new SelectedElements object. If the selection is empty, abort the extension. .. versionadded:: 1.2 :param error_msg: e :type error_msg: str, optional Args: *types (Type) : type(s) to filter the selection by error_msg (str, optional): error message that is displayed if the selection is empty, defaults to ``_("Please select at least one element of type(s) {}")``. Defaults to None. Raises: AbortExtension: if the selection is empty Returns: ElementList: filtered selection Nz?Please select at least one element of the following type(s): {}z, cg|] }|j Sr<)r4)rRr3s rrTz.ElementList.filter_nonzero..s#D#D#DdDM#D#D#Dr)rbr formatjoinr)rrcr`filtereds rfilter_nonzerozElementList.filter_nonzerosr,4;& , )U&#D#De#D#D#DEEFF!++ +rcTfdt|jfd|DS)z[Like filter, but will enter each element searching for any child of the given typesc3dKrt|r|V|D]}|Ed{VdSrr^)r6child_recurser`s rrmz!ElementList.get.._recursese JtU33   + +#8E??******** + +rchg|].}|D] }t|ttf|!/Sr<)r.r r/)rRr_rrms rrTz#ElementList.get..s]   !!  a,!455      rra)rr`rms `@rr,zElementList.getsa + + + + + +  H          rcNfdjDS)zCFor compatibility, return regular dictionary of id -> element pairsc(i|]\}}||Sr<r<)rReidxidrs r z'ElementList.id_dict..s#@@@83T#Y@@@r)rrYr!s`rid_dictzElementList.id_dicts)@@@@tx~~/?/?@@@@rc6td|DdS)a Gets a :class:`inkex.transforms.BoundingBox` object for the selected items. Text objects have a bounding box without width or height that only reflects the coordinate of their anchor. If a text object is a part of the selection's boundary, the bounding box may be inaccurate. When no object is selected or when the object's location cannot be determined (e.g. empty group or layer), all coordinates will be None. c6g|]}|Sr<) bounding_box)rRr6s rrTz,ElementList.bounding_box..s$999DD%%''999rN)sumr!s rrxzElementList.bounding_boxs#99D9994@@@rc|D]}|cSdS)z+Returns the first item in the selected listNr<)rr6s rfirstzElementList.firsts  DKKKtrr)r4 __module__ __qualname____doc__rr r#r(r2rrr$rrBr r/rErrJrGr[rbrrir,rurxr{ __classcell__)rs@rrr"s######(((6666677777>>>>>( 4 # #   X  5lC!78 3 3   X   C     " &   AE >   (AAA A A ArrN)r~ collectionsrtypingrrrrinterfaces.IElementr _utilsr localizationr utilsrrr<rrrs& $#####111111111111......$$$$$$((((((""""""KKKKK+KKKKKr