Table
A table.
Go to Property Listing | Method Listing
Methods:
addEventListener, autoTag, changeGlyph, changeGrep, changeText, changeTransliterate, clearTableStyleOverrides, convertBulletsAndNumberingToText, convertToText, createOutlines, extractLabel, findGlyph, findGrep, findText, findTransliterate, getElements, insertLabel, markup, recompose, remove, removeEventListener, select, toSource, toSpecifier, unmerge
Objects:
AlternatingFillsTypes, Boolean, Buttons, Cells, Changes, CheckBoxes, Columns, ComboBoxes, DisplayOrderOptions, EPSTexts, EndnoteTextFrames, Endnotes, EventListeners, Events, Footnotes, FormFields, Graphic, GraphicLines, Groups, HeaderFooterBreakTypes, HiddenTexts, ListBoxes, MultiStateObjects, Notes, Number, Object, Ovals, PageItem, PageItems, Polygons, RadioButtons, Rectangles, Rows, SignatureFields, SpecialCharacters, SplineItems, String, StrokeOrderTypes, StrokeStyle, Swatch, TableDirectionOptions, TableStyle, TextBoxes, TextFrames, TextVariableInstances, XMLItem,
Property Listing
Property |
Type |
Access |
Description |
---|---|---|---|
readonly |
Lists all graphics contained by the Table. |
||
readonly |
Lists all page items contained by the Table. |
||
read/write |
The pattern for alternating fills. |
||
read/write |
The table style applied to the table. Can also accept: String. |
||
readonly |
The XML element associated with the Table. |
||
Number (range 1 - 10000) |
read/write |
The number of body rows. |
|
read/write |
The color, specified as a swatch (color, gradient, tint, or mixed ink), of the bottom border stroke. |
||
read/write |
The gap color, specified as a swatch (color, gradient, tint, or mixed ink), of the bottom border stroke. Note: Valid only when bottom border stroke type is not solid. |
||
read/write |
If true, the gap of the bottom border stroke will overprint. Note: Valid only when bottom border stroke type is not solid. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the gap color of the bottom border stroke. (Range: 0 to 100) Note: Valid only when bottom border stroke type is not solid. |
|
read/write |
If true, the bottom border stroke will overprint. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the bottom border stroke. (Range: 0 to 100) |
|
read/write |
The stroke type of the bottom border. Can also accept: String. |
||
read/write |
The stroke weight of the bottom border stroke. |
||
read/write |
The footer placement. |
||
read/write |
The header placement. |
||
readonly |
A collection of buttons. |
||
readonly |
A collection of table cells. |
||
readonly |
A collection of changes. |
||
readonly |
A collection of checkboxes. |
||
read/write |
If true, clips the graphic cell's content to width and height of the cell. |
||
read/write |
If true, clips the text cell's content to width and height of the cell. |
||
Number (range 1 - 200) |
read/write |
The number of columns. |
|
read/write |
If true, hides alternating row fills. If false, hides alternating column fills. |
||
readonly |
A collection of table columns. |
||
readonly |
A collection of comboboxes. |
||
Array of Strings NothingEnums NothingEnum Array of SpecialCharacters enumerators. Can also accept: Strings |
read/write |
The contents to place in cells, specified as an array whose first item populates the top left cell and whose second item populates the next cell to the right, and so on until each cell in the top row is populated, at which point the next item populates the left-most cell in the second row, and so on. Note: If the array contains fewer strings than the table contains cells, the remaining cells are left blank. Can return: Array of Strings or SpecialCharacters enumerators. Can also accept: Array of Strings, SpecialCharacters enumerators or NothingEnum enumerators. |
|
read/write |
If true, then the table will show collapsed in story and galley views. |
||
read/write |
Specifies the order the table cells will display in when viewing in story and galley views. |
||
read/write |
The fill color, specified as a swatch (color, gradient, tint, or mixed ink), of columns in the second alternating fill group. Note: Valid when alternating fills are defined for table columns. |
||
read/write |
The number of columns in the second alternating fills group. Note: Valid when alternating fills are defined for table columns. |
||
read/write |
If true, the columns in the second alternating fills group will overprint. Note: Valid when alternating fills are defined for table columns. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the columns in the second alternating fills group. (Range: 0 to 100) Note: Valid when alternating fills are defined for table columns. |
|
read/write |
The stroke type of columns in the second alternating strokes group. Can also accept: String. |
||
read/write |
The stroke color, specified as a swatch (color, gradient, tint, or mixed ink), of column borders in the second alternating column strokes group. Note: Valid when end column stroke count is 1 or greater. |
||
read/write |
The number of columns in the second alternating column strokes group. |
||
read/write |
The stroke gap color, specified as a swatch (color, gradient, tint, or mixed ink), of column borders in the second alternating column strokes group. Note: Valid when end column stroke count is 1 or greater. |
||
read/write |
If true, the gap of the column border stroke in the second alternating column strokes group will overprint. Note: Valid when end column stroke count is 1 or greater. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the gap color of column borders in the second alternating column strokes group. (Range: 0 to 100) Note: Valid when end column stroke count is 1 or greater. |
|
read/write |
If true, the column borders in the second alternating column strokes group will overprint. Note: Valid when end column stroke count is 1 or greater. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of column borders in the second alternating column strokes group. (Range: 0 to 100) Note: Valid when end column stroke count is 1 or greater. |
|
read/write |
The stroke weight of column borders in the second alternating column strokes group. Note: Valid when end column stroke count is 1 or greater. |
||
read/write |
The fill color, specified as a swatch (color, gradient, tint, or mixed ink), of rows in the second alternating fills group. Note: Valid when alternating fills are defined for table rows. |
||
read/write |
The number of rows in the second alternating fills group. Note: Valid when alternating fills are defined for table rows. |
||
read/write |
If true, the rows in the second alternating fills group will overprint. Note: Valid when alternating fills are defined for table rows. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the rows in the second alternating fills group. (Range: 0 to 100) Note: Valid when alternating fills are defined for table rows. |
|
read/write |
The stroke color, specified as a swatch (color, gradient, tint, or mixed ink), of row borders in the second alternating row strokes group. Note: Valid when end row stroke count is 1 or greater. |
||
read/write |
The number of rows in the second alternating row strokes group. |
||
read/write |
The gap color, specified as a swatch (color, gradient, tint, or mixed ink), of row borders in the second alternating rows group. Note: Valid when end row stroke count is 1 or greater. |
||
read/write |
If true, the gap of the row borders in the second alternating rows group will overprint. Note: Valid when end row stroke count is 1 or greater. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the gap color of rows in the second alternating strokes group. (Range: 0 to 100) Note: Valid when end row stroke count is 1 or greater and end row stroke type is not solid. |
|
read/write |
If true, the rows in the second alternating rows group will overprint. Note: Valid when end row stroke count is 1 or greater. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the row borders in the second alternating strokes group. (Range: 0 to 100) Note: Valid when end row stroke count is 1 or greater. |
|
read/write |
The stroke type of rows in the second alternating strokes group. Can also accept: String. |
||
read/write |
The stroke weight of row borders in the second alternating row strokes group. Note: Valid when end row stroke count is 1 or greater. |
||
readonly |
A collection of endnote text frames. |
||
readonly |
A collection of endnotes. |
||
readonly |
EPSTexts |
||
readonly |
A collection of event listeners. |
||
readonly |
A collection of events. |
||
Number (range 0 - 25) |
read/write |
The number of footer rows. |
|
readonly |
A collection of footnotes. |
||
readonly |
A collection of form fields. |
||
read/write |
The bottom inset of the graphic cell. |
||
read/write |
The left inset of the graphic cell. |
||
readonly |
A collection of graphic lines. |
||
read/write |
The right inset of the graphic cell. |
||
read/write |
The top inset of the graphic cell. |
||
readonly |
A collection of groups. |
||
Number (range 0 - 25) |
read/write |
The number of header rows. |
|
read/write |
The height of the Table. For a table or column, specifies the sum of the row heights. |
||
readonly |
A collection of hidden text objects. |
||
readonly |
The unique ID of the Table. |
||
readonly |
The index of the Table within its containing object. |
||
readonly |
Returns true if the object specifier resolves to valid objects. |
||
read/write |
A property that can be set to any string. |
||
read/write |
The color, specified as a swatch (color, gradient, tint, or mixed ink), of the left border stroke. |
||
read/write |
The gap color, specified as a swatch (color, gradient, tint, or mixed ink), of the left border stroke. Note: Valid only when left border stroke type is not solid. |
||
read/write |
If true, the gap of the left border stroke will overprint. Note: Valid only when left border stroke type is not solid. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the gap color of the left border stroke. (Range: 0 to 100) Note: Valid only when left border stroke type is not solid. |
|
read/write |
If true, the left border stroke will overprint. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the left border stroke. (Range: 0 to 100) |
|
read/write |
The stroke type of the left border. Can also accept: String. |
||
read/write |
The stroke weight of the left border stroke. |
||
readonly |
A collection of listboxes. |
||
readonly |
A collection of multi-state objects. |
||
read/write |
The name of the Table; this is an alias to the Table's label property. |
||
readonly |
A collection of notes. |
||
readonly |
A collection of ellipses. |
||
readonly |
The page items collection, which can be used to process all page items in a container (such as a document, page, or group), regardless of type. |
||
readonly |
The parent of the Table (a XMLElement, XmlStory, TextFrame, EndnoteTextFrame, Text, InsertionPoint, TextStyleRange, Paragraph, TextColumn, Line, Word, Character, Story or Cell). |
||
readonly |
A collection of polygons. |
||
read/write |
A property that allows setting of several properties at the same time. |
||
readonly |
A collection of radio buttons. |
||
readonly |
A collection of rectangles. |
||
read/write |
The color, specified as a swatch (color, gradient, tint, or mixed ink), of the right border stroke. |
||
read/write |
The gap color, specified as a swatch (color, gradient, tint, or mixed ink), of the right border stroke. Note: Valid only when right border stroke type is not solid. |
||
read/write |
If true, the gap color of the right border stroke will overprint. Note: Valid only when right border stroke type is not solid. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the gap color of the right border stroke. (Range: 0 to 100) Note: Valid only when right border stroke type is not solid. |
|
read/write |
If true, the right border stroke will overprint. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the right border stroke. (Range: 0 to 100) |
|
read/write |
The stroke type of the right border. Can also accept: String. |
||
read/write |
The stroke weight of the right border stroke. |
||
readonly |
A collection of table rows. |
||
readonly |
A collection of signature fields. |
||
read/write |
The number of columns on the left side of the table to skip before applying the column fill color. Note: Valid when alternating fills are defined for table columns. |
||
read/write |
The number of body rows at the beginning of the table to skip before applying the row fill color. Note: Valid when alternating fills are defined for table rows. |
||
read/write |
The number of columns on the left of the table in which to skip border stroke formatting. Note: Valid when start column stroke count is 1 or greater and/or end column stroke count is 1 or greater. |
||
read/write |
The number of body rows at the beginning of the table in which to skip border stroke formatting. Note: Valid when start row stroke count is 1 or greater and/or end row stroke count is 1 or greater. |
||
read/write |
If true, skips the first occurrence of header rows. |
||
read/write |
The number columns on the right side of the table in which to not apply the column fill color. Note: Valid when alternating fills are defined for table columns. |
||
read/write |
The number of body rows at the end of the table in which to not apply the row fill color. Note: Valid when alternating fills are defined for table rows. |
||
read/write |
The number of columns on the right side of the table in which to skip border stroke formatting. Note: Valid when start column stroke count is 1 or greater and/or end column stroke count is 1 or greater. |
||
read/write |
The number of body rows at the end of the table in which to skip border stroke formatting. Note: Valid when start row stroke count is 1 or greater and/or end row stroke count is 1 or greater. |
||
read/write |
If true, skips the last occurrence of footer rows. |
||
read/write |
The space below the table. |
||
read/write |
The space above the table. |
||
readonly |
The spline items collection. |
||
read/write |
The fill color, specified as a swatch (color, gradient, tint, or mixed ink), of columns in the first alternating fills group. Note: Valid when alternating fills are defined for table columns. |
||
read/write |
The number of columns in the first alternating fills group. Note: Valid when alternating fills are defined for table columns. |
||
read/write |
If true, the columns in the first alternating fills group will overprint. Note: Valid when alternating fills are defined for table columns. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the columns in the first alternating fills group. (Range: 0 to 100) Note: Valid when alternating fills are defined for table columns. |
|
read/write |
The stroke color, specified as a swatch (color, gradient, tint, or mixed ink), of column borders in the first alternating column strokes group. |
||
read/write |
The number of columns in the first alternating column strokes group. |
||
read/write |
The stroke gap color, specified as a swatch (color, gradient, tint, or mixed ink), of column borders in the first alternating column strokes group. Note: Valid when start column stroke count is 1 or greater. |
||
read/write |
If true, the gap of the column borders in the first alternating column strokes group will overprint. Note: Valid when start column stroke count is 1 or greater. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the gap color of column borders in the first alternating column strokes group. (Range: 0 to 100) Note: Valid when start column stroke count is 1 or greater. |
|
read/write |
If true, the column borders in the first alternating column strokes group will overprint. Note: Valid when start column stroke count is 1 or greater. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of column borders in the first alternating column strokes group. (Range: 0 to 100) Note: Valid when start column stroke count is 1 or greater. |
|
read/write |
The stroke type of columns in the first alternating strokes group. Can also accept: String. |
||
read/write |
The stroke weight of column borders in the first alternating column strokes group. Note: Valid when start column stroke count is 1 or greater. |
||
read/write |
The fill color, specified as a swatch (color, gradient, tint, or mixed ink), of rows in the first alternating fills group. Note: Valid when alternating fills are defined for table rows. |
||
read/write |
The number of rows in the first alternating fills group. Note: Valid when alternating fills are defined for table rows. |
||
read/write |
If true, the rows in the first alternating fills group will overprint. Note: Valid when alternating fills are defined for table rows. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the rows in the first alternating fills group. (Range: 0 to 100) Note: Valid when alternating fills are defined for table rows. |
|
read/write |
The color, specified as a swatch (color, gradient, tint, or mixed ink), of row borders in the first alternating row strokes group. Note: Valid when start row stroke count is 1 or greater. |
||
read/write |
The number of rows in the first alternating row strokes group. |
||
read/write |
The stroke gap color of row borders in the first alternating row strokes group, specified as a swatch (color, gradient, tint, or mixed ink). Note: Valid when start row stroke count is 1 or greater. |
||
read/write |
If true, the gap color of the row border stroke in the first alternating row strokes group will overprint. Note: Valid when start row stroke count is 1 or greater. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the gap color of row borders in the first alternating rows group. (Range: 0 to 100) Note: Valid when start row stroke count is 1 or greater. |
|
read/write |
If true, the row borders in the first alternating row strokes group will overprint. Note: Valid when start row stroke count is 1 or greater. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the borders in the first alternating row strokes group. (Range: 0 to 100) Note: Valid when start row stroke count is 1 or greater. |
|
read/write |
The stroke type of rows in the first alternating strokes group. Can also accept: String. |
||
read/write |
The stroke weight of row borders in the first alternating row strokes group. Note: Valid when start row stroke count is 1 or greater. |
||
readonly |
The insertion point before the table in the story containing the table. |
||
read/write |
The order in which to display row and column strokes at corners. |
||
read/write |
The direction of the the table |
||
read/write |
The bottom inset of the text cell. |
||
readonly |
A collection of text boxes. |
||
readonly |
A collection of text frames. |
||
read/write |
The left inset of the text cell. |
||
read/write |
The right inset of the text cell. |
||
read/write |
The top inset of the text cell. |
||
readonly |
A collection of text variable instances. |
||
read/write |
The color, specified as a swatch (color, gradient, tint, or mixed ink), of the table's top border stroke. |
||
read/write |
The gap color, specified as a swatch (color, gradient, tint, or mixed ink), of the table's top border stroke. Note: Valid only when top border stroke type is not solid. |
||
read/write |
If true, the gap of the top border stroke will overprint. Note: Valid only when top border stroke type is not solid. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the gap color of the table's top border stroke. (Range: 0 to 100) Note: Valid only when top border stroke type is not solid. |
|
read/write |
If true, the top border strokes will overprint. |
||
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the table's top border stroke. (Range: 0 to 100) |
|
read/write |
The stroke type of the top border. Can also accept: String. |
||
read/write |
The stroke weight of the table's top border stroke. |
||
read/write |
The width of the Table. For a table or row, specifies the sum of the column widths. |
Method Listing
EventListener addEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])
Adds an event listener.
Parameter |
Type |
Description |
---|---|---|
eventType |
The event type. |
|
handler |
JavaScriptFunction |
The event handler. Can accept: File or JavaScript Function. |
captures |
This parameter is obsolete. (Optional) (default: false) |
undefined autoTag ()
Tag the object or the parent story using default tags defined in XML preference.
Text changeGlyph (reverseOrder:Boolean)
Finds glyphs that match the find what value and replaces the glyphs with the change to value.
Parameter |
Type |
Description |
---|---|---|
reverseOrder |
If true, returns the results in reverse order. (Optional) |
Text changeGrep (reverseOrder:Boolean)
Finds text that matches the find what value and replaces the text with the change to value.
Parameter |
Type |
Description |
---|---|---|
reverseOrder |
If true, returns the results in reverse order. (Optional) |
Text changeText (reverseOrder:Boolean)
Finds text that matches the find what value and replaces the text with the change to value.
Parameter |
Type |
Description |
---|---|---|
reverseOrder |
If true, returns the results in reverse order. (Optional) |
Text changeTransliterate (reverseOrder:Boolean)
Finds text that matches the find character type value and replaces the text with the change character type value.
Parameter |
Type |
Description |
---|---|---|
reverseOrder |
If true, returns the results in reverse order. (Optional) |
undefined clearTableStyleOverrides ()
Clear Table Style Overrides
undefined convertBulletsAndNumberingToText ()
Convert bullets and numbering to text.
Text convertToText (columnSeparator:String, rowSeparator:String)
Converts the table to text.
Parameter |
Type |
Description |
---|---|---|
columnSeparator |
The character to insert between the each column's content in the converted text. Note: Can be defined as any single character, such as a letter, number, or punctuation mark, or by typing a space or tab. Use the actual character rather than its name, such as ',' rather than 'Comma'. Precede double or single quotes or a backslash with an extra backslash as an escape character. For paragraphs, use ^p. (Optional) |
|
rowSeparator |
The character to use to separate each row's content in the converted text. Note: Can be defined as any single character, such as a letter, number, or punctuation mark, or by typing a space or tab. Use the actual character rather than its name, such as , rather than Comma. Precede double or single quotes or a backslash with an extra backslash as an escape character. For paragraphs, use ^p. (Optional) |
PageItem createOutlines ([deleteOriginal:Boolean=Boolean])
Converts text to outlines. Each line of text becomes a polygon object. When the converted text is a single letter that has no internal spaces or detached parts, the polygon contains only a single path. Note: To determine whether a font allows the creation of outlines, see allow outlines.
Parameter |
Type |
Description |
---|---|---|
deleteOriginal |
If true, deletes the original text. If false, creates the outlines as separate object(s) on top of the text. (Optional) (default: true) |
String extractLabel (key:String)
Gets the label value associated with the specified key.
Parameter |
Type |
Description |
---|---|---|
key |
The key. |
Text findGlyph (reverseOrder:Boolean)
Finds glyphs that match the find what value.
Parameter |
Type |
Description |
---|---|---|
reverseOrder |
If true, returns the results in reverse order. (Optional) |
Text findGrep (reverseOrder:Boolean)
Finds text that matches the find what value.
Parameter |
Type |
Description |
---|---|---|
reverseOrder |
If true, returns the results in reverse order. (Optional) |
Text findText (reverseOrder:Boolean)
Finds text that matches the find what value.
Parameter |
Type |
Description |
---|---|---|
reverseOrder |
If true, returns the results in reverse order. (Optional) |
Text findTransliterate (reverseOrder:Boolean)
Finds text that matches the find character type value.
Parameter |
Type |
Description |
---|---|---|
reverseOrder |
If true, returns the results in reverse order. (Optional) |
Table getElements ()
Resolves the object specifier, creating an array of object references.
undefined insertLabel (key:String, value:String)
Sets the label to the value associated with the specified key.
undefined markup (using:XMLElement)
Associates the page item with the specified XML element while preserving existing content.
Parameter |
Type |
Description |
---|---|---|
using |
The XML element. |
undefined recompose ()
Recomposes the text in the Table.
undefined remove ()
Deletes the Table.
Boolean removeEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])
Removes the event listener.
Parameter |
Type |
Description |
---|---|---|
eventType |
The registered event type. |
|
handler |
JavaScriptFunction |
The registered event handler. Can accept: File or JavaScript Function. |
captures |
This parameter is obsolete. (Optional) (default: false) |
undefined select ([existingSelection:SelectionOptions=SelectionOptions])
Selects the object.
Parameter |
Type |
Description |
---|---|---|
existingSelection |
The selection status of the Table in relation to previously selected objects. (Optional) (default: SelectionOptions.REPLACE_WITH) |
String toSource ()
Generates a string which, if executed, will return the Table.
String toSpecifier ()
Retrieves the object specifier.
Cell unmerge ()
Unmerges all merged cells in the Table.
Object of
Cell.parent
Column.parent
Endnote.parent
Event.parent
EventListener.parent
MutationEvent.parent
Row.parent
XMLElement.xmlContent
Return
XMLElement.convertElementToTable()
TextStyleRange.convertToTable()