o 7hLB@s,dZddlmZddlmZmZddlmZddlm Z ddl m Z ddl m Z ddlmZmZer\dd lmZdd lmZmZmZmZdd lmZdd lmZdd lmZddlmZGdddeZGddde Z Gddde Z!Gddde Z"Gddde Z#Gddde Z$Gddde Z%dS)z-Table-related objects such as Table and Cell.) annotations) TYPE_CHECKINGIterator) FillFormat)TcRange)Subshape) TextFrame)Emu lazyproperty)MSO_VERTICAL_ANCHOR)CT_Table CT_TableCell CT_TableCol CT_TableRow) BaseSlidePart) GraphicFrame) ProvidesPart)Lengthcs&eZdZdZd3fdd Zd4d dZed5ddZed6ddZ e j d7ddZ ed6ddZ e j d7ddZ ed6ddZ e j d7ddZ d8ddZ ed6d d!Zej d7d"d!Zed6d#d$Zej d7d%d$Zd9d'd(Zd9d)d*Zed:d,d-Zed.d/Zed6d0d1Zej d7d2d1ZZS);TablezA DrawingML table object. Not intended to be constructed directly, use :meth:`.Slide.shapes.add_table` to add a table to a slide. tblr graphic_framercstt|||_||_dSN)superr__init___tbl_graphic_frame)selfrr __class__R/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/table.pyrs zTable.__init__row_idxintcol_idxreturn_CellcCst|j|||S)zReturn cell at `row_idx`, `col_idx`. Return value is an instance of |_Cell|. `row_idx` and `col_idx` are zero-based, e.g. cell(0, 0) is the top, left cell in the table. )r%rtc)rr!r#rrr cell"sz Table.cell_ColumnCollectioncC t|j|S)z|_ColumnCollection| instance for this table. Provides access to |_Column| objects representing the table's columns. |_Column| objects are accessed using list notation, e.g. `col = tbl.columns[0]`. )r(rrrrr columns* z Table.columnsboolcC|jjS)zWhen `True`, indicates first column should have distinct formatting. Read/write. Distinct formatting is used, for example, when the first column contains row headings (is a side-heading column). rfirstColr*rrr first_col3zTable.first_colvaluecC ||j_dSrr/rr3rrr r1< cCr.)zWhen `True`, indicates first row should have distinct formatting. Read/write. Distinct formatting is used, for example, when the first row contains column headings. rfirstRowr*rrr first_row@r2zTable.first_rowcCr4rr7r5rrr r9Ir6cCr.)zWhen `True`, indicates rows should have alternating shading. Read/write. Used to allow rows to be traversed more easily without losing track of which row is being read. rbandRowr*rrr horz_bandingMr2zTable.horz_bandingcCr4rr:r5rrr r<Vr6Iterator[_Cell]csfddjDS)zGenerate _Cell object for each cell in this table. Each grid cell is generated in left-to-right, top-to-bottom order. c3|]}t|VqdSrr%.0r&r*rr _z#Table.iter_cells..)riter_tcsr*rr*r iter_cellsZszTable.iter_cellscCr.)zWhen `True`, indicates the rightmost column should have distinct formatting. Read/write. Used, for example, when a row totals column appears at the far right of the table. rlastColr*rrr last_colar2zTable.last_colcCr4rrFr5rrr rHjr6cCr.)zWhen `True`, indicates the bottom row should have distinct formatting. Read/write. Used, for example, when a totals row appears as the bottom row. rlastRowr*rrr last_rownszTable.last_rowcCr4rrIr5rrr rKvr6NonecC$ttdd|jD}||j_dS)zCalled by a row when its height changes. Triggers the graphic frame to recalculate its total height (as the sum of the row heights). cSg|]}|jqSr)height)rArowrrr z/Table.notify_height_changed..N)r sumrowsrrO)rZnew_table_heightrrr notify_height_changedz zTable.notify_height_changedcCrM)zCalled by a column when its width changes. Triggers the graphic frame to recalculate its total width (as the sum of the column widths). cSrNr)width)rAcolrrr rQrRz.Table.notify_width_changed..N)r rSr+rrW)rZnew_table_widthrrr notify_width_changedrVzTable.notify_width_changedrcCr.)z'The package part containing this table.)rpartr*rrr rZz Table.partcCr))z|_RowCollection| instance for this table. Provides access to |_Row| objects representing the table's rows. |_Row| objects are accessed using list notation, e.g. `col = tbl.rows[0]`. )_RowCollectionrr*rrr rTr,z Table.rowscCr.)zWhen `True`, indicates columns should have alternating shading. Read/write. Used to allow columns to be traversed more easily without losing track of which column is being read. rbandColr*rrr vert_bandingr2zTable.vert_bandingcCr4rr]r5rrr r_r6)rr rr)r!r"r#r"r$r%)r$r(r$r-)r3r-r$r=r$rL)r$r)__name__ __module__ __qualname____doc__rr'r r+propertyr1setterr9r<rErHrKrUrYrZrTr_ __classcell__rrrr rsJ                  rcs`eZdZdZdDfdd ZdEd d ZdEddZedFddZe dGddZ e dGddZ e dHddZ e j dIddZ e dHddZej dJd dZe dHd!d"Zej dKd$d"Ze dHd%d&Zej dLd(d&ZdMd+d,Ze dNd.d/Ze dNd0d1ZdOd2d3Ze dPd5d6Zej dQd8d6Ze dRd:d;Ze dSd=d>Zej dTd@d>ZedUdBdCZZS)Vr%z Table cellr&r parentrcstt||||_dSr)rr%r_tc)rr&rjrrr rs z_Cell.__init__otherobjectr$r-cCst|t|s dS|j|juS)z|True| if this object proxies the same element as `other`. Equality for proxy objects is defined as referring to the same XML element, whether or not they are the same proxy object instance. F isinstancetyperkrrlrrr __eq__s z _Cell.__eq__cCst|t|s dS|j|juS)NTrnrqrrr __ne__s z _Cell.__ne__rcCs|j}t|S)zs|FillFormat| instance for this cell. Provides access to fill properties such as foreground color. )rkget_or_add_tcPrrfrom_fill_parent)rtcPrrrr fills  z _Cell.fillcCr.)z=True if this cell is the top-left grid cell in a merged cell.)rkis_merge_originr*rrr rxr[z_Cell.is_merge_origincCr.)acTrue if this cell is spanned by a merge-origin cell. A merge-origin cell "spans" the other grid cells in its merge range, consuming their area and "shadowing" the spanned grid cells. Note this value is |False| for a merge-origin cell. A merge-origin cell spans other grid cells, but is not itself a spanned cell. )rk is_spannedr*rrr rys z_Cell.is_spannedrcCr.)zLeft margin of cells. Read/write. If assigned |None|, the default value is used, 0.1 inches for left and right margins and 0.05 inches for top and bottom. )rkmarLr*rrr margin_leftr2z_Cell.margin_leftr{ Length | NonecC||||j_dSr)_validate_margin_valuerkrz)rr{rrr r{  cCr.)zRight margin of cell.)rkmarRr*rrr margin_rightr[z_Cell.margin_rightrcCr}r)r~rkr)rrrrr rrcCr.)zTop margin of cell.)rkmarTr*rrr margin_topr[z_Cell.margin_toprcCr}r)r~rkr)rrrrr rrcCr.)zBottom margin of cell.)rkmarBr*rrr margin_bottomr[z_Cell.margin_bottomrcCr}r)r~rkr)rrrrr rr other_cellrLcCst|j|j}|jstd|jrtd||j\}}|D]}||_q"| D]}||_ q,| D]}d|_ q6| D]}d|_q@dS)aCreate merged cell from this cell to `other_cell`. This cell and `other_cell` specify opposite corners of the merged cell range. Either diagonal of the cell region may be specified in either order, e.g. self=bottom-right, other_cell=top-left, etc. Raises |ValueError| if the specified range already contains merged cells anywhere within its extents or if `other_cell` is not in the same table as `self`. zother_cell from different tablez'range contains one or more merged cellsTN)rrk in_same_table ValueErrorcontains_merged_cellmove_content_to_origin dimensionsiter_top_row_tcsrowSpaniter_left_col_tcsgridSpaniter_except_left_col_tcshMergeiter_except_top_row_tcsvMerge)rrtc_rangeZ row_count col_countr&rrr merges       z _Cell.merger"cCr.)afint count of rows spanned by this cell. The value of this property may be misleading (often 1) on cells where `.is_merge_origin` is not |True|, since only a merge-origin cell contains complete span information. This property is only intended for use on cells known to be a merge origin by testing `.is_merge_origin`. )rkrr*rrr span_height" z_Cell.span_heightcCr.)aiint count of columns spanned by this cell. The value of this property may be misleading (often 1) on cells where `.is_merge_origin` is not |True|, since only a merge-origin cell contains complete span information. This property is only intended for use on cells known to be a merge origin by testing `.is_merge_origin`. )rkrr*rrr span_width-rz_Cell.span_widthcCsD|jstdt|j}|D]}d|_|_d|_|_ qdS)aXRemove merge from this (merge-origin) cell. The merged cell represented by this object will be "unmerged", yielding a separate unmerged cell for each grid cell previously spanned by this merge. Raises |ValueError| when this cell is not a merge-origin cell. Test with `.is_merge_origin` before calling. z>not a merge-origin cell; only a merge-origin cell can be splitFN) rxrrfrom_merge_originrkrDrrrr)rrr&rrr split8s    z _Cell.splitstrcCr.)aTextual content of cell as a single string. The returned string will contain a newline character (`"\n"`) separating each paragraph and a vertical-tab (`"\v"`) character for each line break (soft carriage return) in the cell's text. Assignment to `text` replaces all text currently contained in the cell. A newline character (`"\n"`) in the assigned text causes a new paragraph to be started. A vertical-tab (`"\v"`) character in the assigned text causes a line-break (soft carriage-return) to be inserted. (The vertical-tab character appears in clipboard text copied from PowerPoint as its encoding of line-breaks.)  text_frametextr*rrr rJsz _Cell.textrcCr4rr)rrrrr rZr6rcCs|j}t||S)z9|TextFrame| containing the text that appears in the cell.)rkget_or_add_txBodyr)rtxBodyrrr r^s  z_Cell.text_frameMSO_VERTICAL_ANCHOR | NonecCr.)aVertical alignment of this cell. This value is a member of the :ref:`MsoVerticalAnchor` enumeration or |None|. A value of |None| indicates the cell has no explicitly applied vertical anchor setting and its effective value is inherited from its style-hierarchy ancestors. Assigning |None| to this property causes any explicitly applied vertical anchor setting to be cleared and inheritance of its effective value to be restored. rkanchorr*rrr vertical_anchords z_Cell.vertical_anchormso_anchor_idxcCr4rr)rrrrr rqr6 margin_valuecCs*t|ts|durd}t||dSdS)zMRaise ValueError if `margin_value` is not a positive integer value or |None|.Nz.margin value must be integer or None, got '%s')ror" TypeError)rtmplrrr r~us z_Cell._validate_margin_value)r&r rjr)rlrmr$r-)r$rr`r$r)r{r|)rr|)rr|)rr|)rr%r$rLr$r"rb)r$r)rr)r$r)r$r)rr)rr|r$rL)rcrdrerfrrrrsr rwrgrxryr{rhrrrrrrrrrr staticmethodr~rirrrr r%sZ                      r%cs@eZdZdZdfdd Zedd d Zejdd d ZZS)_Columnz Table columngridColrrjr(c tt||||_||_dSr)rrr_parent_gridCol)rrrjrrr r z_Column.__init__r$rcCr.)zWidth of column in EMU.)rwr*rrr rWr[z _Column.widthrWcC||j_|jdSr)rrrrY)rrWrrr rW)rrrjr(r)rWr) rcrdrerfrrgrWrhrirrrr r}s rcsLeZdZdZdfdd Zedd Zedd d Zejddd ZZ S)_Rowz Table rowtrrrjr\crr)rrrr_trrrrjrrr rrz _Row.__init__cCr))zRead-only reference to collection of cells in row. An individual cell is referenced using list notation, e.g. `cell = row.cells[0]`. )_CellCollectionrr*rrr cellss z _Row.cellsr$rcCr.)zHeight of row in EMU.)rhr*rrr rOr[z _Row.heightrOcCrr)rrrrU)rrOrrr rOr)rrrjr\r)rOr) rcrdrerfrrgrrOrhrirrrr rs  rcs@eZdZdZdfdd Zdd d ZdddZdddZZS)rz Horizontal sequence of row cellsrrrjrcrr)rrrrrrrrr rrz_CellCollection.__init__idxr"r$r%cCs:|dks |t|jjkrd|}t|t|jj||S)z+Provides indexed access, (e.g. 'cells[0]').rzcell index [%d] out of range)lenrtc_lst IndexErrorr%rrmsgrrr __getitem__sz_CellCollection.__getitem__r=csfddjjDS)zProvides iterability.c3r>rr?r@r*rr rBrCz+_CellCollection.__iter__..)rrr*rr*r __iter__sz_CellCollection.__iter__cC t|jjS)z1Supports len() function (e.g. 'len(cells) == 1').)rrrr*rrr __len__r6z_CellCollection.__len__)rrrjr)rr"r$r%rar) rcrdrerfrrrrrirrrr rs   rcs<eZdZdZdfdd Zdd d Zd d ZddZZS)r(zSequence of table columns.rr rjrcrr)rr(rrrrrrjrrr rrz_ColumnCollection.__init__rr"cCs>|dks |t|jjjkrd|}t|t|jjj||S)z-Provides indexed access, (e.g. 'columns[0]').rzcolumn index [%d] out of range)rrtblGrid gridCol_lstrrrrrr rsz_ColumnCollection.__getitem__cCst|jjjS)z3Supports len() function (e.g. 'len(columns) == 1').)rrrrr*rrr rz_ColumnCollection.__len__cC|jdS)z@Called by a column when its width changes. Pass along to parent.N)rrYr*rrr rYrz&_ColumnCollection.notify_width_changedrr rjr)rr") rcrdrerfrrrrYrirrrr r(  r(cs<eZdZdZdfdd Zdd d ZddZddZZS)r\zSequence of table rowsrr rjrcrr)rr\rrrrrrr rrz_RowCollection.__init__rr"r$rcCs6|dks |t|krd|}t|t|jj||S)z*Provides indexed access, (e.g. 'rows[0]').rzrow index [%d] out of range)rrrrtr_lstrrrr rsz_RowCollection.__getitem__cCr)z0Supports len() function (e.g. 'len(rows) == 1').)rrrr*rrr rr6z_RowCollection.__len__cCr)z>Called by a row when its height changes. Pass along to parent.N)rrUr*rrr rUrz$_RowCollection.notify_height_changedr)rr"r$r) rcrdrerfrrrrUrirrrr r\rr\N)&rf __future__rtypingrr pptx.dml.fillrpptx.oxml.tabler pptx.shapesrpptx.text.textr pptx.utilr r pptx.enum.textr r r rrpptx.parts.sliderpptx.shapes.graphfrmr pptx.typesrrrmrr%rrrr(r\rrrr s0          V