o 7hN@sHdZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZddlmZmZmZmZdd lmZdd lmZmZmZmZmZmZmZmZdd l m!Z!m"Z"erbdd l m#Z#Gd ddeZ$GdddeZ%GdddeZ&GdddeZ'GdddeZ(GdddeZ)GdddeZ*Gddde+Z,dS)z5Custom element classes for table-related XML elements) annotations) TYPE_CHECKINGCallableIteratorcast)MSO_VERTICAL_ANCHOR) parse_xml)CT_GradientFillPropertiesnsdecls) ST_CoordinateST_Coordinate32 XsdBooleanXsdInt) CT_TextBody)BaseOxmlElementChoice OneAndOnlyOneOptionalAttributeRequiredAttribute ZeroOrMore ZeroOrOneZeroOrOneChoice)Emu lazyproperty)Lengthc@steZdZUdZded<ded<ded<dZed ed d d Zd ed<edZ ded<e dedd d Z [dGddZ e dHddZejdIddZe dHdd ZejdId!d Ze dHd"d#ZejdId$d#Ze dHd%d&ZejdId'd&ZdJd)d*Ze dHd+d,ZejdId-d,Ze dHd.d/ZejdId0d/Ze dKdLd7d8ZdMdr@r0r0r1rC<rAcCr5NfirstColr8r:r0r0r1rE@r;zCT_Table.firstColcCr=rDr>r@r0r0r1rEDrAcCr5NfirstRowr8r:r0r0r1rGHr;zCT_Table.firstRowcCr=rFr>r@r0r0r1rGLrAIterator[CT_TableCell]cCsdd|jDS)zwGenerate each `a:tc` element in this tbl. `a:tc` elements are generated left-to-right, top-to-bottom. css |] }|jD]}|VqqdSN)tc_lst.0trtcr0r0r1 Usz$CT_Table.iter_tcs..)rr:r0r0r1iter_tcsPszCT_Table.iter_tcscCr5NlastColr8r:r0r0r1rRWr;zCT_Table.lastColcCr=rQr>r@r0r0r1rR[rAcCr5NlastRowr8r:r0r0r1rT_r;zCT_Table.lastRowcCr=rSr>r@r0r0r1rTcrArowsintcolswidth tableStyleId str | Nonec Cs|durd}||}ttt|}||}||} t|D]} | |dkr/||d| } |jjt| dqt|D]#} | |dkrM||d|}|jt|d} t|D]} | qYq=|S)z"Return a new `p:tbl` element tree.Nz&{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}r#)rX)r*) _tbl_tmplrrrranger( add_gridColrr2add_tc) clsrUrWrXr*rYxmltblZ rowheightcolwidthcolrowrMr0r0r1new_tblgs$       zCT_Table.new_tblrow_idxcol_idx CT_TableCellcCs|j|j|S)z.Return `a:tc` element at `row_idx`, `col_idx`.)rrJ)r/rfrgr0r0r1rNrAz CT_Table.tcpropnamestrcCs,|j}|dur dSt||}dddd|S)zGeneralized getter for the boolean properties on the `a:tblPr` child element. Defaults to False if `propname` attribute is missing or `a:tblPr` element itself is not present. NFT)TFN)r&getattr)r/rir&Zpropvalr0r0r1r9s  zCT_Table._get_boolean_propertyNonecCs,|dvr td||}t|||dS)aGeneralized setter for boolean properties on the `a:tblPr` child element. Sets `propname` attribute appropriately based on `value`. If `value` is True, the attribute is set to "1"; a tblPr child element is added if necessary. If `value` is False, the `propname` attribute is removed if present, allowing its default value of False to be its effective value. )TFz3assigned value must be either True or False, got %sN) ValueErrorrsetattr)r/rir<r&r0r0r1r?s zCT_Table._set_boolean_propertycCsdtddfS)Nz| %s az%sr r_r0r0r1r[s zCT_Table._tbl_tmpl)r*rr+r,r+r4)r<r4)r+rHrI) rUrVrWrVrXrVr*rVrYrZr+r)rfrVrgrVr+rh)rirjr+r4)rirjr<r4r+rl)__name__ __module__ __qualname____doc____annotations___tag_seqrr&rr(rrMr2propertyr7setterrCrErGrPrRrT classmethodrerNr9r?r[r0r0r0r1rs\                    rc@seZdZUdZded<ded<dZededd d Zd ed <ed edd d Zded<[e de ddZ ded<e de ddZ ded<e de ddZded<e de ddZded<edLddZejdMddZdNd d!ZedOd"d#ZedPd$d%ZedPd&d'ZedQd)d*ZejdRd-d*ZedQd.d/ZejdRd0d/ZedQd1d2ZejdRd3d2ZedQd4d5ZejdRd6d5ZedSd7d8ZedOd9d:ZedTd )rrhrr rpr0r0r1new2s zCT_TableCell.newcCstt|jS)z'Offset of this cell's row in its table.)rr,rrfr:r0r0r1rfCrzCT_TableCell.row_idxrcCstt|ddS)z#Table element this cell belongs to.zancestor::a:tblr)rrxpathr:r0r0r1raHszCT_TableCell.tblrjcCs(|j}|dur dSddd|jDS)zstr text contained in cellN cSsg|]}|jqSr0)text)rLrr0r0r1 Tsz%CT_TableCell.text..)rjoinr)r/rr0r0r1rMszCT_TableCell.text attr_namercCs(|jdur t|Stt|j||S)z(Generalized method to get margin values.N)rrrVget)r/rrr0r0r1rVs zCT_TableCell._get_marXrcCtSrI)r new_a_txBodyr:r0r0r1 _new_txBody\zCT_TableCell._new_txBodymarXrlcCs.|dur |jdur dS|}t|||dS)zSet value of marX attribute on `a:tcPr` child element. If `marX` is |None|, the marX attribute is removed. `marX` is a string, one of `('marL', 'marR', 'marT', 'marB')`. N)rr{rn)r/rr<rr0r0r1r_szCT_TableCell._set_marX)r+r)rr)rrhr+rVrq)r+r)r<rr+rh)r+r)r+rj)rrjrrr+r)r+r)rrjr<rr+rl)#rrrsrtrurvrwrrrrrrrrrrrxrryrrgrrrrrrrzrrfrarrrrr0r0r0r1rhs|                       rhc@seZdZUdZeededededededfdd Zed eZ d e d <ed e Z d e d <ede Z d e d<ede Zd e d<ede Zd e d<ddZdS)CT_TableCellPropertiesz`a:tcPr` custom element classza:noFillz a:solidFillz a:gradFillz a:blipFillz a:pattFillz a:grpFill)z a:headersrr$rrrrrrrcCrrI)r new_gradFillr:r0r0r1 _new_gradFillrz$CT_TableCellProperties._new_gradFillN)rrrsrtrurreg_fillPropertiesrrrrvr rrrrrr0r0r0r1rks8       rc@s$eZdZUdZedeZded<dS) CT_TableColz!`a:gridCol` custom element class.wrN)rrrsrtrurr rrvr0r0r0r1rs rc@s4eZdZUdZded<ded<edZdd d Zd S)r'z!`a:tblGrid` custom element class.zlist[CT_TableCol]Z gridCol_lstzCallable[..., CT_TableCol] _add_gridColz a:gridColrXrr+rcCr-)zSA newly appended `a:gridCol` child element having its `w` attribute set to `width`.)r)r)r/rXr0r0r1r]r3zCT_TableGrid.add_gridColN)rXrr+r)rrrsrtrurvrZgridColr]r0r0r0r1r's r'c@sdeZdZdZededdZededdZededdZededdZ ededdZ ed eddZ d S) CT_TablePropertiesz`a:tblPr` custom element class.rCFrr7rGrErTrRN) rrrsrtrurrrCr7rGrErTrRr0r0r0r1rsrc@s`eZdZUdZded<ded<edddZed eZ d ed <dd dZ e dddZ ddZ dS)r,z`a:tr` custom element class.zlist[CT_TableCell]rJzCallable[[], CT_TableCell]_add_tcza:tc)rr$r.rr+rhcCs|S)z1A newly added minimal valid `a:tc` child element.)rr:r0r0r1r^szCT_TableRow.add_tcrVcCstt|j|S)z Offset of this row in its table.)rrrrrr:r0r0r1rfszCT_TableRow.row_idxcCrrI)rhrr:r0r0r1_new_tcrzCT_TableRow._new_tcNrr)rrrsrtrurvrrNrr r.r^rxrfrr0r0r0r1r,s     r,c@seZdZdZd,ddZed-ddZed.d d Zed/ddZ eddZ ddZ ddZ ddZ ddZddZddZeddZed0d!d"Zed#d$Zed%d&Zed'd(Zed)d*Zd+S)1TcRangeaA 2D block of `a:tc` cell elements in a table. This object assumes the structure of the underlying table does not change during its lifetime. Structural changes in this context would be insertion or removal of rows or columns. The client is expected to create, use, and then abandon an instance in the context of a single user operation that is known to have no structural side-effects of this type. rNrhother_tccCs||_||_dSrI)_tc _other_tc)r/rNrr0r0r1__init__s zTcRange.__init__cCs0|j|j|jd|j|jd}|||S)z5Return instance created from merge-origin tc element.r#)rarNrfrrgr)r_rNrr0r0r1from_merge_origins  zTcRange.from_merge_originr+r4cCsJ|D]}|jdkrdS|jdkrdS|jrdS|jr"dSqdS)z=True if one or more cells in range are part of a merged cell.r#TF)rPrrrr)r/rNr0r0r1contains_merged_cells   zTcRange.contains_merged_celltuple[int, int]cCs|j\}}}}||fS)z5(row_count, col_count) pair describing size of range._extents)r/_rXr*r0r0r1 dimensionszTcRange.dimensionscCs|jj|jjur dSdS)z=True if both cells provided to constructor are in same table.TF)rrarr:r0r0r1 in_same_tableszTcRange.in_same_tableccsB|jj|j|jD]}|j|jd|jD]}|Vqq dS)z=Generate each `a:tc` element not in leftmost column of range.r#N_tblr_top_bottomrJ_left_rightr/rMrNr0r0r1iter_except_left_col_tcss z TcRange.iter_except_left_col_tcsccsB|jj|jd|jD]}|j|j|jD]}|Vqq dS)z8Generate each `a:tc` element in non-first rows of range.r#Nrrr0r0r1iter_except_top_row_tcss zTcRange.iter_except_top_row_tcsccs2|j}|jj|j|jD]}|j|VqdS)z9Generate each `a:tc` element in leftmost column of range.N)rrrrrrJ)r/rgrMr0r0r1iter_left_col_tcss zTcRange.iter_left_col_tcscs"fddjjjjDS)zwGenerate each `a:tc` element in this range. Cell elements are generated left-to-right, top-to-bottom. c3s,|]}|jjjD]}|Vq qdSrI)rJrrrKr:r0r1rO s z#TcRange.iter_tcs..)rrrrr:r0r:r1rPs zTcRange.iter_tcsccs2|jj|j}|j|j|jD]}|VqdS)z5Generate each `a:tc` element in topmost row of range.N)rrrrJrrrr0r0r1iter_top_row_tcss zTcRange.iter_top_row_tcscCs4t|}|d}|ddD]}||qdS)z,Move all paragraphs in range to origin cell.rr#N)listrPr)r/ZtcsZ origin_tcrr0r0r1move_content_to_origins  zTcRange.move_content_to_origincCs|j\}}}}||S)z(Index of row following last row of ranger)r/rtopr*r0r0r1rrzTcRange._bottomtuple[int, int, int, int]cCsHd dd}|j|j}}||j|j\}}||j|j\}}||||fS) a5A (left, top, width, height) tuple describing range extents. Note this is normalized to accommodate the various orderings of the corner cells provided on construction, which may be in any of four configurations such as (top-left, bottom-right), (bottom-left, top-right), etc. idxrV other_idxr+rcSst||t||dfS)z:Return beginning and length of range based on two indexes.r#)minabs)rrr0r0r1start_and_size,sz(TcRange._extents..start_and_sizeN)rrVrrVr+r)rrrgrf)r/rrNrleftrXrr*r0r0r1r#s  zTcRange._extentscCs|j\}}}}|S)z"Index of leftmost column in range.r)r/rrr0r0r1r7z TcRange._leftcCs|j\}}}}||S)z3Index of column following the last column in range.r)r/rrrXr0r0r1r=rzTcRange._rightcCs|jjS)z+`a:tbl` element containing this cell range.)rrar:r0r0r1rCsz TcRange._tblcCs|j\}}}}|S)zIndex of topmost row in range.r)r/rrr0r0r1rHrz TcRange._topN)rNrhrrh)rNrhrq)r+r)r+r)rrrsrtrurrzrrrrrrrrrPrrrrrrrrr0r0r0r1rs:           rN)-ru __future__rtypingrrrrpptx.enum.textr pptx.oxmlrpptx.oxml.dml.fillr pptx.oxml.nsr pptx.oxml.simpletypesr r rrpptx.oxml.textrpptx.oxml.xmlchemyrrrrrrrr pptx.utilrrrrrhrrr'rr,objectrr0r0r0r1s.      (  <"