,h?dZddlmZddlmZddlmZddlmZddl m Z ddl m Z Gdd e ZGd d eZGd d eZGddeZGddeZGddeZGddeZy)z-Table-related objects such as Table and Cell.) is_integer) FillFormat)TcRange)Subshape) TextFrame) lazypropertyceZdZdZfdZdZedZedZ e jdZ edZ e jdZ ed Z e jd Z d Z ed Zejd ZedZejdZdZdZedZedZedZejdZxZS)TablezA DrawingML table object. Not intended to be constructed directly, use :meth:`.Slide.shapes.add_table` to add a table to a slide. cFtt| ||_||_yN)superr __init___tbl_graphic_frame)selftbl graphic_frame __class__s L/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/table.pyrzTable.__init__s eT#% +cNt|jj|||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. )_Cellrtc)rrow_idxcol_idxs rcellz Table.cells TYY\\'73T::rc.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]``. )_ColumnCollectionrrs rcolumnsz Table.columns!s!D11rc.|jjS)z Read/write boolean property which, when true, indicates the first column should be formatted differently, as for a side-heading column at the far left of the table. rfirstColrs r first_colzTable.first_col*syy!!!rc&||j_yr r"rvalues rr$zTable.first_col3" rc.|jjS)z Read/write boolean property which, when true, indicates the first row should be formatted differently, e.g. for column headings. rfirstRowrs r first_rowzTable.first_row7s yy!!!rc&||j_yr r*r&s rr,zTable.first_row?r(rc.|jjS)z Read/write boolean property which, when true, indicates the rows of the table should appear with alternating shading. rbandRowrs r horz_bandingzTable.horz_bandingC yy   rc&||j_yr r/r&s rr1zTable.horz_bandingK! rcJfdjjDS)zGenerate _Cell object for each cell in this table. Each grid cell is generated in left-to-right, top-to-bottom order. c36K|]}t|ywr r.0rrs r z#Table.iter_cells..Ts?Bb$?)riter_tcsrs`r iter_cellszTable.iter_cellsOs @$))*<*<*>??rc.|jjS)z Read/write boolean property which, when true, indicates the last column should be formatted differently, as for a row totals column at the far right of the table. rlastColrs rlast_colzTable.last_colVyy   rc&||j_yr r?r&s rrAzTable.last_col_r4rc.|jjS)z Read/write boolean property which, when true, indicates the last row should be formatted differently, as for a totals row at the bottom of the table. rlastRowrs rlast_rowzTable.last_rowcrBrc&||j_yr rEr&s rrGzTable.last_rowlr4rct|jDcgc]}|jc}}||j_ycc}w)z Called by a row when its height changes, triggering the graphic frame to recalculate its total height (as the sum of the row heights). N)sumrowsheightr)rrownew_table_heights rnotify_height_changedzTable.notify_height_changedps6 dii@s @A%5" AAct|jDcgc]}|jc}}||j_ycc}w)z Called by a column when its width changes, triggering the graphic frame to recalculate its total width (as the sum of the column widths). N)rJr widthr)rcolnew_table_widths rnotify_width_changedzTable.notify_width_changedxs5 DLLASsyyAB$3!BrPc.|jjS)z9 The package part containing this table. )rpartrs rrWz Table.parts ""'''rc.t|j|S)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]``. )_RowCollectionrrs rrKz Table.rowssdii..rc.|jjS)z Read/write boolean property which, when true, indicates the columns of the table should appear with alternating shading. rbandColrs r vert_bandingzTable.vert_bandingr2rc&||j_yr r[r&s rr]zTable.vert_bandingr4r)__name__ __module__ __qualname____doc__rrrr propertyr$setterr,r1r=rArGrOrUrWrKr] __classcell__rs@rr r sn , ;22""##""##!!""@!!__""!!__""64(( //!!""rr ceZdZdZfdZdZdZedZe dZ e dZ e dZ e jd Z e d Zejd Ze d Zejd Ze dZejdZdZe dZe dZdZe dZejdZe dZe dZejdZedZxZS)rz Table cellc:tt| |||_yr )r rr_tc)rrparentrs rrz_Cell.__init__s eT#F+rc^t|t|sy|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 isinstancetyperirothers r__eq__z _Cell.__eq__s( %d,xx599$$rc^t|t|sy|j|juS)NTrlros r__ne__z _Cell.__ne__s&%d,xxuyy((rc`|jj}tj|S)z| |FillFormat| instance for this cell, providing access to fill properties such as foreground color. )riget_or_add_tcPrrfrom_fill_parent)rtcPrs rfillz _Cell.fills' xx'')**400rc.|jjS)z=True if this cell is the top-left grid cell in a merged cell.)riis_merge_originrs rrzz_Cell.is_merge_originsxx'''rc.|jjS)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. )ri is_spannedrs rr|z_Cell.is_spannedsxx"""rc.|jjS)z Read/write integer value of left margin of cell as a |Length| value object. If assigned |None|, the default value is used, 0.1 inches for left and right margins and 0.05 inches for top and bottom. )rimarLrs r margin_leftz_Cell.margin_leftsxx}}rcH|j|||j_yr )_validate_margin_valuerir~)rrs rrz_Cell.margin_lefts ##K0# rc.|jjS)z' Right margin of cell. )rimarRrs r margin_rightz_Cell.margin_right xx}}rcH|j|||j_yr )rrir)rrs rrz_Cell.margin_rights ##L1$ rc.|jjS)z% Top margin of cell. )rimarTrs r margin_topz_Cell.margin_toprrcH|j|||j_yr )rrir)rrs rrz_Cell.margin_tops ##J/" rc.|jjS)z( Bottom margin of cell. )rimarBrs r margin_bottomz_Cell.margin_bottomrrcH|j|||j_yr )rrir)rrs rrz_Cell.margin_bottoms ##M2% rct|j|j}|js td|jr td|j |j \}}|jD] }||_ |jD] }||_ |jD] }d|_ |jD] }d|_ y)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)rri in_same_table ValueErrorcontains_merged_cellmove_content_to_origin dimensionsiter_top_row_tcsrowSpaniter_left_col_tcsgridSpaniter_except_left_col_tcshMergeiter_except_top_row_tcsvMerge)r other_celltc_range row_count col_countrs rmergez _Cell.merges488Z^^4%%>? ?  ( (FG G'')'22 9++- #B"BJ #,,. $B#BK $335 BBI 224 BBI rc.|jjS)anint 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`. )rirrs r span_heightz_Cell.span_heightsxxrc.|jjS)aqint 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`. )rirrs r span_widthz_Cell.span_width+sxx   rc|js tdtj|j}|j D]}dx|_|_dx|_|_ y)a`Remove 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) rzrrfrom_merge_originrir<rrrr)rrrs rsplitz _Cell.split7sg##S ,,TXX6##% *B'( (BJ$) )BI  *rc.|jjS)aUnicode (str in Python 3) representation of cell contents. 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.) Either bytes (Python 2 str) or unicode (Python 3 str) can be assigned. Bytes can be 7-bit ASCII or UTF-8 encoded 8-bit bytes. Bytes values are converted to unicode assuming UTF-8 encoding (which correctly decodes ASCII).  text_frametextrs rrz _Cell.textLs&###rc&||j_yr r)rrs rrz _Cell.textas#rcN|jj}t||S)zT |TextFrame| instance containing the text that appears in the cell. )riget_or_add_txBodyr)rtxBodys rrz_Cell.text_framees# ++-&&rc.|jjS)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. rianchorrs rvertical_anchorz_Cell.vertical_anchormsxxrc&||j_yr r)rmso_anchor_idxs rrz_Cell.vertical_anchor|s (rc@t|s|d}t||zyy)zg Raise ValueError if *margin_value* is not a positive integer value or |None|. Nz.margin value must be integer or None, got '%s')r TypeError) margin_valuetmpls rrz_Cell._validate_margin_values/ ,'L,DCDD</0 0-E'r)r_r`rarbrrqrsrrxrcrzr|rrdrrrrrrrrrr staticmethodrrerfs@rrrs%) 11(( # #$$ %% ## &&>     ! !**$$( [[$$''  ))11rrcVeZdZdZfdZedZejdZxZS)_Columnz Table columnc:tt| |||_yr )r rr_gridCol)rgridColrjrs rrz_Column.__init__s gt%f- rc.|jjS)z) Width of column in EMU. )rwrs rrRz _Column.widths }}rcZ||j_|jjyr )rr_parentrU)rrRs rrRz _Column.widths  ))+r) r_r`rarbrrcrRrdrerfs@rrrs7   \\,,rrcfeZdZdZfdZedZedZejdZxZ S)_Rowz Table rowc:tt| |||_yr )r rr_trrtrrjrs rrz _Row.__init__s dD"6*rc.t|j|S)z Read-only reference to collection of cells in row. An individual cell is referenced using list notation, e.g. ``cell = row.cells[0]``. )_CellCollectionrrs rcellsz _Row.cellss txx..rc.|jjS)z' Height of row in EMU. )rhrs rrLz _Row.heights xxzzrcZ||j_|jjyr )rrrrO)rrLs rrLz _Row.heights  **,r) r_r`rarbrrcrrLrdrerfs@rrrsK//  ]]--rrc4eZdZdZfdZdZdZdZxZS)rz Horizontal sequence of row cellsc:tt| |||_yr )r rrrrs rrz_CellCollection.__init__s ot-f5rc|dks"|t|jjk\rd|z}t|t |jj||S)z+Provides indexed access, (e.g. 'cells[0]').rzcell index [%d] out of range)lenrtc_lst IndexErrorrridxmsgs r __getitem__z_CellCollection.__getitem__sK 7cS11036CS/ !TXX__S)400rcBfdjjDS)zProvides iterability.c36K|]}t|ywr r7r8s rr:z+_CellCollection.__iter__..s:Bb$:r;)rrrs`r__iter__z_CellCollection.__iter__s:$((//::rc@t|jjS)z1Supports len() function (e.g. 'len(cells) == 1').)rrrrs r__len__z_CellCollection.__len__s488??##r) r_r`rarbrrrrrerfs@rrrs*1;$rrc4eZdZdZfdZdZdZdZxZS)rzSequence of table columns.c:tt| |||_yr )r rrrrrrjrs rrz_ColumnCollection.__init__s /7 rc|dks,|t|jjjk\rd|z}t |t |jjj||S)z? Provides indexed access, (e.g. 'columns[0]'). rzcolumn index [%d] out of range)rrtblGrid gridCol_lstrrrs rrz_ColumnCollection.__getitem__s] 7cS!2!2!>!>??2S8CS/ !tyy((44S94@@rcTt|jjjS)zE Supports len() function (e.g. 'len(columns) == 1'). )rrrrrs rrz_ColumnCollection.__len__s499$$0011rc8|jjy)zR Called by a column when its width changes. Pass along to parent. N)rrUrs rrUz&_ColumnCollection.notify_width_changeds ))+r) r_r`rarbrrrrUrerfs@rrrs$A2 ,rrc4eZdZdZfdZdZdZdZxZS)rYzSequence of table rowsc:tt| |||_yr )r rYrrrs rrz_RowCollection.__init__s nd,V4 rc|dks|t|k\rd|z}t|t|jj||S)z< Provides indexed access, (e.g. 'rows[0]'). rzrow index [%d] out of range)rrrrtr_lstrs rrz_RowCollection.__getitem__sF 7cSY&/#5CS/ !DII$$S)400rc@t|jjS)zB Supports len() function (e.g. 'len(rows) == 1'). )rrrrs rrz_RowCollection.__len__s499##$$rc8|jjy)zP Called by a row when its height changes. Pass along to parent. N)rrOrs rrOz$_RowCollection.notify_height_changeds **,r) r_r`rarbrrrrOrerfs@rrYrYs 1% -rrYN)rb pptx.compatr pptx.dml.fillrpptx.oxml.tabler pptx.shapesrpptx.text.textr pptx.utilrobjectr rrrrrrYrrrsv4"$# $"N"FN"bj1Hj1Z,h,(-8-8$h$.,,:-X-r