o Xx[17@sdZddlmZmZmZddlmZddlmZddl m Z ddl m Z m Z mZGdd d eZGd d d eZGd d d eZGdddeZGdddeZGdddeZdS)z/ The |Table| object and related proxy classes. )absolute_importprint_functionunicode_literals)BlockItemContainer) WD_STYLE_TYPE)ST_Merge)Inches lazypropertyParentedcseZdZdZfddZddZddZedd Zej d d Zed d Z e j d d Z ddZ ddZ e ddZddZe ddZeddZej ddZeddZeddZej ddZed d!Zed"d#Zed$d%ZZS)&TablezA Proxy class for a WordprocessingML ```` element. c tt||||_|_dSN)superr __init___element_tblselftblparent __class__:D:\Projects\ConvertPro\env\Lib\site-packages\docx\table.pyrzTable.__init__cCs<|jj}|}||_|jjD] }|}||_qt||S)zc Return a |_Column| object of *width*, newly added rightmost to the table. )rtblGridZ add_gridColwtr_lstadd_tcwidth_Column)rr rgridColtrtcrrr add_columns  zTable.add_columncCs6|j}|}|jjD] }|}|j|_q t||S)zQ Return a |_Row| instance, newly added bottom-most to the table. )rZadd_trr gridCol_lstrrr _Row)rrr#r"r$rrradd_row$s    z Table.add_rowcC|jjS)a  Read/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 alignmentrrrrr,/zTable.alignmentcC ||j_dSrr*rvaluerrrr,9 cCr))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-rrrr4=r.z Table.autofitcCr/rr3r0rrrr4Gr2cCs|||j}|j|S)z Return |_Cell| instance correponding to table cell at *row_idx*, *col_idx* intersection, where (0, 0) is the top, left-most cell.  _column_count_cells)rrow_idxZcol_idxZcell_idxrrrcellKs z Table.cellcs*|jt|t|j}fdd|DS)zP Sequence of cells in the column at *column_idx* in this table. csg|]}|qSrr).0idxcellsrr Ysz&Table.column_cells..)r7rangelenr6)rZ column_idxidxsrr<r column_cellsSszTable.column_cellscC t|j|S)za |_Columns| instance representing the sequence of columns in this table. )_Columnsrr-rrrcolumns[s z Table.columnscCs$|j}||}||}|j||S)zJ Sequence of cells in the row at *row_idx* in this table. r5)rr8Z column_countstartendrrr row_cellscszTable.row_cellscCrC)zQ |_Rows| instance containing the sequence of rows in this table. )_Rowsrr-rrrrowsl z Table.rowscCs|jj}|j|tjS)a~ Read/write. A |_TableStyle| object representing the style applied to this table. 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_valpartZ get_stylerTABLE)rstyle_idrrrstyless z Table.stylecCs|j|tj}||j_dSr)rMZ get_style_idrrNrrL)rZ style_or_namerOrrrrPs cCs|S)a" Provide 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. rr-rrrtablesz Table.tablecCr))z A member of :ref:`WdTableDirection` indicating the direction in which the table cells are ordered, e.g. `WD_TABLE_DIRECTION.LTR`. |None| indicates the value is inherited from the style hierarchy. rZbidiVisual_valr-rrrtable_directionzTable.table_directioncCr/rrRr0rrrrSr2cCst|j}g}|jD]-}t|jD]%}|jtjkr"||| q|dkr.||dq|t ||qq |S)z A 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) r6rZiter_tcsr?Z grid_spanZvMergerZCONTINUEappend_Cell)r col_countr=r$Z grid_span_idxrrrr7s z Table._cellscCr))z; The number of grid columns in this table. )rrXr-rrrr6zTable._column_countcCr)r)rZtblPrr-rrrr+sz Table._tblPr)__name__ __module__ __qualname____doc__rr%r(propertyr,setterr4r9rBr rErHrJrPrQrSr7r6r+ __classcell__rrrrr sH               r cseZdZdZfddZdfdd Zfdd Zd d Zefd d Z efddZ eddZ e j ddZ eddZ e j ddZ eddZej ddZZS)rWz Table cellcs"tt|||||_|_dSr)rrWr_tcr)rr$rrrrrsz_Cell.__init__Ncstt|||S)a Return 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. )rrW add_paragraph)rtextrPrrrrcs 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. Nr)r r rrW add_tablerc)rrJcolsr rQrrrresz_Cell.add_tablecCs$|j|j}}||}t||jS)z Return 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. )ramergerW_parent)rZ other_cellr$Ztc_2Z merged_tcrrrrgs  z _Cell.mergec tt|jS)z List 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 )rrW paragraphsr-rrrrjs z_Cell.paragraphscri)zR List of tables in the cell, in the order they appear. Read-only. )rrWtablesr-rrrrkrKz _Cell.tablescCsddd|jDS)z The 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)rd)r:prrr sz_Cell.text..)joinrjr-rrrrdsz _Cell.textcCs(|j}||}|}||_dS)z Write-only. Set entire contents of cell to the string *text*. Any existing content or revisions are replaced. N)ra clear_contentZadd_pZadd_rrd)rrdr$rmrrrrrds  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)rrrrrrvertical_alignmentsz_Cell.vertical_alignmentcCs|j}||_dSr)rZget_or_add_tcPrrs)rr1rrrrrrts  cCr))zW The width of this cell in EMU, or |None| if no explicit width is set. rar r-rrrr "rYz _Cell.widthcCr/rrur0rrrr )r2)rbN)rZr[r\r]rrcrergr^rjrkrdr_rtr r`rrrrrWs,         rWcs^eZdZdZfddZeddZeddZedd Zej d d Zed d Z Z S) r!z Table column ctt||||_dSr)rr!r_gridCol)rr"rrrrr2 z_Column.__init__cCt|j|jS)zV Sequence of |_Cell| instances corresponding to cells in this column. )tuplerQrB_indexr-rrrr=6z _Column.cellscCr))zI Reference to the |Table| object this column belongs to. rhrQr-rrrrQ=rYz _Column.tablecCr))za The width of this column in EMU, or |None| if no explicit width is set. rwrr-rrrr Dz _Column.widthcCr/rr~r0rrrr Lr2cCr))zH Index of this column in its table, starting from zero. )rwZ gridCol_idxr-rrrr{PrYz_Column._index) rZr[r\r]rr^r=rQr r_r{r`rrrrr!.s     r!csPeZdZdZfddZddZddZdd Zed d Z ed d Z Z S)rDz Sequence of |_Column| instances corresponding to the columns in a table. Supports ``len()``, iteration and indexed access. crvr)rrDrrrrrrr]rxz_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!)rr;r"msgrrr __getitem__as  z_Columns.__getitem__ccs|jD]}t||VqdSr)rr!)rr"rrr__iter__ls z_Columns.__iter__cCs t|jSr)r@rr-rrr__len__ps z_Columns.__len__cCr))zT Reference to the |Table| object this column collection belongs to. r}r-rrrrQsrYz_Columns.tablecCs|jj}|jS)zx Sequence containing ```` elements for this table, each representing a table column. )rrr&)rrrrrrzsz_Columns._gridCol_lst) rZr[r\r]rrrrr^rQrr`rrrrrDXs   rDcsxeZdZdZfddZeddZeddZejddZed d Z e jd d Z ed d Z eddZ Z S)r'z Table row cr r)rr'r_trr)rr#rrrrrrz _Row.__init__cCry)zS Sequence of |_Cell| instances corresponding to cells in this row. )rzrQrHr{r-rrrr=r|z _Row.cellscCr))z Return a |Length| object representing the height of this cell, or |None| if no explicit height is set. rZ trHeight_valr-rrrheightrz _Row.heightcCr/rrr0rrrrr2cCr))z Return the height rule of this cell as a member of the :ref:`WdRowHeightRule` enumeration, or |None| if no explicit height_rule is set. rZtrHeight_hRuler-rrr height_rulerTz_Row.height_rulecCr/rrr0rrrrr2cCr))zF Reference to the |Table| object this row belongs to. r}r-rrrrQrYz _Row.tablecCr))zE Index of this row in its table, starting from zero. )rZtr_idxr-rrrr{rYz _Row._index) rZr[r\r]rr^r=rr_rrQr{r`rrrrr's"       r'csDeZdZdZfddZddZddZdd Zed d Z Z S) rIz Sequence of |_Row| objects corresponding to the rows in a table. Supports ``len()``, iteration, indexed access, and slicing. crvr)rrIrrrrrrrrxz_Rows.__init__cCs t||S)z: Provide indexed access, (e.g. 'rows[0]') )list)rr;rrrrs z_Rows.__getitem__csfddjjDS)Nc3s|]}t|VqdSr)r')r:r#r-rrrnsz!_Rows.__iter__..)rrr-rr-rrsz_Rows.__iter__cCs t|jjSr)r@rrr-rrrrs z _Rows.__len__cCr))zQ Reference to the |Table| object this row collection belongs to. r}r-rrrrQrYz _Rows.table) rZr[r\r]rrrrr^rQr`rrrrrIs rIN)r]Z __future__rrrZblkcntnrrZ enum.stylerZoxml.simpletypesrsharedr r r r rWr!rDr'rIrrrrs   2n*,7