hiLBdZddlmZddlmZmZddlmZddlm Z ddl m Z ddl m Z ddlmZmZer*dd lmZdd lmZmZmZmZdd lmZdd lmZdd lmZddlmZGddeZGdde Z Gdde Z!Gdde Z"Gdde Z#Gdde Z$Gdde 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)LengthceZdZdZd%fd Zd&d Zed'dZed(dZ e j d)dZ ed(dZ e j d)dZ ed(dZ e j d)dZ d*dZ ed(dZej d)dZed(dZej d)dZd+dZd+dZed,d!Zed"Zed(d#Zej d)d$ZxZS)-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_framercrtt|||_||_dSN)superr__init___tbl_graphic_frame)selfrr __class__s b/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/pptx/table.pyrzTable.__init__s4 eT##%%% +row_idxintcol_idxreturn_CellcTt|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%s r!cellz Table.cell"s$ TY\\'733T:::r"_ColumnCollectionc,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+rrs r!columnsz Table.columns*s!D111r"boolc|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-s r! first_colzTable.first_col3y!!r"valuec||j_dSrr1rr5s r!r3zTable.first_col<" r"c|jjS)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-s r! first_rowzTable.first_row@r4r"c||j_dSrr:r7s r!r<zTable.first_rowIr8r"c|jjS)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-s r! horz_bandingzTable.horz_bandingMy  r"c||j_dSrr?r7s r!rAzTable.horz_bandingV! r"Iterator[_Cell]cNfdjDS)zGenerate _Cell object for each cell in this table. Each grid cell is generated in left-to-right, top-to-bottom order. c38K|]}t|VdSrr'.0r)rs r! z#Table.iter_cells.._s+??Bb$??????r")riter_tcsr-s`r! iter_cellszTable.iter_cellsZs. @???$)*<*<*>*>????r"c|jjS)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-s r!last_colzTable.last_colarBr"c||j_dSrrOr7s r!rQzTable.last_coljrDr"c|jjS)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-s r!last_rowzTable.last_rowns y  r"c||j_dSrrTr7s r!rVzTable.last_rowvrDr"Nonectttd|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). cg|] }|j S)height)rJrows r! z/Table.notify_height_changed..s#D#D#D3CJ#D#D#Dr"N)r sumrowsrr\)rnew_table_heights r!notify_height_changedzTable.notify_height_changedzs< s#D#D$)#D#D#DEEFF%5"""r"ctttd|jD}||j_dS)zCalled by a column when its width changes. Triggers the graphic frame to recalculate its total width (as the sum of the column widths). cg|] }|j Sr[)width)rJcols r!r^z.Table.notify_width_changed..s"E"E"E39"E"E"Er"N)r r_r.rre)rnew_table_widths r!notify_width_changedzTable.notify_width_changeds; c"E"E "E"E"EFFGG$3!!!r"rc|jjS)z'The package part containing this table.)rpartr-s r!rjz Table.parts"''r"c,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]`. )_RowCollectionrr-s r!r`z Table.rowssdi...r"c|jjS)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-s r! vert_bandingzTable.vert_bandingrBr"c||j_dSrrnr7s r!rpzTable.vert_bandingrDr")rr rr)r#r$r%r$r&r')r&r+r&r/)r5r/r&rEr&rX)r&r)__name__ __module__ __qualname____doc__rr*r r.propertyr3setterr<rArMrQrVrbrhrjr`rp __classcell__r s@r!rrs ,,,,,, ;;;;222\2"""X"####"""X"####!!!X!""""@@@@!!!X!_"""_"!!!X!_"""_"66664444(((X(//\/!!!X!""""""""r"rcHeZdZdZd2fd Zd3d Zd3d Zed4dZe d5dZ e d5dZ e d6dZ e j d7dZ e d6dZej d8dZe d6dZej d9dZe d6dZej d:dZd;d!Ze dd'Zej d?d)Ze d@d+Ze dAd-Zej dBd/ZedCd1ZxZS)Dr'z Table cellr)rparentrcftt||||_dSr)rr'r_tc)rr)r~r s r!rz_Cell.__init__s, eT##F+++r"otherobjectr&r/c\t|t|sdS|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 isinstancetyperrrs r!__eq__z _Cell.__eq__s0 %d,, 5x59$$r"c\t|t|sdS|j|juS)NTrrs r!__ne__z _Cell.__ne__s.%d,, 4xuy((r"rc\|j}tj|S)zs|FillFormat| instance for this cell. Provides access to fill properties such as foreground color. )rget_or_add_tcPrrfrom_fill_parent)rtcPrs r!fillz _Cell.fills( x''))*4000r"c|jjS)z=True if this cell is the top-left grid cell in a merged cell.)ris_merge_originr-s r!rz_Cell.is_merge_originsx''r"c|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. )r is_spannedr-s r!rz_Cell.is_spannedsx""r"rc|jjS)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. )rmarLr-s r! margin_leftz_Cell.margin_leftsx}r"r Length | NonecH||||j_dSr)_validate_margin_valuerr)rrs r!rz_Cell.margin_lefts# ##K000# r"c|jjS)zRight margin of cell.)rmarRr-s r! margin_rightz_Cell.margin_rightx}r"rcH||||j_dSr)rrr)rrs r!rz_Cell.margin_rights# ##L111$ r"c|jjS)zTop margin of cell.)rmarTr-s r! margin_topz_Cell.margin_toprr"rcH||||j_dSr)rrr)rrs r!rz_Cell.margin_tops# ##J///" r"c|jjS)zBottom margin of cell.)rmarBr-s r! margin_bottomz_Cell.margin_bottomrr"rcH||||j_dSr)rrr)rrs r!rz_Cell.margin_bottoms# ##M222% r" other_cellrXct|j|j}|jstd|jrtd||j\}}|D] }||_ | D] }||_ | D] }d|_ | D] }d|_ 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)rr 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_range row_count col_countr)s r!mergez _Cell.merges48Z^44% @>?? ?  ( HFGG G'')))'2 9++-- # #B"BJJ,,.. $ $B#BKK3355  BBII2244  BBII  r"r$c|jjS)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`. )rrr-s r! span_heightz_Cell.span_height"sxr"c|jjS)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`. )rrr-s r! span_widthz_Cell.span_width-sx  r"c|jstdtj|j}|D]}dx|_|_dx|_|_ dS)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) rrrfrom_merge_originrrLrrrr)rrr)s r!splitz _Cell.split8st# b`aa a,TX66##%% * *B'( (BJ$) )BI  * *r"strc|jjS)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-s r!rz _Cell.textJs##r"rc||j_dSrr)rrs r!rz _Cell.textZs#r"r cT|j}t||S)z9|TextFrame| containing the text that appears in the cell.)rget_or_add_txBodyr )rtxBodys r!rz_Cell.text_frame^s'++--&&&r"MSO_VERTICAL_ANCHOR | Nonec|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. ranchorr-s r!vertical_anchorz_Cell.vertical_anchordsxr"mso_anchor_idxc||j_dSrr)rrs r!rz_Cell.vertical_anchorqs(r" margin_valuec`t|ts|d}t||zdSdS)zMRaise ValueError if `margin_value` is not a positive integer value or |None|.Nz.margin value must be integer or None, got '%s')rr$ TypeError)rtmpls r!rz_Cell._validate_margin_valueusC,,, 11ICDD</00 0 1 11I1Ir")r)rr~r)rrr&r/)r&rrrr&r)rr)rr)rr)rr)rr'r&rXr&r$rt)r&r)rr)r&r )r&r)rr)rrr&rX)rurvrwrxrrrr rryrrrrzrrrrrrrrrr staticmethodrr{r|s@r!r'r's %%%%)))) 111\1(((X( # # #X #X$$$$X%%%%X####X&&&&<   X !!!X!****$ $ $ $X $ [$$$[$'''X'    X ))))111\11111r"r'c^eZdZdZd fd Zed d Zejdd ZxZS)_Columnz Table columngridColrr~r+cttt||||_||_dSr)rrr_parent_gridCol)rrr~r s r!rz_Column.__init__s3 gt%%f---  r"r&rc|jjS)zWidth of column in EMU.)rwr-s r!rez _Column.widths}r"recP||j_|jdSr)rrrrh)rres r!rez _Column.widths%  ))+++++r")rrr~r+r)rer) rurvrwrxrryrerzr{r|s@r!rr}s      X \,,,\,,,,,r"rcteZdZdZd fd ZedZedd Zejdd ZxZ S)_Rowz Table rowtrrr~rlcttt||||_||_dSr)rrrr_trrrr~r s r!rz _Row.__init__s3 dD""6*** r"c,t|j|S)zRead-only reference to collection of cells in row. An individual cell is referenced using list notation, e.g. `cell = row.cells[0]`. )_CellCollectionrr-s r!cellsz _Row.cellss tx...r"r&rc|jjS)zHeight of row in EMU.)rhr-s r!r\z _Row.heightsxzr"r\cP||j_|jdSr)rrrrb)rr\s r!r\z _Row.heights%  **,,,,,r")rrr~rlr)r\r) rurvrwrxrryrr\rzr{r|s@r!rrsO //X/X ]---]-----r"rc<eZdZdZdfd Zdd Zdd ZddZxZS)rz Horizontal sequence of row cellsrrr~rcttt||||_||_dSr)rrrrrrs r!rz_CellCollection.__init__s3 ot$$--f555 r"idxr$r&r'c|dks|t|jjkrd|z}t|t |jj||S)z+Provides indexed access, (e.g. 'cells[0]').rzcell index [%d] out of range)lenrtc_lst IndexErrorr'rrmsgs r! __getitem__z_CellCollection.__getitem__sP 77cS1111036CS// !TX_S)4000r"rEc4fdjjDS)zProvides iterability.c38K|]}t|VdSrrHrIs r!rKz+_CellCollection.__iter__..s+::Bb$::::::r")rrr-s`r!__iter__z_CellCollection.__iter__s!::::$(/::::r"c4t|jjS)z1Supports len() function (e.g. 'len(cells) == 1').)rrrr-s r!__len__z_CellCollection.__len__s48?###r")rrr~r)rr$r&r'rsr) rurvrwrxrrrrr{r|s@r!rrs** 1111;;;;$$$$$$$$r"rc8eZdZdZd fd Zd d Zd Zd ZxZS)r+zSequence of table columns.rr r~rcttt||||_||_dSr)rr+rrrrrr~r s r!rz_ColumnCollection.__init__s4 &&//777  r"rr$c|dks"|t|jjjkrd|z}t |t |jjj||S)z-Provides indexed access, (e.g. 'columns[0]').rzcolumn index [%d] out of range)rrtblGrid gridCol_lstrrrs r!rz_ColumnCollection.__getitem__sX 77cS!2!>????2S8CS// !ty(4S94@@@r"c>t|jjjS)z3Supports len() function (e.g. 'len(columns) == 1').)rrrrr-s r!rz_ColumnCollection.__len__s49$0111r"c8|jdS)z@Called by a column when its width changes. Pass along to parent.N)rrhr-s r!rhz&_ColumnCollection.notify_width_changeds ))+++++r"rr r~r)rr$) rurvrwrxrrrrhr{r|s@r!r+r+sy$$ AAAA222,,,,,,,r"r+c8eZdZdZdfd Zdd Zd Zd ZxZS)rlzSequence of table rowsrr r~rcttt||||_||_dSr)rrlrrrrs r!rz_RowCollection.__init__s3 nd##,,V444  r"rr$r&rc|dks|t|krd|z}t|t|jj||S)z*Provides indexed access, (e.g. 'rows[0]').rzrow index [%d] out of range)rrrrtr_lstrs r!rz_RowCollection.__getitem__sK 77cSYY&&/#5CS// !DI$S)4000r"c4t|jjS)z0Supports len() function (e.g. 'len(rows) == 1').)rrr r-s r!rz_RowCollection.__len__s49#$$$r"c8|jdS)z>Called by a row when its height changes. Pass along to parent.N)rrbr-s r!rbz$_RowCollection.notify_height_changeds **,,,,,r"r)rr$r&r) rurvrwrxrrrrbr{r|s@r!rlrlsu   1111%%%-------r"rlN)&rx __future__rtypingrr pptx.dml.fillrpptx.oxml.tabler pptx.shapesrpptx.text.textr pptx.utilr r pptx.enum.textr r rrrpptx.parts.sliderpptx.shapes.graphfrmr pptx.typesrrrrr'rrrr+rlr[r"r!rs]33""""""********$$$$$$###### $$$$$$''''''''!222222PPPPPPPPPPPP......111111''''''      O"O"O"O"O"FO"O"O"dR1R1R1R1R1HR1R1R1j,,,,,h,,,&-----8---6$$$$$h$$$0,,,,,,,,0-----X-----r"