ApiTable
class ApiTable extends ApiTablePr
Description
Class representing a table.
Instance Methods
- GetClassType
(): table
Returns a type of the ApiTable class.
- GetRowsCount
(): number
Returns a number of rows in the current table.
- GetRow
(nPos): ApiTableRow | "null"
Returns a table row by its position in the table.
- GetCell
(nRow, nCell): ApiTableCell | "null"
Returns a cell by its position.
- MergeCells
(aCells): ApiTableCell
Merges an array of cells.
- SetStyle
(oStyle): boolean
Sets a style to the current table.
- SetTableLook
(isFirstColumn, isFirstRow, isLastColumn, isLastRow, isHorBand, isVerBand)
Specifies the conditional formatting components of the referenced table style (if one exists) which will be applied to the set of table rows with the current table-level property exceptions.
- Split
(oCell, nRow, nCol): ApiTable | "null"
Splits the cell into a given number of rows and columns.
- AddRow
(oCell, isBefore): ApiTableRow
Adds a new row to the current table.
- AddRows
(oCell, nCount, isBefore): ApiTable
Adds the new rows to the current table.
- AddColumn
(oCell, isBefore)
Adds a new column to the current table.
- AddColumns
(oCell, nCount, isBefore)
Adds the new columns to the current table.
- AddElement
(oCell, nPos, oElement)
Adds a paragraph or a table or a blockLvl content control using its position in the cell.
- RemoveRow
(oCell): boolean
Removes a table row with a specified cell.
- RemoveColumn
(oCell): boolean
Removes a table column with a specified cell.
- Copy
(): ApiTable
Creates a copy of the current table.
- Select
(): boolean
Selects the current table.
- GetRange
(Start, End): ApiRange
Returns a Range object that represents the part of the document contained in the specified table.
- SetHAlign
(sType): boolean
Sets the horizontal alignment to the table.
- SetVAlign
(sType): boolean
Sets the vertical alignment to the table.
- SetPaddings
(nLeft, nTop, nRight, nBottom): boolean
Sets the table paddings.
- SetWrappingStyle
(isFlow): boolean
Sets the table wrapping style.
- GetParentContentControl
(): ApiBlockLvlSdt | "null"
Returns a content control that contains the current table.
- InsertInContentControl
(nType): ApiTable | ApiBlockLvlSdt
Wraps the current table object with a content control.
- GetParentTable
(): ApiTable | "null"
Returns a table that contains the current table.
- GetTables
(): ApiTable[]
Returns a Tables array that represents all the tables nested within the specified table.
- GetParentTableCell
(): ApiTableCell | "null"
Returns a table cell that contains the current table.
- Delete
(): boolean
Deletes the current table.
- Clear
(): boolean
Clears the content from the table.
- Search
(sText, isMatchCase): ApiRange[]
Searches for a scope of a table object.
- SetTextPr
(oTextPr): boolean
Applies the text settings to the entire contents of the table.
- SetBackgroundColor
(r, g, b, bNone): boolean
Sets the background color to all cells in the current table.
- ToJSON
(bWriteNumberings, bWriteStyles): JSON
Converts the ApiTable object into the JSON object.
- GetPosInParent
(): Number
Returns the table position within its parent element.
- ReplaceByElement
(oElement): boolean
Replaces the current table with a new element.
- AddComment
(sText, sAuthor, sUserId): ApiComment
Adds a comment to all contents of the current table.
- AddCaption
(sAdditional, sLabel, bExludeLabel, sNumberingFormat, bBefore, nHeadingLvl, sCaptionSep): boolean
Adds a caption paragraph after (or before) the current table.
- SetStyleColBandSize
(nCount)
Specifies a number of columns which will comprise each table column band for this table style.
- SetStyleRowBandSize
(nCount)
Specifies a number of rows which will comprise each table row band for this table style.
- SetJc
(sJcType)
Specifies the alignment of the current table with respect to the text margins in the current section.
- SetShd
(sType, r, g, b, isAuto)
Specifies the shading which is applied to the extents of the current table.
- SetTableBorderTop
(sType, nSize, nSpace, r, g, b)
Sets the border which will be displayed at the top of the current table.
- SetTableBorderBottom
(sType, nSize, nSpace, r, g, b)
Sets the border which will be displayed at the bottom of the current table.
- SetTableBorderLeft
(sType, nSize, nSpace, r, g, b)
Sets the border which will be displayed on the left of the current table.
- SetTableBorderRight
(sType, nSize, nSpace, r, g, b)
Sets the border which will be displayed on the right of the current table.
- SetTableBorderInsideH
(sType, nSize, nSpace, r, g, b)
Specifies the border which will be displayed on all horizontal table cell borders which are not on the outmost edge of the parent table (all horizontal borders which are not the topmost or bottommost borders).
- SetTableBorderInsideV
(sType, nSize, nSpace, r, g, b)
Specifies the border which will be displayed on all vertical table cell borders which are not on the outmost edge of the parent table (all vertical borders which are not the leftmost or rightmost borders).
- SetTableCellMarginBottom
(nValue)
Specifies an amount of space which will be left between the bottom extent of the cell contents and the border of all table cells within the parent table (or table row).
- SetTableCellMarginLeft
(nValue)
Specifies an amount of space which will be left between the left extent of the cell contents and the left border of all table cells within the parent table (or table row).
- SetTableCellMarginRight
(nValue)
Specifies an amount of space which will be left between the right extent of the cell contents and the right border of all table cells within the parent table (or table row).
- SetTableCellMarginTop
(nValue)
Specifies an amount of space which will be left between the top extent of the cell contents and the top border of all table cells within the parent table (or table row).
- SetCellSpacing
(nValue)
Specifies the default table cell spacing (the spacing between adjacent cells and the edges of the table).
- SetTableInd
(nValue)
Specifies the indentation which will be added before the leading edge of the current table in the document (the left edge in the left-to-right table, and the right edge in the right-to-left table).
- SetWidth
(sType, nValue)
Sets the preferred width to the current table.
- SetTableLayout
(sType)
Specifies the algorithm which will be used to lay out the contents of the current table within the document.
- SetTableTitle
(sTitle)
Sets the table title (caption).
- GetTableTitle
()
Returns the table title (caption).
- SetTableDescription
(sDescr)
Sets the table description.
- GetTableDescription
()
Returns the table description.
Extends
- ApiTablePr
Class representing the table properties.