Word.Interfaces.TableCollectionLoadOptions interface

Contains the collection of the document's Table objects.

Remarks

[ API set: WordApi 1.3 ]

Properties

$all

Specifying $all for the LoadOptions loads all the scalar properties (e.g.: Range.address) but not the navigational properties (e.g.: Range.format.fill.color).

alignment

For EACH ITEM in the collection: Specifies the alignment of the table against the page column. The value can be 'Left', 'Centered', or 'Right'.

font

For EACH ITEM in the collection: Gets the font. Use this to get and set font name, size, color, and other properties.

headerRowCount

For EACH ITEM in the collection: Specifies the number of header rows.

horizontalAlignment

For EACH ITEM in the collection: Specifies the horizontal alignment of every cell in the table. The value can be 'Left', 'Centered', 'Right', or 'Justified'.

isUniform

For EACH ITEM in the collection: Indicates whether all of the table rows are uniform.

nestingLevel

For EACH ITEM in the collection: Gets the nesting level of the table. Top-level tables have level 1.

parentBody

For EACH ITEM in the collection: Gets the parent body of the table.

parentContentControl

For EACH ITEM in the collection: Gets the content control that contains the table. Throws an ItemNotFound error if there isn't a parent content control.

parentContentControlOrNullObject

For EACH ITEM in the collection: Gets the content control that contains the table. If there isn't a parent content control, then this method will return an object with its isNullObject property set to true. For further information, see *OrNullObject methods and properties.

parentTable

For EACH ITEM in the collection: Gets the table that contains this table. Throws an ItemNotFound error if it isn't contained in a table.

parentTableCell

For EACH ITEM in the collection: Gets the table cell that contains this table. Throws an ItemNotFound error if it isn't contained in a table cell.

parentTableCellOrNullObject

For EACH ITEM in the collection: Gets the table cell that contains this table. If it isn't contained in a table cell, then this method will return an object with its isNullObject property set to true. For further information, see *OrNullObject methods and properties.

parentTableOrNullObject

For EACH ITEM in the collection: Gets the table that contains this table. If it isn't contained in a table, then this method will return an object with its isNullObject property set to true. For further information, see *OrNullObject methods and properties.

rowCount

For EACH ITEM in the collection: Gets the number of rows in the table.

shadingColor

For EACH ITEM in the collection: Specifies the shading color. Color is specified in "#RRGGBB" format or by using the color name.

style

For EACH ITEM in the collection: Specifies the style name for the table. Use this property for custom styles and localized style names. To use the built-in styles that are portable between locales, see the "styleBuiltIn" property.

styleBandedColumns

For EACH ITEM in the collection: Specifies whether the table has banded columns.

styleBandedRows

For EACH ITEM in the collection: Specifies whether the table has banded rows.

styleBuiltIn

For EACH ITEM in the collection: Specifies the built-in style name for the table. Use this property for built-in styles that are portable between locales. To use custom styles or localized style names, see the "style" property.

styleFirstColumn

For EACH ITEM in the collection: Specifies whether the table has a first column with a special style.

styleLastColumn

For EACH ITEM in the collection: Specifies whether the table has a last column with a special style.

styleTotalRow

For EACH ITEM in the collection: Specifies whether the table has a total (last) row with a special style.

values

For EACH ITEM in the collection: Specifies the text values in the table, as a 2D JavaScript array.

verticalAlignment

For EACH ITEM in the collection: Specifies the vertical alignment of every cell in the table. The value can be 'Top', 'Center', or 'Bottom'.

width

For EACH ITEM in the collection: Specifies the width of the table in points.

Property Details

$all

Specifying $all for the LoadOptions loads all the scalar properties (e.g.: Range.address) but not the navigational properties (e.g.: Range.format.fill.color).

$all?: boolean;

Property Value

boolean

alignment

For EACH ITEM in the collection: Specifies the alignment of the table against the page column. The value can be 'Left', 'Centered', or 'Right'.

alignment?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

font

For EACH ITEM in the collection: Gets the font. Use this to get and set font name, size, color, and other properties.

font?: Word.Interfaces.FontLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.3 ]

headerRowCount

For EACH ITEM in the collection: Specifies the number of header rows.

headerRowCount?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

horizontalAlignment

For EACH ITEM in the collection: Specifies the horizontal alignment of every cell in the table. The value can be 'Left', 'Centered', 'Right', or 'Justified'.

horizontalAlignment?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

isUniform

For EACH ITEM in the collection: Indicates whether all of the table rows are uniform.

isUniform?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

nestingLevel

For EACH ITEM in the collection: Gets the nesting level of the table. Top-level tables have level 1.

nestingLevel?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

parentBody

For EACH ITEM in the collection: Gets the parent body of the table.

parentBody?: Word.Interfaces.BodyLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.3 ]

parentContentControl

For EACH ITEM in the collection: Gets the content control that contains the table. Throws an ItemNotFound error if there isn't a parent content control.

parentContentControl?: Word.Interfaces.ContentControlLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.3 ]

parentContentControlOrNullObject

For EACH ITEM in the collection: Gets the content control that contains the table. If there isn't a parent content control, then this method will return an object with its isNullObject property set to true. For further information, see *OrNullObject methods and properties.

parentContentControlOrNullObject?: Word.Interfaces.ContentControlLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.3 ]

parentTable

For EACH ITEM in the collection: Gets the table that contains this table. Throws an ItemNotFound error if it isn't contained in a table.

parentTable?: Word.Interfaces.TableLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.3 ]

parentTableCell

For EACH ITEM in the collection: Gets the table cell that contains this table. Throws an ItemNotFound error if it isn't contained in a table cell.

parentTableCell?: Word.Interfaces.TableCellLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.3 ]

parentTableCellOrNullObject

For EACH ITEM in the collection: Gets the table cell that contains this table. If it isn't contained in a table cell, then this method will return an object with its isNullObject property set to true. For further information, see *OrNullObject methods and properties.

parentTableCellOrNullObject?: Word.Interfaces.TableCellLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.3 ]

parentTableOrNullObject

For EACH ITEM in the collection: Gets the table that contains this table. If it isn't contained in a table, then this method will return an object with its isNullObject property set to true. For further information, see *OrNullObject methods and properties.

parentTableOrNullObject?: Word.Interfaces.TableLoadOptions;

Property Value

Remarks

[ API set: WordApi 1.3 ]

rowCount

For EACH ITEM in the collection: Gets the number of rows in the table.

rowCount?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

shadingColor

For EACH ITEM in the collection: Specifies the shading color. Color is specified in "#RRGGBB" format or by using the color name.

shadingColor?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

style

For EACH ITEM in the collection: Specifies the style name for the table. Use this property for custom styles and localized style names. To use the built-in styles that are portable between locales, see the "styleBuiltIn" property.

style?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

styleBandedColumns

For EACH ITEM in the collection: Specifies whether the table has banded columns.

styleBandedColumns?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

styleBandedRows

For EACH ITEM in the collection: Specifies whether the table has banded rows.

styleBandedRows?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

styleBuiltIn

For EACH ITEM in the collection: Specifies the built-in style name for the table. Use this property for built-in styles that are portable between locales. To use custom styles or localized style names, see the "style" property.

styleBuiltIn?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

styleFirstColumn

For EACH ITEM in the collection: Specifies whether the table has a first column with a special style.

styleFirstColumn?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

styleLastColumn

For EACH ITEM in the collection: Specifies whether the table has a last column with a special style.

styleLastColumn?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

styleTotalRow

For EACH ITEM in the collection: Specifies whether the table has a total (last) row with a special style.

styleTotalRow?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

values

For EACH ITEM in the collection: Specifies the text values in the table, as a 2D JavaScript array.

values?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

verticalAlignment

For EACH ITEM in the collection: Specifies the vertical alignment of every cell in the table. The value can be 'Top', 'Center', or 'Bottom'.

verticalAlignment?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]

width

For EACH ITEM in the collection: Specifies the width of the table in points.

width?: boolean;

Property Value

boolean

Remarks

[ API set: WordApi 1.3 ]