j7VdZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZmZer"ddlmZdd lmZmZdd lmZmZdd lmZdd lmZGd deZGdde ZGddeZ GddeZ!GddeZ"GddeZ#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) _TableStyleceZdZdZd+fd Zd,d Zd Zed-d Zej d.dZed/dZ e j d0dZ d1dZ d2dZ e dZd3dZe d4dZed5d Zej d6d"Zed#Zed7d%Zej d8d&Zed9d'Zed(Zed:d*ZxZS);Tablez7Proxy class for a WordprocessingML ```` element.tblrparent t.StoryChildcttt|||x|_|_dSN)superr__init___element_tblselfrr __class__s T/lsinfo/ai/hellotax_ai/base_platform/venv/lib/python3.11/site-packages/docx/table.pyrzTable.__init__s3 eT##F+++$''  widthrc|jj}|}||_|jjD]}|}||_t||S)zIReturn a |_Column| object of `width`, newly added rightmost to the table.)rtblGrid add_gridColwtr_lstadd_tcr%_Column)r!r%r'gridColtrtcs r# add_columnzTable.add_columns^)#%%'' )"  BBBHHw%%%r$c|j}|}|jjD]"}|}|j|_#t||S)z?Return a |_Row| instance, newly added bottom-most to the table.)radd_trr' gridCol_lstr+r)r%_Row)r!rr.r-r/s r#add_rowz Table.add_row%sPi ZZ\\{. ! !GByBHHB~~r$returnWD_TABLE_ALIGNMENT | Nonec|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 alignmentr!s r#r;zTable.alignment.s{$$r$valuec||j_dSrr9r!r=s r#r;zTable.alignment8s % r$boolc|jjS)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. r:autofitr<s r#rCz Table.autofit<s{""r$c||j_dSrrBr?s r#rCz Table.autofitFs# r$row_idxintcol_idx_Cellc6|||jzz}|j|S)zb|_Cell| at `row_idx`, `col_idx` intersection. (0, 0) is the top, left-most cell.  _column_count_cells)r!rErGcell_idxs r#cellz Table.cellJs# g(::;{8$$r$ column_idx List[_Cell]ct|jt|t|j}fd|DS)z>Sequence of cells in the column at `column_idx` in this table.c g|] }| SrS).0idxcellss r# z&Table.column_cells..Vs+++sc +++r$)rLrangelenrK)r!rOidxsrVs @r# column_cellszTable.column_cellsRs> ZUT-?@@++++d++++r$c,t|j|S)zG|_Columns| instance representing the sequence of columns in this table.)_Columnsrr<s r#columnsz Table.columnsXs 4(((r$cB|j}||z}||z}|j||S)z8Sequence of cells in the row at `row_idx` in this table.rJ)r!rE column_countstartends r# row_cellszTable.row_cells]s/) ,&l"{59%%r$_Rowsc,t|j|S)z?|_Rows| instance containing the sequence of rows in this table.)rdrr<s r#rowsz Table.rowsdsTY%%%r$_TableStyle | Nonecd|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_styler TABLE)r!style_ids r#stylez Table.styleis)9)y""8]-@AAAr$ style_or_namech|j|tj}||j_dSr)rj get_style_idr rlrri)r!rorms r#rnz Table.styleys,9))-9LMM!) r$c|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. rSr<s r#tablez Table.table~s  r$WD_TABLE_DIRECTION | Nonec|jjS)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<s r#table_directionzTable.table_directions}++r$c||j_dSrrvr?s r#rxzTable.table_directions', $$$r$cl|j}g}|jD]}t|jD]y}|jt jkr||| 4|dkr||dV|t||z|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) rKriter_tcsrX grid_spanvMerger CONTINUEappendrH)r! col_countrVr/ grid_span_idxs r#rLz Table._cellss& )$$&& 2 2B!&r|!4!4 2 2 9 111LL z!23333"Q&&LLr++++LLr41111  2 r$c|jjS)z)The number of grid columns in this table.)rrr<s r#rKzTable._column_countsy""r$rc|jjSr)rtblPrr<s r#r:z Table._tblPrs yr$)rrrr)r%r)r6r7)r=r7)r6r@)r=r@)rErFrGrFr6rH)rOrFr6rP)rErFr6rP)r6rd)r6rg)rorg)r6rt)r=rt)r6rP)r6r)__name__ __module__ __qualname____doc__rr0r5propertyr;setterrCrNr[r r^rcrfrnrsrxrLrKr: __classcell__r"s@r#rrscAA((((((&&&&%%%X%&&&&###X# ^$$$^$%%%%,,,, ))\)&&&&&&&\& B B BX B \***\*X,,,X,----X$##X#Xr$rceZdZdZfdZdfd ZfdZdZefdZ efd Z edd Z e j d Z edZ e j dZ edZej dZxZS)rHz Table cell.cvtt||||x|_|_dSr)rrHr_tcr)r!r/rr"s r#rz_Cell.__init__s5 eT##B///#%%4===r$NcVtt|||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. )rrH add_paragraph)r!textrnr"s r#rz_Cell.add_paragraphs%UD!!//e<<z_Cell.text..s$99A999999r$)joinrr<s r#rz _Cell.texts'yy99999999r$c|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)r!rr/rrs r#rz _Cell.textsBX  HHJJ GGIIr$c0|jj}|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)r!rs r#vertical_alignmentz_Cell.vertical_alignments }! <4r$cF|j}||_dSr)rget_or_add_tcPrr)r!r=rs r#rz_Cell.vertical_alignments },,..r$c|jjS)zEThe width of this cell in EMU, or |None| if no explicit width is set.rr%r<s r#r%z _Cell.widthsx~r$c||j_dSrrr?s r#r%z _Cell.widthsr$)rN)r6r)rrrrrrrrrrrrrrr%rrs@r#rHrHs}&&&&& = = = = = =     ...----X-))))X):::X: [  [   X    X \\r$rHceZdZdZfdZedZedZedZej dZedZ xZ S)r,z Table column.cftt||||_dSr)rr,r_gridCol)r!r-rr"s r#rz_Column.__init__"s, gt%%f--- r$cZt|j|jS)zDSequence of |_Cell| instances corresponding to cells in this column.)tuplersr[_indexr<s r#rVz _Column.cells&s$TZ,,T[99:::r$c|jjS)z7Reference to the |Table| object this column belongs to.rrsr<s r#rsz _Column.table+|!!r$c|jjS)zGThe width of this column in EMU, or |None| if no explicit width is set.rr)r<s r#r%z _Column.width0s}r$c||j_dSrrr?s r#r%z _Column.width5s r$c|jjS)z6Index of this column in its table, starting from zero.)r gridCol_idxr<s r#rz_Column._index9s}((r$) rrrrrrrVrsr%rrrrs@r#r,r,s     ;;X;""X"X \  \ ))X)))))r$r,c`eZdZdZfdZdZdZdZedZ edZ xZ S)r]zSequence of |_Column| instances corresponding to the columns in a table. Supports ``len()``, iteration and indexed access. cftt||||_dSr)rr]rrr s r#rz_Columns.__init__Es, h&&v... r$c |j|}n"#t$rd|z}t|wxYwt||S)z*Provide indexed access, e.g. 'columns[0]'.z!column index [%d] is out of range) _gridCol_lst IndexErrorr,)r!rUr-msgs r# __getitem__z_Columns.__getitem__IsY "',GG " " "5;CS// ! "w%%%s /c#BK|jD]}t||VdSr)rr,)r!r-s r#__iter__z_Columns.__iter__Rs;( ) )G'4(( ( ( ( ( ) )r$c*t|jSr)rYrr<s r#__len__z_Columns.__len__Vs4$%%%r$c|jjS)zBReference to the |Table| object this column collection belongs to.rr<s r#rsz_Columns.tableYrr$c(|jj}|jS)zfSequence containing ```` elements for this table, each representing a table column.)rr'r3)r!r's r#rz_Columns._gridCol_lst^s)#""r$) rrrrrrrrrrsrrrs@r#r]r]?s &&&)))&&&""X"##X#####r$r]ceZdZdZfdZed dZedZejdZedZ e jd Z ed Z ed Z xZ S) r4z Table row.cttt|||x|_|_dSr)rr4r_trr)r!r.rr"s r#rz _Row.__init__is3 dD""6***#%%4===r$r6 Tuple[_Cell]cZt|j|jS)zASequence of |_Cell| instances corresponding to cells in this row.)rrsrcrr<s r#rVz _Row.cellsms$TZ))$+66777r$c|jjS)znReturn a |Length| object representing the height of this cell, or |None| if no explicit height is set.r trHeight_valr<s r#heightz _Row.heightrsx$$r$c||j_dSrrr?s r#rz _Row.heightxs %r$c|jjS)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<s r# height_rulez_Row.height_rule|sx&&r$c||j_dSrrr?s r#rz_Row.height_rules"'r$c|jjS)z4Reference to the |Table| object this row belongs to.rr<s r#rsz _Row.tablerr$c|jjS)z3Index of this row in its table, starting from zero.)rtr_idxr<s r#rz _Row._indexsxr$)r6r) rrrrrrrVrrrrsrrrs@r#r4r4fs&&&&&888X8%%X%  ]&&]&''X' (((""X"Xr$r4c|eZdZdZfdZeddZedd Zdd ZdZdZe dZ xZ S)rdzSequence of |_Row| objects corresponding to the rows in a table. Supports ``len()``, iteration, indexed access, and slicing. cftt||||_dSr)rrdrrr s r#rz_Rows.__init__s, eT##F+++ r$rUrFr6r4cdSrrSr!rUs r#rz_Rows.__getitem__ r$slice List[_Row]cdSrrSrs r#rz_Rows.__getitem__rr$ int | slice_Row | List[_Row]c,t||S)z7Provide indexed access, (e.g. `rows[0]` or `rows[1:3]`))listrs r#rz_Rows.__getitem__sDzz#r$c4fdjjDS)Nc38K|]}t|VdSr)r4)rTr.r!s r#rz!_Rows.__iter__..s+::2R::::::r$)rr*r<s`r#rz_Rows.__iter__s"::::)9::::r$c4t|jjSr)rYrr*r<s r#rz _Rows.__len__s49#$$$r$c|jjS)z?Reference to the |Table| object this row collection belongs to.rr<s r#rsz _Rows.tablerr$)rUrFr6r4)rUrr6r)rUrr6r) rrrrrrrrrrrsrrs@r#rdrds    X    X ;;;%%%""X"""""r$rdN)$r __future__rtypingrrrr docx.blkcntnrrdocx.enum.styler docx.oxml.simpletypesr docx.sharedr r r docxrtdocx.enum.tablerrdocx.oxml.tablerrrdocx.styles.stylerrrHr,r]r4rdrSr$r#rs33""""""777777777777,,,,,,))))))******6666666666.FFFFFFFF00000000""""""------[[[[[H[[[|jjjjj jjjZ)))))h)))@$#$#$#$#$#x$#$#$#N(((((8(((V"""""H"""""r$