*hLB`SrSSKJr SSKJrJr SSKJr SSKJ r SSK J r SSK J r SSKJrJr \(a*SS KJr SS KJrJrJrJr SS KJr SS KJr SS KJr SSKJr "SS\5r"SS\ 5r "SS\ 5r!"SS\ 5r""SS\ 5r#"SS\ 5r$"SS\ 5r%g)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)Lengthc^\rSrSrSrSU4SjjrSSjr\SSj5r\ SSj5r \ RSSj5r \ SSj5r \ RSS j5r \ SS j5r \ RSS j5r SS jr\ SS j5r\RSSj5r\ SSj5r\RSSj5rSSjrSSjr\ SSj5r\S5r\ SSj5r\RSSj5rSrU=r$) TablezA DrawingML table object. Not intended to be constructed directly, use :meth:`.Slide.shapes.add_table` to add a table to a slide. cB>[[U] 5 XlX lgN)superr__init___tbl_graphic_frame)selftbl graphic_frame __class__s G/home/mande/repo/quber/.venv/lib/python3.13/site-packages/pptx/table.pyrTable.__init__s eT#% +cL[URRX5U5$)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 r"cell Table.cell"s TYY\\'3T::r$c.[URU5$)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 r"columns Table.columns*s!D11r$c.URR$)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_colTable.first_col3yy!!!r$c$XRlgrr2rvalues r"r4r5< " r$c.URR$)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_rowTable.first_row@r6r$c$XRlgrr<r8s r"r>r?Ir:r$c.URR$)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_bandingTable.horz_bandingMyy   r$c$XRlgrrBr8s r"rDrEV ! r$cL^U4SjTRR55$)zwGenerate _Cell object for each cell in this table. Each grid cell is generated in left-to-right, top-to-bottom order. c3<># UHn[UT5v M g7frr&.0r'rs r" #Table.iter_cells.._s?*>Bb$*>)riter_tcsr.s`r" iter_cellsTable.iter_cellsZs @$))*<*<*>??r$c.URR$)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_colTable.last_colarFr$c$XRlgrrUr8s r"rWrXjrHr$c.URR$)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_rowTable.last_rowns yy   r$c$XRlgrr[r8s r"r]r^vrHr$c[[URVs/sHoRPM sn55nX Rlgs snf)zCalled by a row when its height changes. Triggers the graphic frame to recalculate its total height (as the sum of the row heights). N)r sumrowsheightr)rrownew_table_heights r"notify_height_changedTable.notify_height_changedzs; s$))#D)3JJ)#DEF%5"$EA c[[URVs/sHoRPM sn55nX Rlgs snf)zCalled by a column when its width changes. Triggers the graphic frame to recalculate its total width (as the sum of the column widths). N)r rar/widthr)rcolnew_table_widths r"notify_width_changedTable.notify_width_changeds: c "E 99 "EFG$3!#Frhc.URR$)z'The package part containing this table.)rpartr.s r"rp Table.parts""'''r$c.[URU5$)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"rb Table.rowssdii..r$c.URR$)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_bandingTable.vert_bandingrFr$c$XRlgrrvr8s r"rxryrHr$)rr)rr r r)r(intr)r{returnr&)r|r-r|bool)r9r~r|zIterator[_Cell]r|None)r|r)__name__ __module__ __qualname____firstlineno____doc__rr*r r/propertyr4setterr>rDrRrWr]rfrmrprbrx__static_attributes__ __classcell__r!s@r"rrsn , ;22""##""##!!""@!!__""!!__""64((//!!""r$rcL^\rSrSrSrSU4SjjrSSjrSSjr\SSj5r \ SSj5r \ SSj5r \ S S j5r \ RS!S j5r \ S S j5r\RS"S j5r\ S S j5r\RS#Sj5r\ S Sj5r\RS$Sj5rS%Sjr\ S&Sj5r\ S&Sj5rS'Sjr\ S(Sj5r\RS)Sj5r\ S*Sj5r\ S+Sj5r\RS,Sj5r\S-Sj5rSrU=r$).r&z Table cellc8>[[U] U5 Xlgr)rr&r_tc)rr'parentr!s r"r_Cell.__init__s eT#F+r$ch[U[U55(dgURURL$)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 isinstancetyperrothers r"__eq__ _Cell.__eq__s+ %d,,xx599$$r$ch[U[U55(dgURURL$)NTrrs r"__ne__ _Cell.__ne__s)%d,,xxuyy((r$cbURR5n[R"U5$)zc|FillFormat| instance for this cell. Provides access to fill properties such as foreground color. )rget_or_add_tcPrrfrom_fill_parent)rtcPrs r"fill _Cell.fills' xx'')**400r$c.URR$)z=True if this cell is the top-left grid cell in a merged cell.)ris_merge_originr.s r"r_Cell.is_merge_originsxx'''r$c.URR$)a;True 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"r_Cell.is_spannedsxx"""r$c.URR$)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_left_Cell.margin_leftsxx}}r$cFURU5 XRlgr)_validate_margin_valuerr)rrs r"rrs ##K0# r$c.URR$)zRight margin of cell.)rmarRr.s r" margin_right_Cell.margin_rightxx}}r$cFURU5 XRlgr)rrr)rrs r"rrs ##L1$ r$c.URR$)zTop margin of cell.)rmarTr.s r" margin_top_Cell.margin_toprr$cFURU5 XRlgr)rrr)rrs r"rrs ##J/" r$c.URR$)zBottom margin of cell.)rmarBr.s r" margin_bottom_Cell.margin_bottomrr$cFURU5 XRlgr)rrr)rrs r"rrs ##M2% r$c[URUR5nUR(d [S5eUR(a [S5eUR 5 UR up4UR5H nX5lM UR5H nXEl M UR5H nSUl M UR5H nSUlM g)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)r other_celltc_range row_count col_countr's r"merge _Cell.merges488Z^^4%%>? ?  ( (FG G'')'22 ++-B"J.,,.B#K/335BBI6224BBI5r$c.URR$)a>int 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_height_Cell.span_height"sxxr$c.URR$)aAint 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_width_Cell.span_width-sxx   r$cUR(d [S5e[R"UR5nUR 5HnS=UlUlS=UlUl M! g)a0Remove 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_originrrQrrrr)rrr's r"split _Cell.split8s\##`a a,,TXX6##%B'( (BJ$) )BI &r$c.URR$)akTextual 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"r _Cell.textJs###r$c$XRlgrr)rrs r"rrZs #r$cLURR5n[X5$)z9|TextFrame| containing the text that appears in the cell.)rget_or_add_txBodyr )rtxBodys r"r_Cell.text_frame^s!++-&&r$c.URR$)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_anchor_Cell.vertical_anchordsxxr$c$XRlgrr)rmso_anchor_idxs r"rrqs (r$cT[U[5(dUbSn[X-5egg)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) margin_valuetmpls r"r_Cell._validate_margin_valueus2,,,1ICDD/0 02J,r$)r)r'rrr)robjectr|r~)r|rr}r|r)r Length | None)rr)rr)rr)rr&r|rr|r{r)r|str)rr)r|r )r|MSO_VERTICAL_ANCHOR | None)rr)rrr|r)rrrrrrrrr rrrrrrrrrrrrrrrr staticmethodrrrrs@r"r&r&s%) 11(( # #$$%%##&&<  !!*$ $ $ [[$$''   ))11r$r&cl^\rSrSrSrSU4Sjjr\SSj5r\RS Sj5rSr U=r $) _Columni}z Table columncD>[[U] U5 X lXlgr)rrr_parent_gridCol)rgridColrr!s r"r_Column.__init__s gt%f-  r$c.URR$)zWidth of column in EMU.)rwr.s r"rj _Column.widths}}r$cXXRlURR5 gr)rrrrm)rrjs r"rjrs  ))+r$)rr)rrrr-r)rjr) rrrrrrrrjrrrrs@r"rr}s7  \\,,r$rc|^\rSrSrSrSU4Sjjr\S5r\S Sj5r\RS Sj5rSr U=r $) _Rowiz Table rowcD>[[U] U5 X lXlgr)rrrr_trrtrrr!s r"r _Row.__init__s dD"6* r$c.[URU5$)zRead-only reference to collection of cells in row. An individual cell is referenced using list notation, e.g. `cell = row.cells[0]`. )_CellCollectionr r.s r"cells _Row.cellss txx..r$c.URR$)zHeight of row in EMU.)r hr.s r"rc _Row.heightsxxzzr$cXXRlURR5 gr)r rrrf)rrcs r"rcrs  **,r$rr )r rrrsr)rcr) rrrrrrrrrcrrrrs@r"rrsK // ]]--r$rcN^\rSrSrSrSU4SjjrS SjrS SjrS SjrSr U=r $) riz Horizontal sequence of row cellscD>[[U] U5 X lXlgr)rrrrr r s r"r_CellCollection.__init__s ot-f5 r$cUS:d#U[URR5:aSU-n[U5e[ URRUU5$)z+Provides indexed access, (e.g. 'cells[0]').rzcell index [%d] out of range)lenr tc_lst IndexErrorr&ridxmsgs r" __getitem___CellCollection.__getitem__sK 7cS11036CS/ !TXX__S)400r$cD^U4SjTRR5$)zProvides iterability.c3<># UHn[UT5v M g7frrKrLs r"rN+_CellCollection.__iter__..s:/Bb$/rP)r rr.s`r"__iter___CellCollection.__iter__s:$((//::r$c@[URR5$)z1Supports len() function (e.g. 'len(cells) == 1').)rr rr.s r"__len___CellCollection.__len__s488??##r$r)r rrr)rr{r|r&rr) rrrrrrr r%r(rrrs@r"rrs* 1;$$r$rcF^\rSrSrSrSU4SjjrS SjrSrSrSr U=r $) r-izSequence of table columns.cD>[[U] U5 X lXlgr)rr-rrrrrrr!s r"r_ColumnCollection.__init__s /7  r$cUS:d-U[URRR5:aSU-n[ U5e[ URRRUU5$)z-Provides indexed access, (e.g. 'columns[0]').rzcolumn index [%d] out of range)rrtblGrid gridCol_lstrrrs r"r _ColumnCollection.__getitem__s[ 7cS!2!2!>!>??2S8CS/ !tyy((44S94@@r$cT[URRR5$)z3Supports len() function (e.g. 'len(columns) == 1').)rrr/r0r.s r"r(_ColumnCollection.__len__s499$$0011r$c8URR5 g)z@Called by a column when its width changes. Pass along to parent.N)rrmr.s r"rm&_ColumnCollection.notify_width_changeds ))+r$rrrr rr)rr{) rrrrrrr r(rmrrrs@r"r-r-s $ A2,,r$r-cF^\rSrSrSrSU4SjjrS SjrSrSrSr U=r $) rsizSequence of table rowscD>[[U] U5 X lXlgr)rrsrrrr,s r"r_RowCollection.__init__s nd,V4  r$cUS:dU[U5:aSU-n[U5e[URRUU5$)z*Provides indexed access, (e.g. 'rows[0]').rzrow index [%d] out of range)rrrrtr_lstrs r"r _RowCollection.__getitem__sD 7cSY&/#5CS/ !DII$$S)400r$c@[URR5$)z0Supports len() function (e.g. 'len(rows) == 1').)rrr<r.s r"r(_RowCollection.__len__s499##$$r$c8URR5 g)z>Called by a row when its height changes. Pass along to parent.N)rrfr.s r"rf$_RowCollection.notify_height_changeds **,r$r6r7)rr{r|r) rrrrrrr r(rfrrrs@r"rsrss  1%--r$rsN)&r __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-rsr$r"rNs3"*$# $'2PP.1' O"FO"dR1HR1j,h,&-8-6$h$0,,0-X-r$