³ò B3IHc@s¦dZddkZdZddd„ƒYZddd„ƒYZdefd „ƒYZd eeifd „ƒYZd efd „ƒYZdeeifd„ƒYZdS(sfrealtime.py | GPL - license | (c)2005 www.stani.be This module provides two classes which enable to update only selectively parts of a wx.TreeCtrl or a wx.ListCtrl. This makes fast/realtime updating possible of only changed items instead of the whole tree or list. These classes are used in SPE's sidebar: - TreeCtrl for Explore - ListCtrl for Todo & IndexiÿÿÿÿNs5Warning: %s: please contact spe.stani.be at gmail.comtItemcBseZd„Zd„ZRS(cCs1d|_d|_t|_d|_d|_dS(Niÿi(iÿiÿiÿ(iii(tbackgroundColourtNonetdatatFalsetdeletedt textColourtwx(tself((sC:\py\_spe\sm\wxp\realtime.pytinits     cCsg|_g|_dS(N(t_updatet _updateAll(R((sC:\py\_spe\sm\wxp\realtime.pytresets (t__name__t __module__R R (((sC:\py\_spe\sm\wxp\realtime.pyRs tCtrlcBs€eZd Zd„Zgd d„Zed„Zd„Zd„Z d„Z d„Z e d„Z d d„Zd „Zd „ZRS( cCs h|_dS(N(titems(R((sC:\py\_spe\sm\wxp\realtime.pyt__init__sc Cs¾|o4y dt|ƒiddƒ}WqAd}qAXnd}d|iddƒ|fiddƒ}d}g}|D]}||iqz~} x ||| jo|d 7}q–W||S( s#Create unique id with data & index.t|t%s%%ts%s%s|%%dtasciitreplaceii(treprRtencodetid( RtbasetothersRtdataIdRtnrt_[1]tothertothersId((sC:\py\_spe\sm\wxp\realtime.pyt_createUniqueId"s ($cCs{|idjo+|i o |i||iƒd|_n|o5|iƒ|ii|iƒo|i|i=qwndS(s,Delete safely (not wx) item from self._itemsN(RRRt _wxDeleteItemt_deleteRthas_keyR(Rtitemt fromItems((sC:\py\_spe\sm\wxp\realtime.pyt _deleteItem2s  cCs#|i|dtƒ|i|_dS(sfDeleteWx component and refresh update. This is used for an item which previously came earlier.R&N(R'RR R (RR%((sC:\py\_spe\sm\wxp\realtime.pyt _renewItem<scCsdS(s5Indepedent delete wx item method (to be overwritten).N((RR%((sC:\py\_spe\sm\wxp\realtime.pyt _DeleteItemBscCsdS(sUInserts an item after a given one, used by self._update() (to be overwritten)N((Rtparenttchildrentindexttext((sC:\py\_spe\sm\wxp\realtime.pyt _insertItemEscCsdS(sUInserts an item as the first one, used by self._update(). (to be overwritten)N((RR*R-((sC:\py\_spe\sm\wxp\realtime.pyt _prependItemIsc CsŸ|i}|i}xUt|ƒD]F\}}||joq|i|ƒ}|| }|iƒx9|D]1} | |jo|i| ƒqc|i| ƒqcW||d}n’|oC|d|jo2|d} |i|| ƒ}||<|d}nH|djo"|i||||i ƒ|_ n|i ||i ƒ|_ |i ||ƒ|o|i |tƒq q W|iƒx|D]} |i| ƒq{W||_dS(sAUpdate (recursively) all children (Item) of parent(Item or List).iiN(R+tpreviousChildrent enumerateR,treverseR(R)t _copyItemToR.R-RR/t _updateItemR tTrue( RR*t recursivelyR+R0R,tchildt prevIndext abandonedst abandonedt empty_slot((sC:\py\_spe\sm\wxp\realtime.pyR Ms:         " cCsFx?|iD]4}||ig}|i|dƒ|d|Œq WdS(s*Execute pending update actions of TreeItemiiN(R Rtextend(RR%R,tactiont arguments((sC:\py\_spe\sm\wxp\realtime.pyR4ts  cCsY|i|jo)||_|ii|ii|fƒn|ii|ii|fƒdS(s"Sets the text colour of a TreeItemN(RR tappendt_basetSetItemTextColourR (RR%tcolor((sC:\py\_spe\sm\wxp\realtime.pyRA{s  cCsY|i|jo)||_|ii|ii|fƒn|ii|ii|fƒdS(s(Sets the background colour of a TreeItemN(RR R?R@tSetItemBackgroundColourR (RR%RB((sC:\py\_spe\sm\wxp\realtime.pyRC‚s  N(R RRR@RR!R5R'R(R)R.R/RR R4RARC(((sC:\py\_spe\sm\wxp\realtime.pyRs      '  tTreeItemcBs2eZdZd„Zd„Zd„Zd„ZRS(s1All the wx actions are handled by the Tree class.cCs<||_||_g|_h|_|iƒ|iƒdS(s!self.wx holds the wx.TreeItemDataN(RR-R0timageR R (RR-R((sC:\py\_spe\sm\wxp\realtime.pyRŒs      cCsBx2|iD]'}|io|iƒnt|_q Wt|_dS(sBWhen an item is removed its children are also removed recursively.N(R+R#R5R(RR7((sC:\py\_spe\sm\wxp\realtime.pyR#–s    cCsti|ƒt|_dS(N(RR Rtbold(R((sC:\py\_spe\sm\wxp\realtime.pyR žs cCsti|ƒg|_dS(N(RR R+(R((sC:\py\_spe\sm\wxp\realtime.pyR ¢s (R Rt__doc__RR#R R (((sC:\py\_spe\sm\wxp\realtime.pyRD‰s   tTreeCtrlcBs¤eZeiZd„Zd„Zd„Zd„Zd„Z dd„Z d„Z d„Z d„Zd „Zd „Zed „Zeid „Zd „Zd„ZRS(cOsbti|ƒtii|||Ž|i|_tii|_|d|_|iti@|_ dS(Ntstyle( RRRRHtDeleteR)R"t_stylet TR_HIDE_ROOTt _hideRoot(Rtargstkwargs((sC:\py\_spe\sm\wxp\realtime.pyRªs    cCsÆ|i|_|i|ijo#|iitii|ifƒn|iitii|ifƒ|i|_|i|ijo#|iitii |ifƒn|iitii |ifƒ|S(sTCopy/steal wx control from an abandoned TreeItem to avoid creating a new wx control.( RRR R?RHt SetPyDataR R0R-t SetItemText(Rtfrmtto((sC:\py\_spe\sm\wxp\realtime.pyR3²s # #cCs'tii||i||di|ƒS(s"Inserts an item after a given one.i(RRHt InsertItem(RR*R+R,R-((sC:\py\_spe\sm\wxp\realtime.pyR.¾scCstii||i|ƒS(s!Inserts an item as the first one.(RRHt PrependItem(RR*R-((sC:\py\_spe\sm\wxp\realtime.pyR/ÂscCsttd|d|ƒ|_|i|i|Add data immediately, if the label is not unique. Be aware that that is a devation from wx.ListCtrl, if data is not wxTreeItemData. There are two possibilities that an item is appended to its parent - if already present, pick it up and update the text - if not, create one itemtGetDataRs%s|%sRRR-RN( thasattrRYR+R!RRR$R RDR?RRP(RR*R-Rt pChildrenRR%((sC:\py\_spe\sm\wxp\realtime.pyt AppendItemÎs       cCs|i|ƒdS(s/Delete item and all its children from the tree.N(R'(RR%((sC:\py\_spe\sm\wxp\realtime.pyRJèscCs*|i|idtƒ|i|iƒdS(s›Update only differences between current and previous state. This method MUST be called in the end otherwise there will be no visual change.R6N(R RVR5R4(R((sC:\py\_spe\sm\wxp\realtime.pytUpdateìscCs7tii||iƒotii||iƒndS(sCollapse a TreeItem.N(RRHt IsExpandedtCollapse(RR%((sC:\py\_spe\sm\wxp\realtime.pyR_óscCs g|_dS(s9Remove children of a TreeItem, mostly used for self.root.N(R+(RR%((sC:\py\_spe\sm\wxp\realtime.pytCollapseAndResetøscCsQ|io||ijptii||iƒptii||iƒndS(sExpands a TreeItem.N(RMRVRRHR^RX(RR%((sC:\py\_spe\sm\wxp\realtime.pyRXüs3cCsY|i|jo)||_|iitii|fƒn|iitii|fƒdS(s(Sets the background colour of a TreeItemN(RFR R?RRHt SetItemBoldR (RR%RF((sC:\py\_spe\sm\wxp\realtime.pyRas  cCs{|ii|ƒ p|i||jo0||i|<|iitii||fƒn|iitii||fƒdS(s8Sets the image for a certain state (which) of a TreeItemN(RER$R R?RRHt SetItemImageR (RR%REtwhich((sC:\py\_spe\sm\wxp\realtime.pyRbs( #cCsY|i|jo)||_|iitii|fƒn|iitii|fƒdS(sSets the text of a TreeItemN(R-R R?RRHRQR (RR%R-((sC:\py\_spe\sm\wxp\realtime.pyRQs  cCsY|i|jo)||_|iitii|fƒn|iitii|fƒdS(sSets the py data of a TreeItem.N(RR R?RRHRPR (RR%R((sC:\py\_spe\sm\wxp\realtime.pyRPs  N(R RRRHR@RR3R.R/RWRR\RJR]R_R`RXR5RatTreeItemIcon_NormalRbRQRP(((sC:\py\_spe\sm\wxp\realtime.pyRH§s              tListItemcBs#eZd„Zd„Zd„ZRS(cCs<||_||_||_d|_|iƒ|iƒdS(N(R,R-RRRER R (RR,R-R((sC:\py\_spe\sm\wxp\realtime.pyRs      cCsti|ƒd|_dS(Ni(RR R(R((sC:\py\_spe\sm\wxp\realtime.pyR 's cCs t|_dS(sFlag as deleted.N(R5R(R((sC:\py\_spe\sm\wxp\realtime.pyR#+s(R RRR R#(((sC:\py\_spe\sm\wxp\realtime.pyRes tListCtrlcBs’eZeiZd„Zd„Zd„Zd„Zd„Z d„Z d„Z dd„Z d„Zd „Zd „Zd „Zd „Zd „ZRS(cOsTti|ƒtii|||Ž|i|_tii|_g|_g|_dS(N( RRRRft DeleteItemR)R"R+R0(RRNtkwds((sC:\py\_spe\sm\wxp\realtime.pyR3s    cCsñ|i|_|i|ijo#|iitii|ifƒn|iitii|ifƒ|i}x€|iiƒD]o\}}|i |ƒo4|||jo#|iitii ||fƒn|iitii ||fƒqzW|S(sTCopy/steal wx control from an abandoned TreeItem to avoid creating a new wx control.( RRR R?Rft SetItemDataR R-RR$t SetStringItem(RRRRSttoTexttcolumntlabel((sC:\py\_spe\sm\wxp\realtime.pyR3;s #  !##cCstii|||dƒS(s"Inserts an item after a given one.i(RRftInsertStringItem(RR*R+R,R-((sC:\py\_spe\sm\wxp\realtime.pyR.HscCstii|d|dƒS(s!Inserts an item as the first one.i(RRfRn(RR*R-((sC:\py\_spe\sm\wxp\realtime.pyR/LscCs ||_ti|||ƒdS(s$Same as Ctrl, but update also index.N(RRR4(RR%R,((sC:\py\_spe\sm\wxp\realtime.pyR4Ps cCs g|_dS(N(R+(R((sC:\py\_spe\sm\wxp\realtime.pytDeleteAllItemsUscCs5||ijo|ii|ƒn|i|ƒdS(sDelete item safely.N(R+tremoveR'(RR%((sC:\py\_spe\sm\wxp\realtime.pyRgXscCs³|id|d|id|ƒ}|ii|ƒo|i|}|iƒn0td|dh|d s  lv