Pqh70dZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZmZer"ddlmZdd lmZmZdd lmZmZdd lmZdd lmZGd deZGdde ZGddeZ GddeZ!GddeZ"GddeZ#y)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) _TableStyleceZdZdZdfd ZddZdZeddZejddZeddZ e jddZ dd Z dd Z e d Zdd Ze dd Zed dZejd!dZedZed"dZejd#dZed$dZedZed%dZxZS)&Tablez7Proxy class for a WordprocessingML ```` element.cHtt| ||x|_|_yN)superr__init___element_tblselftblparent __class__s K/srv/www/ollama/chat-ollama/venv/lib/python3.12/site-packages/docx/table.pyrzTable.__init__s  eT#F+$''  c|jj}|j}||_|jjD]}|j }||_t||S)zIReturn a |_Column| object of `width`, newly added rightmost to the table.)rtblGrid add_gridColwtr_lstadd_tcwidth_Column)rr*r%gridColtrtcs r" add_columnzTable.add_columns`))##%%' ))"" BBBH w%%r#c|j}|j}|jjD]#}|j }|j |_%t||S)z?Return a |_Row| instance, newly added bottom-most to the table.)radd_trr% gridCol_lstr)r'r*_Row)rrr-r,r.s r"add_rowz Table.add_row%sSii ZZ\{{.. !GByyBH !B~r#c.|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 alignmentrs r"r8zTable.alignment.s{{$$$r#c&||j_yrr6rvalues r"r8zTable.alignment8s % r#c.|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. r7autofitr9s r"r?z Table.autofit<s{{"""r#c&||j_yrr>r;s r"r?z Table.autofitFs# r#cD|||jzz}|j|S)zb|_Cell| at `row_idx`, `col_idx` intersection. (0, 0) is the top, left-most cell.  _column_count_cells)rrow_idxcol_idxcell_idxs r"cellz Table.cellJs( g(:(::;{{8$$r#c|j}t|t||j}|Dcgc]}|| c}Scc}w)z>Sequence of cells in the column at `column_idx` in this table.)rDrangelenrC)r column_idxcellsidxsidxs r" column_cellszTable.column_cellsRs; ZUT-?-?@&*+sc +++s Ac.t|j|S)zG|_Columns| instance representing the sequence of columns in this table.)_Columnsrr9s r"columnsz Table.columnsXs 4((r#cL|j}||z}||z}|j||S)z8Sequence of cells in the row at `row_idx` in this table.rB)rrE column_countstartends r" row_cellszTable.row_cells]s2)) ,&l"{{5%%r#c.t|j|S)z?|_Rows| instance containing the sequence of rows in this table.)_Rowsrr9s r"rowsz Table.rowsdsTYY%%r#c|jj}|jj|tj S)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)rstyle_ids r"stylez Table.styleis099))yy""8]-@-@AAr#cz|jj|tj}||j_yr)r^ get_style_idr r`rr])r style_or_nameras r"rbz Table.styleys*99))-9L9LM!) 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. r9s r"tablez Table.table~s  r#c.|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_valr9s r"table_directionzTable.table_directions}}+++r#c&||j_yrrjr;s r"rlzTable.table_directions', $r#cd|j}g}|jjD]}t|jD]j}|j t jk(r|j|| 6|dkDr|j|dP|jt||l|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) rCriter_tcsrJ grid_spanvMerger CONTINUEappend_Cell)r col_countrMr. grid_span_idxs r"rDz Table._cellss&& ))$$& 2B!&r||!4 2 99 1 11LL z!23"Q&LLr+LLr41  2 2 r#c.|jjS)z)The number of grid columns in this table.)rrvr9s r"rCzTable._column_countsyy"""r#c.|jjSr)rtblPrr9s r"r7z Table._tblPrsyyr#)rrr z t.StoryChild)r*r)returnWD_TABLE_ALIGNMENT | None)r<r|)r{bool)r<r})rEintrFr~r{ru)rLr~r{ List[_Cell])rEr~r{r)r{rZ)r{_TableStyle | None)rer)r{WD_TABLE_DIRECTION | None)r<r)r{r)r{r)__name__ __module__ __qualname____doc__rr/r4propertyr8setterr?rHrPr rSrXr[rbrhrlrDrCr7 __classcell__r!s@r"rrsRA(&%%&&## ^^$$%, ))&&& B B \\**,,--$##r#rceZdZdZfdZdfd ZfdZdZefdZ efdZ eddZ e jd Z ed Z e jd Z ed Zejd ZxZS)ruz Table cell.cJtt| |||x|_|_yr)rrur_tcr)rr.r r!s r"rz_Cell.__init__s" eT#B/#%%4=r#c,tt| ||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. )rru add_paragraph)rtextrbr!s r"rz_Cell.add_paragraphsUD/e<z_Cell.text..s9A9s)joinrr9s r"rz _Cell.textsyy9999r#c|j}|j|j}|j}||_y)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.rrs r"rz _Cell.texts6XX  HHJ GGIr#cL|jj}|y|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)rrs r"vertical_alignmentz_Cell.vertical_alignments%}}!! <r#cF|jj}||_yr)rget_or_add_tcPrr)rr<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*r9s r"r*z _Cell.widthsxx~~r#c&||j_yrrr;s r"r*z _Cell.widths r#)N)r{str)rrrrrrrrrrrrrrr*rrs@r"rurus& = .--)):: [[       \\r#ruceZdZdZfdZedZedZedZejdZedZ xZ S)r+z Table column.c:tt| |||_yr)rr+r_gridCol)rr,r r!s r"rz_Column.__init__"s gt%f- r#c^t|jj|jS)zDSequence of |_Cell| instances corresponding to cells in this column.)tuplerhrP_indexr9s r"rMz _Column.cells&s"TZZ,,T[[9::r#c.|jjS)z7Reference to the |Table| object this column belongs to.rrhr9s r"rhz _Column.table+||!!!r#c.|jjS)zGThe width of this column in EMU, or |None| if no explicit width is set.rr'r9s r"r*z _Column.width0s}}r#c&||j_yrrr;s r"r*z _Column.width5s  r#c.|jjS)z6Index of this column in its table, starting from zero.)r gridCol_idxr9s r"rz_Column._index9s}}(((r#) rrrrrrrMrhr*rrrrs@r"r+r+ss ;;"" \\  ))r#r+cTeZdZdZfdZdZdZdZedZ edZ xZ S)rRzSequence of |_Column| instances corresponding to the columns in a table. Supports ``len()``, iteration and indexed access. c:tt| |||_yr)rrRrrrs r"rz_Columns.__init__Es h&v. r#ct |j|}t||S#t$rd|z}t|wxYw)z*Provide indexed access, e.g. 'columns[0]'.z!column index [%d] is out of range) _gridCol_lst IndexErrorr+)rrOr,msgs r" __getitem__z_Columns.__getitem__IsK "'',Gw%% "5;CS/ ! "s7c#JK|jD]}t||ywr)rr+)rr,s r"__iter__z_Columns.__iter__Rs((( )G'4( ( )s!#c,t|jSr)rKrr9s r"__len__z_Columns.__len__Vs4$$%%r#c.|jjS)zBReference to the |Table| object this column collection belongs to.rr9s r"rhz_Columns.tableYrr#cF|jj}|jS)zfSequence containing ```` elements for this table, each representing a table column.)rr%r2)rr%s r"rz_Columns._gridCol_lst^s))##"""r#) rrrrrrrrrrhrrrs@r"rRrR?sD &)&""##r#rRceZdZdZfdZed dZedZejdZedZ e jdZ edZ ed Z xZ S) r3z Table row.cHtt| ||x|_|_yr)rr3r_trr)rr-r r!s r"rz _Row.__init__is  dD"6*#%%4=r#c^t|jj|jS)zASequence of |_Cell| instances corresponding to cells in this row.)rrhrXrr9s r"rMz _Row.cellsms"TZZ))$++677r#c.|jjS)znReturn a |Length| object representing the height of this cell, or |None| if no explicit height is set.r trHeight_valr9s r"heightz _Row.heightrsxx$$$r#c&||j_yrrr;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_hRuler9s r" height_rulez_Row.height_rule|sxx&&&r#c&||j_yrrr;s r"rz_Row.height_rules"'r#c.|jjS)z4Reference to the |Table| object this row belongs to.rr9s r"rhz _Row.tablerr#c.|jjS)z3Index of this row in its table, starting from zero.)rtr_idxr9s r"rz _Row._indexsxxr#)r{z Tuple[_Cell]) rrrrrrrMrrrrhrrrs@r"r3r3fs&88%%  ]]&&'' ((""r#r3cjeZdZdZfdZed dZed dZd dZdZdZe dZ xZ S) rZzSequence of |_Row| objects corresponding to the rows in a table. Supports ``len()``, iteration, indexed access, and slicing. c:tt| |||_yr)rrZrrrs r"rz_Rows.__init__s eT#F+ r#cyrrgrrOs r"rz_Rows.__getitem__ r#cyrrgrs r"rz_Rows.__getitem__rr#ct||S)z7Provide indexed access, (e.g. `rows[0]` or `rows[1:3]`))listrs r"rz_Rows.__getitem__sDz#r#cBfdjjDS)Nc36K|]}t|ywr)r3)rr-rs r"rz!_Rows.__iter__..s:2R:s)rr(r9s`r"rz_Rows.__iter__s:)9)9::r#c@t|jjSr)rKrr(r9s r"rz _Rows.__len__s499##$$r#c.|jjS)z?Reference to the |Table| object this row collection belongs to.rr9s r"rhz _Rows.tablerr#)rOr~r{r3)rOslicer{z List[_Row])rOz int | slicer{z_Row | List[_Row]) rrrrrrrrrrrhrrs@r"rZrZsX     ;%""r#rZN)$r __future__rtypingrrrr docx.blkcntnrrdocx.enum.styler docx.oxml.simpletypesr docx.sharedr r r docxrtdocx.enum.tablerrdocx.oxml.tablerrrdocx.styles.stylerrrur+rRr3rZrgr#r"rs3"77,)*66F0"-[H[|j jZ)h)@$#x$#N(8(V"H"r#