liLBVdZddlmZddlmZmZddlmZddlm 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%y)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)LengthceZdZdZdfd ZddZeddZeddZ e jddZ eddZ e jddZ edd Z e jdd Z dd Z edd Zejdd ZeddZejddZddZddZeddZedZeddZejddZxZS)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 H/var/www/html/eduruby.in/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 r!cellz Table.cell"s TYY\\'73T::r"c.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 r!columnsz Table.columns*s!D11r"c.|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_col3yy!!!r"c&||j_yrr.rvalues r!r0zTable.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@r1r"c&||j_yrr7r3s r!r9zTable.first_rowIr5r"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_bandingMyy   r"c&||j_yrr<r3s r!r>zTable.horz_bandingV! r"cJfdjjDS)zGenerate _Cell object for each cell in this table. Each grid cell is generated in left-to-right, top-to-bottom order. c36K|]}t|ywrr$.0r%rs r! z#Table.iter_cells.._s?Bb$?)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_colar?r"c&||j_yrrLr3s r!rNzTable.last_coljrAr"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 yy   r"c&||j_yrrQr3s r!rSzTable.last_rowvrAr"ctt|jDcgc]}|jc}}||j_ycc}w)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_changedzTable.notify_height_changedzs; s$))#D3CJJ#DEF%5"$EA ctt|jDcgc]}|jc}}||j_ycc}w)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 rVr,widthr)rcolnew_table_widths r!notify_width_changedzTable.notify_width_changeds: c "E399"EFG$3!#Fr\c.|jjS)z'The package part containing this table.)rpartr+s r!rcz 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!rWz Table.rowssdii..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_bandingr?r"c&||j_yrrgr3s r!rizTable.vert_bandingrAr")rr rr)r&intr'rkreturnr$)rlr*rlbool)r4rnrlzIterator[_Cell]rlNone)rlr)__name__ __module__ __qualname____doc__rr(r r,propertyr0setterr9r>rJrNrSr[rarcrWri __classcell__r s@r!rrsn , ;22""##""##!!""@!!__""!!__""64((//!!""r"rceZdZdZdfd ZddZddZeddZe ddZ e ddZ e ddZ e jdd Z e dd Zejd d Ze dd Zejd!d Ze ddZejd"dZd#dZe d$dZe d$dZd%dZe d&dZejd'dZe d(dZe d)dZejd*dZed+dZxZS),r$z Table cellc:tt| |||_yr)rr$r_tc)rr%parentr s r!rz_Cell.__init__s eT#F+r"c^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 isinstancetyper|rothers r!__eq__z _Cell.__eq__s( %d,xx599$$r"c^t|t|sy|j|juS)NTrrs r!__ne__z _Cell.__ne__s&%d,xxuyy((r"c`|jj}tj|S)zs|FillFormat| instance for this cell. Provides access to fill properties such as foreground color. )r|get_or_add_tcPrrfrom_fill_parent)rtcPrs r!fillz _Cell.fills' xx'')**400r"c.|jjS)z=True if this cell is the top-left grid cell in a merged cell.)r|is_merge_originr+s r!rz_Cell.is_merge_originsxx'''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_spannedsxx"""r"c.|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. )r|marLr+s r! margin_leftz_Cell.margin_leftsxx}}r"cH|j|||j_yr)_validate_margin_valuer|r)rrs r!rz_Cell.margin_lefts ##K0# r"c.|jjS)zRight margin of cell.)r|marRr+s r! margin_rightz_Cell.margin_rightxx}}r"cH|j|||j_yr)rr|r)rrs r!rz_Cell.margin_rights ##L1$ r"c.|jjS)zTop margin of cell.)r|marTr+s r! margin_topz_Cell.margin_toprr"cH|j|||j_yr)rr|r)rrs r!rz_Cell.margin_tops ##J/" r"c.|jjS)zBottom margin of cell.)r|marBr+s r! margin_bottomz_Cell.margin_bottomrr"cH|j|||j_yr)rr|r)rrs r!rz_Cell.margin_bottoms ##M2% r"ct|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)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!mergez _Cell.merges488Z^^4%%>? ?  ( (FG G'')'22 9++- #B"BJ #,,. $B#BK $335 BBI 224 BBI 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`. )r|rr+s r! span_heightz_Cell.span_height"sxxr"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`. )r|rr+s r! span_widthz_Cell.span_width-sxx   r"c|js tdtj|j}|j D]}dx|_|_dx|_|_ y)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_originr|rIrrrr)rrr%s r!splitz _Cell.split8sa##`a a,,TXX6##% *B'( (BJ$) )BI  *r"c.|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"c&||j_yrr)rrs r!rz _Cell.textZs#r"cN|jj}t||S)z9|TextFrame| containing the text that appears in the cell.)r|get_or_add_txBodyr )rtxBodys r!rz_Cell.text_frame^s#++-&&r"c.|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. r|anchorr+s r!vertical_anchorz_Cell.vertical_anchordsxxr"c&||j_yrr)rmso_anchor_idxs r!rz_Cell.vertical_anchorqs (r"cJt|ts|d}t||zyy)zMRaise ValueError if `margin_value` is not a positive integer value or |None|.Nz.margin value must be integer or None, got '%s')rrk TypeError) margin_valuetmpls r!rz_Cell._validate_margin_valueus1,,1ICDD</0 02J,r")r%rr}r)robjectrlrn)rlrrmrlr)r Length | None)rr)rr)rr)rr$rlrqrlrkrp)rlstr)rr)rlr )rlMSO_VERTICAL_ANCHOR | None)rr)rrrlrq)rrrsrtrurrrr rrvrrrrwrrrrrrrrrr staticmethodrrxrys@r!r$r$s%) 11(( # #$$%%##&&<  !!*$ $ $ [[$$''   ))11r"r$c\eZdZdZdfd ZeddZejddZxZS)_Columnz Table columncHtt| |||_||_yr)rrr_parent_gridCol)rgridColr}r s r!rz_Column.__init__s  gt%f-  r"c.|jjS)zWidth of column in EMU.)rwr+s r!r^z _Column.widths}}r"cZ||j_|jjyr)rrrra)rr^s r!r^z _Column.widths  ))+r")rrr}r*r)r^r) rrrsrtrurrvr^rwrxrys@r!rr}s7  \\,,r"rcleZdZdZdfd ZedZeddZejddZxZ S) _Rowz Table rowcHtt| |||_||_yr)rrrr_trrtrr}r s r!rz _Row.__init__s  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 txx..r"c.|jjS)zHeight of row in EMU.)rhr+s r!rXz _Row.heightsxxzzr"cZ||j_|jjyr)rrrr[)rrXs r!rXz _Row.heights  **,r")rrr}rer)rXr) rrrsrtrurrvrrXrwrxrys@r!rrsK // ]]--r"rc<eZdZdZdfd ZddZddZd dZxZS) rz Horizontal sequence of row cellscHtt| |||_||_yr)rrrrrrs r!rz_CellCollection.__init__s  ot-f5 r"c|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 IndexErrorr$ridxmsgs r! __getitem__z_CellCollection.__getitem__sK 7cS11036CS/ !TXX__S)400r"cBfdjjDS)zProvides iterability.c36K|]}t|ywrrDrEs r!rGz+_CellCollection.__iter__..s:Bb$:rH)rrr+s`r!__iter__z_CellCollection.__iter__s:$((//::r"c@t|jjS)z1Supports len() function (e.g. 'len(cells) == 1').)rrrr+s r!__len__z_CellCollection.__len__s488??##r")rrr}r)rrkrlr$ror) rrrsrtrurrrrrxrys@r!rrs* 1;$r"rc8eZdZdZdfd ZddZdZdZxZS)r*zSequence of table columns.cHtt| |||_||_yr)rr*rrrrrr}r s r!rz_ColumnCollection.__init__s! /7  r"c|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 r!rz_ColumnCollection.__getitem__s[ 7cS!2!2!>!>??2S8CS/ !tyy((44S94@@r"cTt|jjjS)z3Supports len() function (e.g. 'len(columns) == 1').)rrrrr+s r!rz_ColumnCollection.__len__s499$$0011r"c8|jjy)z@Called by a column when its width changes. Pass along to parent.N)rrar+s r!raz&_ColumnCollection.notify_width_changeds ))+r"rr r}r)rrk) rrrsrtrurrrrarxrys@r!r*r*s$ A2,r"r*c8eZdZdZdfd ZddZdZdZxZS)rezSequence of table rowscHtt| |||_||_yr)rrerrrrs r!rz_RowCollection.__init__s  nd,V4  r"c|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 r!rz_RowCollection.__getitem__sD 7cSY&/#5CS/ !DII$$S)400r"c@t|jjS)z0Supports len() function (e.g. 'len(rows) == 1').)rrrr+s r!rz_RowCollection.__len__s499##$$r"c8|jjy)z>Called by a row when its height changes. Pass along to parent.N)rr[r+s r!r[z$_RowCollection.notify_height_changeds **,r"r)rrkrlr) rrrsrtrurrrr[rxrys@r!reres  1%-r"reN)&ru __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*rer"r!rs3"*$# $'2PP.1' O"FO"dR1HR1j,h,&-8-6$h$0,,0-X-r"