o 'f7@s dZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZmZerTddlmZdd lmZmZdd lmZmZdd lmZdd lmZGd ddeZGddde ZGdddeZ GdddeZ!GdddeZ"GdddeZ#dS)z-The |Table| object and related proxy classes.) annotations) TYPE_CHECKINGListTupleoverload)BlockItemContainer) WD_STYLE_TYPE)ST_Merge)InchesParented lazyproperty)types)WD_TABLE_ALIGNMENTWD_TABLE_DIRECTION)CT_TblCT_TblPr)Length) _TableStylecseZdZdZd;fdd ZdddZed?ddZ e j d@ddZ dAddZ dBd d!Z e d"d#ZdCd$d%Ze dDd'd(ZedEd*d+Zej dFd-d+Zed.d/ZedGd1d2Zej dHd3d2ZedId4d5Zed6d7ZedJd9d:ZZS)KTablez7Proxy class for a WordprocessingML ```` element.tblrparent t.StoryChildc tt||||_|_dSN)superr__init___element_tblselfrr __class__B/home/ubuntu/flask/venv/lib/python3.10/site-packages/docx/table.pyrzTable.__init__widthrcCs<|jj}|}||_|jjD] }|}||_qt||S)zIReturn a |_Column| object of `width`, newly added rightmost to the table.)rtblGrid add_gridColwtr_lstadd_tcr%_Column)rr%r&gridColtrtcr"r"r# add_columns  zTable.add_columncCs6|j}|}|jjD] }|}|j|_q t||S)z?Return a |_Row| instance, newly added bottom-most to the table.)radd_trr& gridCol_lstr*r(r%_Row)rrr-r,r.r"r"r#add_row%s    z Table.add_rowreturnWD_TABLE_ALIGNMENT | NonecC|jjS)aRead/write. A member of :ref:`WdRowAlignment` or None, specifying the positioning of this table between the page margins. |None| if no setting is specified, causing the effective value to be inherited from the style hierarchy. _tblPr alignmentrr"r"r#r9.zTable.alignmentvaluecC ||j_dSrr7rr<r"r"r#r98 boolcCr6)a|True| if column widths can be automatically adjusted to improve the fit of cell contents. |False| if table layout is fixed. Column widths are adjusted in either case if total column width exceeds page width. Read/write boolean. r8autofitr:r"r"r#rB<r;z Table.autofitcCr=rrAr>r"r"r#rBFr?row_idxintcol_idx_CellcCs|||j}|j|S)zb|_Cell| at `row_idx`, `col_idx` intersection. (0, 0) is the top, left-most cell.  _column_count_cells)rrCrEcell_idxr"r"r#cellJs z Table.cell column_idx List[_Cell]cs*|jt|t|j}fdd|DS)z>Sequence of cells in the column at `column_idx` in this table.csg|]}|qSr"r").0idxcellsr"r# Vsz&Table.column_cells..)rIrangelenrH)rrLidxsr"rPr# column_cellsRszTable.column_cellscC t|j|S)zG|_Columns| instance representing the sequence of columns in this table.)_Columnsrr:r"r"r#columnsX z Table.columnscCs$|j}||}||}|j||S)z8Sequence of cells in the row at `row_idx` in this table.rG)rrC column_countstartendr"r"r# row_cells]szTable.row_cells_RowscCrW)z?|_Rows| instance containing the sequence of rows in this table.)r_rr:r"r"r#rowsdrZz Table.rows_TableStyle | NonecCs|jj}|j|tjS)am|_TableStyle| object representing the style applied to this table. Read/write. The default table style for the document (often `Normal Table`) is returned if the table has no directly-applied style. Assigning |None| to this property removes any directly-applied table style causing it to inherit the default table style of the document. Note that the style name of a table style differs slightly from that displayed in the user interface; a hyphen, if it appears, must be removed. For example, `Light Shading - Accent 1` becomes `Light Shading Accent 1`. )r tblStyle_valpart get_stylerTABLE)rstyle_idr"r"r#styleis z Table.style style_or_namecCs|j|tj}||j_dSr)rc get_style_idrrerrb)rrhrfr"r"r#rgys cCs|S)aProvide child objects with reference to the |Table| object they belong to, without them having to know their direct parent is a |Table| object. This is the terminus of a series of `parent._table` calls from an arbitrary child through its ancestors. r"r:r"r"r#table~sz Table.tableWD_TABLE_DIRECTION | NonecCr6)zMember of :ref:`WdTableDirection` indicating cell-ordering direction. For example: `WD_TABLE_DIRECTION.LTR`. |None| indicates the value is inherited from the style hierarchy. rbidiVisual_valr:r"r"r#table_directionszTable.table_directioncCr=rrlr>r"r"r#rnr?cCst|j}g}|jD]-}t|jD]%}|jtjkr"||| q|dkr.||dq|t ||qq |S)zA sequence of |_Cell| objects, one for each cell of the layout grid. If the table contains a span, one or more |_Cell| object references are repeated. r) rHriter_tcsrS grid_spanvMerger CONTINUEappendrF)r col_countrQr. grid_span_idxr"r"r#rIs z Table._cellscCr6)z)The number of grid columns in this table.)rrur:r"r"r#rHzTable._column_countrcCr6r)rtblPrr:r"r"r#r8sz Table._tblPr)rrrr)r%r)r4r5)r<r5)r4r@)r<r@)rCrDrErDr4rF)rLrDr4rM)rCrDr4rM)r4r_)r4ra)rhra)r4rk)r<rk)r4rM)r4r)__name__ __module__ __qualname____doc__rr/r3propertyr9setterrBrKrVr rYr^r`rgrjrnrIrHr8 __classcell__r"r"r r#rsH                  rcseZdZdZfddZdfdd Zfdd Zd d Zefd d Z efddZ edddZ e j ddZ eddZ e j ddZ eddZej ddZZS)rFz Table cell.cs"tt|||||_|_dSr)rrFr_tcr)rr.rr r"r#rsz_Cell.__init__Ncstt|||S)aReturn a paragraph newly added to the end of the content in this cell. If present, `text` is added to the paragraph in a single run. If specified, the paragraph style `style` is applied. If `style` is not specified or is |None|, the result is as though the 'Normal' style was applied. Note that the formatting of text in a cell can be influenced by the table style. `text` can contain tab (``\t``) characters, which are converted to the appropriate XML form for a tab. `text` can also include newline (``\n``) or carriage return (``\r``) characters, each of which is converted to a line break. )rrF add_paragraph)rtextrgr r"r#rs z_Cell.add_paragraphcs8|jdur|jntd}tt||||}||S)a Return a table newly added to this cell after any existing cell content, having `rows` rows and `cols` columns. An empty paragraph is added after the table because Word requires a paragraph element as the last element in every cell. N)r%r rrF add_tabler)rr`colsr%rjr r"r#rsz_Cell.add_tablecCs$|j|j}}||}t||jS)zReturn a merged cell created by spanning the rectangular region having this cell and `other_cell` as diagonal corners. Raises |InvalidSpanError| if the cells do not define a rectangular region. )rmergerF_parent)r other_cellr.tc_2 merged_tcr"r"r#rs  z _Cell.mergec tt|jS)zList of paragraphs in the cell. A table cell is required to contain at least one block-level element and end with a paragraph. By default, a new cell contains a single paragraph. Read-only )rrF paragraphsr:r r"r#rs z_Cell.paragraphscr)zRList of tables in the cell, in the order they appear. Read-only. )rrFtablesr:r r"r#rs z _Cell.tablesr4strcCsddd|jDS)zThe entire contents of this cell as a string of text. Assigning a string to this property replaces all existing content with a single paragraph containing the assigned text in a single run.  css|]}|jVqdSr)r)rNpr"r"r# sz_Cell.text..)joinrr:r"r"r#rsz _Cell.textcCs(|j}||}|}||_dS)zWrite-only. Set entire contents of cell to the string `text`. Any existing content or revisions are replaced. N)r clear_contentadd_padd_rr)rrr.rrr"r"r#rs  cCs|jj}|dur dS|jS)aMember of :ref:`WdCellVerticalAlignment` or None. A value of |None| indicates vertical alignment for this cell is inherited. Assigning |None| causes any explicitly defined vertical alignment to be removed, restoring inheritance. N)rtcPr vAlign_val)rrr"r"r#vertical_alignmentsz_Cell.vertical_alignmentcCs|j}||_dSr)rget_or_add_tcPrr)rr<rr"r"r#rs  cCr6)zEThe width of this cell in EMU, or |None| if no explicit width is set.rr%r:r"r"r#r%rwz _Cell.widthcCr=rrr>r"r"r#r%r?)rN)r4r)ryrzr{r|rrrrr}rrrr~rr%rr"r"r r#rFs,         rFcs^eZdZdZfddZeddZeddZedd Zej d d Zed d Z Z S) r+z Table column.ctt||||_dSr)rr+r_gridCol)rr,rr r"r#r" z_Column.__init__cCt|j|jS)zDSequence of |_Cell| instances corresponding to cells in this column.)tuplerjrV_indexr:r"r"r#rQ&z _Column.cellscCr6)z7Reference to the |Table| object this column belongs to.rrjr:r"r"r#rj+rwz _Column.tablecCr6)zGThe width of this column in EMU, or |None| if no explicit width is set.rr(r:r"r"r#r%0rwz _Column.widthcCr=rrr>r"r"r#r%5r?cCr6)z6Index of this column in its table, starting from zero.)r gridCol_idxr:r"r"r#r9rwz_Column._index) ryrzr{r|rr}rQrjr%r~rrr"r"r r#r+s     r+csPeZdZdZfddZddZddZdd Zed d Z ed d Z Z S)rXzSequence of |_Column| instances corresponding to the columns in a table. Supports ``len()``, iteration and indexed access. crr)rrXrrrr r"r#rErz_Columns.__init__cCs8z|j|}Wntyd|}t|wt||S)z*Provide indexed access, e.g. 'columns[0]'.z!column index [%d] is out of range) _gridCol_lst IndexErrorr+)rrOr,msgr"r"r# __getitem__Is  z_Columns.__getitem__ccs|jD]}t||VqdSr)rr+)rr,r"r"r#__iter__Rs z_Columns.__iter__cCs t|jSr)rTrr:r"r"r#__len__Vs z_Columns.__len__cCr6)zBReference to the |Table| object this column collection belongs to.rr:r"r"r#rjYrwz_Columns.tablecCs|jj}|jS)zfSequence containing ```` elements for this table, each representing a table column.)rr&r1)rr&r"r"r#r^sz_Columns._gridCol_lst) ryrzr{r|rrrrr}rjrrr"r"r r#rX?s   rXcszeZdZdZfddZedddZedd Zejd d Zed d Z e jd d Z eddZ eddZ Z S)r2z Table row.crr)rr2r_trr)rr-rr r"r#rir$z _Row.__init__r4 Tuple[_Cell]cCr)zASequence of |_Cell| instances corresponding to cells in this row.)rrjr^rr:r"r"r#rQmrz _Row.cellscCr6)znReturn a |Length| object representing the height of this cell, or |None| if no explicit height is set.r trHeight_valr:r"r"r#heightrz _Row.heightcCr=rrr>r"r"r#rxr?cCr6)zReturn the height rule of this cell as a member of the :ref:`WdRowHeightRule` enumeration, or |None| if no explicit height_rule is set.rtrHeight_hRuler:r"r"r# height_rule|rz_Row.height_rulecCr=rrr>r"r"r#rr?cCr6)z4Reference to the |Table| object this row belongs to.rr:r"r"r#rjrwz _Row.tablecCr6)z3Index of this row in its table, starting from zero.)rtr_idxr:r"r"r#rrwz _Row._index)r4r) ryrzr{r|rr}rQrr~rrjrrr"r"r r#r2fs"       r2csbeZdZdZfddZeddd Zedd d Zddd ZddZddZe ddZ Z S)r_zSequence of |_Row| objects corresponding to the rows in a table. Supports ``len()``, iteration, indexed access, and slicing. crr)rr_rrrr r"r#rrz_Rows.__init__rOrDr4r2cCdSrr"rrOr"r"r#rz_Rows.__getitem__slice List[_Row]cCrrr"rr"r"r#rr int | slice_Row | List[_Row]cCs t||S)z7Provide indexed access, (e.g. `rows[0]` or `rows[1:3]`))listrr"r"r#rr?csfddjjDS)Nc3s|]}t|VqdSr)r2)rNr-r:r"r#rsz!_Rows.__iter__..)rr)r:r"r:r#rsz_Rows.__iter__cCs t|jjSr)rTrr)r:r"r"r#rs z _Rows.__len__cCr6)z?Reference to the |Table| object this row collection belongs to.rr:r"r"r#rjrwz _Rows.table)rOrDr4r2)rOrr4r)rOrr4r) ryrzr{r|rrrrrr}rjrr"r"r r#r_s    r_N)$r| __future__rtypingrrrr docx.blkcntnrrdocx.enum.stylerdocx.oxml.simpletypesr docx.sharedr r r docxr tdocx.enum.tablerrdocx.oxml.tablerrrdocx.styles.stylerrrFr+rXr2r_r"r"r"r#s(       m '+