A table column.
Go to Property Listing | Method Listing
createOutlines, recompose, findText, changeText, findGrep, changeGrep, findGlyph, changeGlyph, findTransliterate, changeTransliterate, remove, merge, unmerge, split, redistribute, select, toSource, getElements, toSpecifier, addEventListener, removeEventListener
Boolean, Cells, Column, Columns, EventListeners, Events, FirstBaseline, HorizontalOrVertical, NothingEnum, Number, Object, Row, RowTypes, Rows, SpecialCharacters, StartParagraph, String, StrokeStyle, Swatch, Table, VerticalJustification,
|
Property |
Type |
Access |
Description |
|---|---|---|---|
|
autoGrow |
read/write |
If true, the height of the cell or the cells in the Column can increase or decrease automatically to fit cell content. Note: Allows cells to grow or shrink to the maximum or minimum height, if specified. |
|
|
bottomEdgeStrokeColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the bottom edge border stroke. |
|
|
bottomEdgeStrokeGapColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the gap of the bottom edge border stroke. Note: Not valid when bottom edge stroke type is solid. |
|
|
bottomEdgeStrokeGapOverprint |
read/write |
If true, the gap color of the bottom edge border stroke will overprint. Note: Not valid when bottom edge stroke type is solid. |
|
|
bottomEdgeStrokeGapTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the bottom edge border stroke gap color. (Range: 0 to 100) Note: Not valid when bottom edge stroke type is solid. |
|
bottomEdgeStrokeOverprint |
read/write |
If true, the bottom edge border stroke will overprint. |
|
|
bottomEdgeStrokeTint |
read/write |
The tint (as a percentage) of the bottom edge border stroke. |
|
|
bottomEdgeStrokeType |
read/write |
The stroke type of the bottom edge. Can also accept: String. |
|
|
bottomEdgeStrokeWeight |
read/write |
The stroke weight of the bottom edge border stroke. |
|
|
bottomInset |
read/write |
The bottom inset of the cell. |
|
|
cells |
readonly |
A collection of table cells. |
|
|
clipContentToCell |
read/write |
If true, clips the cell's content to width and height of the cell. |
|
|
columnSpan |
readonly |
The number of columns that the object spans. |
|
|
columns |
readonly |
A collection of table columns. |
|
|
contents |
NothingEnum.NOTHING SpecialCharacters.AUTO_PAGE_NUMBER SpecialCharacters.NEXT_PAGE_NUMBER SpecialCharacters.PREVIOUS_PAGE_NUMBER SpecialCharacters.SECTION_MARKER SpecialCharacters.BULLET_CHARACTER SpecialCharacters.COPYRIGHT_SYMBOL SpecialCharacters.DEGREE_SYMBOL SpecialCharacters.ELLIPSIS_CHARACTER SpecialCharacters.FORCED_LINE_BREAK SpecialCharacters.PARAGRAPH_SYMBOL SpecialCharacters.REGISTERED_TRADEMARK SpecialCharacters.SECTION_SYMBOL SpecialCharacters.TRADEMARK_SYMBOL SpecialCharacters.RIGHT_INDENT_TAB SpecialCharacters.INDENT_HERE_TAB SpecialCharacters.EM_DASH SpecialCharacters.EN_DASH SpecialCharacters.DISCRETIONARY_HYPHEN SpecialCharacters.NONBREAKING_HYPHEN SpecialCharacters.END_NESTED_STYLE SpecialCharacters.DOUBLE_LEFT_QUOTE SpecialCharacters.DOUBLE_RIGHT_QUOTE SpecialCharacters.SINGLE_LEFT_QUOTE SpecialCharacters.SINGLE_RIGHT_QUOTE SpecialCharacters.EM_SPACE SpecialCharacters.EN_SPACE SpecialCharacters.FLUSH_SPACE SpecialCharacters.HAIR_SPACE SpecialCharacters.NONBREAKING_SPACE SpecialCharacters.THIN_SPACE SpecialCharacters.FIGURE_SPACE SpecialCharacters.PUNCTUATION_SPACE SpecialCharacters.COLUMN_BREAK SpecialCharacters.FRAME_BREAK SpecialCharacters.PAGE_BREAK SpecialCharacters.ODD_PAGE_BREAK SpecialCharacters.EVEN_PAGE_BREAK SpecialCharacters.FOOTNOTE_SYMBOL SpecialCharacters.LEFT_TO_RIGHT_EMBEDDING SpecialCharacters.RIGHT_TO_LEFT_EMBEDDING SpecialCharacters.POP_DIRECTIONAL_FORMATTING SpecialCharacters.LEFT_TO_RIGHT_OVERRIDE SpecialCharacters.RIGHT_TO_LEFT_OVERRIDE SpecialCharacters.DOTTED_CIRCLE SpecialCharacters.ZERO_WIDTH_JOINER SpecialCharacters.TEXT_VARIABLE SpecialCharacters.SINGLE_STRAIGHT_QUOTE SpecialCharacters.DOUBLE_STRAIGHT_QUOTE SpecialCharacters.DISCRETIONARY_LINE_BREAK SpecialCharacters.ZERO_WIDTH_NONJOINER SpecialCharacters.THIRD_SPACE SpecialCharacters.QUARTER_SPACE SpecialCharacters.SIXTH_SPACE SpecialCharacters.FIXED_WIDTH_NONBREAKING_SPACE SpecialCharacters.HEBREW_MAQAF SpecialCharacters.HEBREW_GERESH SpecialCharacters.HEBREW_GERSHAYIM SpecialCharacters.ARABIC_KASHIDA SpecialCharacters.ARABIC_COMMA SpecialCharacters.ARABIC_SEMICOLON SpecialCharacters.ARABIC_QUESTION_MARK SpecialCharacters.LEFT_TO_RIGHT_MARK SpecialCharacters.RIGHT_TO_LEFT_MARK SpecialCharacters.HEBREW_SOF_PASUK NothingEnums NothingEnum |
read/write |
The text contents. For rows or columns, when specified as a string, the sting populates each cell in the row or column; when specified as an array, the first value in the array populates the left-most cell in the row or the top-most cell in the column; the next value populates the next cell to the right (for rows) or the next lowest cell (for columns), and so on. Can return: String, SpecialCharacters enumerator or Array of Strings or SpecialCharacters enumerators. Can also accept: NothingEnum enumerator or Array of Strings, SpecialCharacters enumerators or NothingEnum enumerators. |
|
diagonalLineInFront |
read/write |
If true, draws the diagonal line in front of cell contents. |
|
|
diagonalLineStrokeColor |
read/write |
The diagonal line color, specified as a swatch. |
|
|
diagonalLineStrokeGapColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the gap of the diagonal line stroke. Note: Not valid when diagonal line stroke type is solid. |
|
|
diagonalLineStrokeGapOverprint |
read/write |
If true, the stroke gap of the diagonal line will overprint. Note: Not valid when diagonal line stroke type is solid. |
|
|
diagonalLineStrokeGapTint |
read/write |
The tint (as a percentage) of the diagonal line stroke gap color. Note: Not valid when diagonal line stroke type is solid. |
|
|
diagonalLineStrokeOverprint |
read/write |
If true, the diagonal line stroke will overprint. |
|
|
diagonalLineStrokeTint |
Number (range 0 - 100) |
read/write |
The diagonal line tint (as a percentage). (Range: 0 to 100) |
|
diagonalLineStrokeType |
read/write |
The stroke type of the diagonal line(s). Can also accept: String. |
|
|
diagonalLineStrokeWeight |
read/write |
The diagonal line stroke weight. |
|
|
eventListeners |
readonly |
A collection of event listeners. |
|
|
events |
readonly |
A collection of events. |
|
|
fillColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the fill of the object. Can also accept: String. |
|
|
fillTint |
read/write |
The tint (as a percentage) of the fill of the object. |
|
|
firstBaselineOffset |
FirstBaseline.ASCENT_OFFSET FirstBaseline.CAP_HEIGHT FirstBaseline.LEADING_OFFSET FirstBaseline.EMBOX_HEIGHT FirstBaseline.X_HEIGHT FirstBaseline.FIXED_HEIGHT |
read/write |
The distance between the baseline of the text and the top inset of the cell. |
|
gradientFillAngle |
read/write |
The angle of a linear gradient applied to the fill of the object. (Range: -180 to 180) |
|
|
gradientFillLength |
read/write |
The length (of a linear gradient) or radius (of a radial gradient) applied to the fill of the object. |
|
|
gradientFillStart |
read/write |
The starting point (in page coordinates) of a gradient applied to the fill of the Column, in the format [x, y]. |
|
|
height |
read/write |
The height of the Column. For a table or column, specifies the sum of the row heights. |
|
|
index |
readonly |
The index of the Column within its containing object. |
|
|
innerColumnStrokeColor |
read/write |
The color, specified as a swatch, of the inner column border stroke. |
|
|
innerColumnStrokeGapColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the gap of the inner column border stroke. Note: Not valid when inner column stroke type is solid. |
|
|
innerColumnStrokeGapOverprint |
read/write |
If true, the gap color of the inner column border stroke will overprint. Note: Not valid when inner column stroke type is solid. |
|
|
innerColumnStrokeGapTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the inner column border stroke gap color. (Range: 0 to 100) Note: Not valid when inner column stroke type is solid. |
|
innerColumnStrokeOverprint |
read/write |
If true, the inner column border stroke will overprint. |
|
|
innerColumnStrokeTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the inner column border stroke. (Range: 0 to 100) |
|
innerColumnStrokeType |
read/write |
The stroke type of the inner column. Can also accept: String. |
|
|
innerColumnStrokeWeight |
read/write |
The stroke weight of the inner column border stroke. |
|
|
innerRowStrokeColor |
read/write |
The color, specified as a swatch, of the inner row border stroke. |
|
|
innerRowStrokeGapColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the gap of the inner row border stroke. Note: Not valid when inner row stroke type is solid. |
|
|
innerRowStrokeGapOverprint |
read/write |
If true, the gap color of the inner row border stroke will overprint. Note: Not valid when inner row stroke type is solid. |
|
|
innerRowStrokeGapTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the inner row border stroke. (Range: 0 to 100) Note: Not valid when inner row stroke type is solid. |
|
innerRowStrokeOverprint |
read/write |
If true, the inner row border stroke will overprint. |
|
|
innerRowStrokeTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the inner row border stroke. (Range: 0 to 100) |
|
innerRowStrokeType |
read/write |
The stroke type of the inner row. Can also accept: String. |
|
|
innerRowStrokeWeight |
read/write |
The stroke weight of the inner row border strokes. |
|
|
isValid |
readonly |
Returns true if the object specifier resolves to valid objects. |
|
|
keepWithNextRow |
read/write |
If true, keeps the row with the next row when the table is split across text frames or pages. |
|
|
leftEdgeStrokeColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the left edge border stroke. |
|
|
leftEdgeStrokeGapColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the gap of the left edge border stroke. Note: Not valid when left edge stroke type is solid. |
|
|
leftEdgeStrokeGapOverprint |
read/write |
If true, the gap color of the left edge border stroke will overprint. Note: Not valid when left edge stroke type is solid. |
|
|
leftEdgeStrokeGapTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the left edge border stroke gap color. (Range: 0 to 100) Note: Not valid when left edge stroke type is solid. |
|
leftEdgeStrokeOverprint |
read/write |
If true, the left edge border stroke will overprint. |
|
|
leftEdgeStrokeTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the left edge border stroke. (Range: 0 to 100) |
|
leftEdgeStrokeType |
read/write |
The stroke type of the left edge. Can also accept: String. |
|
|
leftEdgeStrokeWeight |
read/write |
The stroke weight of the left edge border stroke. |
|
|
leftInset |
read/write |
The left inset of the cell. |
|
|
maximumHeight |
read/write |
The maximum height to which cells in the Column may grow. Note: The maximum height cannot be exceeded even when auto grow is set to true. Also, the maximum height can affect redistribution. |
|
|
minimumFirstBaselineOffset |
read/write |
The space between the baseline of the text and the top inset of the frame or cell. |
|
|
minimumHeight |
read/write |
The minimum height of the cells in the Column. Note: When auto grow is true, cells can automatically grow larger than this amount when content is added. Also, the minimum height can affect redistribution. |
|
|
name |
readonly |
The name of the Column. |
|
|
overflows |
readonly |
If true, the story has overset text. |
|
|
overprintFill |
read/write |
If true, the fill of the object will overprint. |
|
|
paragraphSpacingLimit |
read/write |
The maximum space that can be added between paragraphs in a cell. Note: Valid only when vertical justification is justified. |
|
|
parent |
readonly |
The parent of the Column (a Table). |
|
|
parentColumn |
readonly |
The parent column of the cell. |
|
|
parentRow |
readonly |
The parent row of the cell. |
|
|
properties |
read/write |
A property that allows setting of several properties at the same time. |
|
|
rightEdgeStrokeColor |
read/write |
The color, specified as a swatch, of the right edge border stroke. |
|
|
rightEdgeStrokeGapColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the gap of the right edge border stroke. Note: Not valid when right edge stroke type is solid. |
|
|
rightEdgeStrokeGapOverprint |
read/write |
If true, the gap color of the right edge border stroke will overprint. Note: Not valid when right edge stroke type is solid. |
|
|
rightEdgeStrokeGapTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the right edge border stroke gap color. (Range: 0 to 100) Note: Not valid when right edge stroke type is solid. |
|
rightEdgeStrokeOverprint |
read/write |
If true, the right edge border stroke will overprint. |
|
|
rightEdgeStrokeTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the right edge border stroke. (Range: 0 to 100) |
|
rightEdgeStrokeType |
read/write |
The stroke type of the right edge. Can also accept: String. |
|
|
rightEdgeStrokeWeight |
read/write |
The stroke weight of the right edge border stroke. |
|
|
rightInset |
read/write |
The right inset of the cell. |
|
|
rotationAngle |
read/write |
The rotation angle (in degrees) of the cell, specified as one of the following values: 0, 90, 180, or 270. |
|
|
rowSpan |
readonly |
The number of rows that the object spans. |
|
|
rowType |
RowTypes.BODY_ROW RowTypes.HEADER_ROW RowTypes.FOOTER_ROW RowTypes.MIXED_STATE |
read/write |
The row type. |
|
rows |
readonly |
A collection of table rows. |
|
|
startRow |
StartParagraph.ANYWHERE StartParagraph.NEXT_COLUMN StartParagraph.NEXT_FRAME StartParagraph.NEXT_PAGE StartParagraph.NEXT_ODD_PAGE StartParagraph.NEXT_EVEN_PAGE |
read/write |
Indicates where to start the row. |
|
topEdgeStrokeColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the top edge border stroke. |
|
|
topEdgeStrokeGapColor |
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the gap of the top edge border stroke. Note: Not valid when top edge stroke type is solid. |
|
|
topEdgeStrokeGapOverprint |
read/write |
If true, the gap color of the top edge border stroke will overprint. Note: Not valid when top edge stroke type is solid. |
|
|
topEdgeStrokeGapTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the top edge border stroke gap color. (Range: 0 to 100) Note: Not valid when top edge stroke type is solid. |
|
topEdgeStrokeOverprint |
read/write |
If true, the top edge border stroke will overprint. |
|
|
topEdgeStrokeTint |
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the top edge border stroke. (Range: 0 to 100) |
|
topEdgeStrokeType |
read/write |
The stroke type of the top edge. Can also accept: String. |
|
|
topEdgeStrokeWeight |
read/write |
The stroke weight of the top edge border stroke. |
|
|
topInset |
read/write |
The top inset of the cell. |
|
|
topLeftDiagonalLine |
read/write |
If true, draws a diagonal line starting from the top left. |
|
|
topRightDiagonalLine |
read/write |
If true, draws a diagonal line starting from the top right. |
|
|
verticalJustification |
VerticalJustification.TOP_ALIGN VerticalJustification.CENTER_ALIGN VerticalJustification.BOTTOM_ALIGN VerticalJustification.JUSTIFY_ALIGN |
read/write |
The vertical alignment of cell. |
|
width |
read/write |
The width of the Column. For a table or row, specifies the sum of the column widths. |
|
|
writingDirection |
HorizontalOrVertical.HORIZONTAL HorizontalOrVertical.VERTICAL |
read/write |
The direction of the text in the cell. |
EventListener addEventListener (eventType:String, handler:Varies, [captures:Boolean=Boolean])
Adds an event listener.
|
Parameter |
Type |
Description |
|---|---|---|
|
eventType |
The event type. |
|
|
handler |
Varies |
The event handler. Can accept: File or JavaScript Function. |
|
captures |
This parameter is obsolete. (Optional) (default: false) |
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) |
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) |
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) |
Column getElements ()
Resolves the object specifier, creating an array of object references.
Cell merge (with:Varies)
Merges the cells.
|
Parameter |
Type |
Description |
|---|---|---|
|
with |
Varies |
The cell(s) to merge with. Can accept: Cell, Row or Column. (Optional) |
undefined recompose ()
Recomposes the text in the Column.
undefined redistribute (using:HorizontalOrVertical, thru:Varies)
Redistributes the specified range of Columns so that the Columns have a uniform size. Note: The maximum or minimum height or width specified for some of the cells in the range may prevent them from being exactly even.
|
Parameter |
Type |
Description |
|---|---|---|
|
using |
HorizontalOrVertical.HORIZONTAL HorizontalOrVertical.VERTICAL |
The direction in which to redistribute. |
|
thru |
Varies |
The last Column in the range. Can accept: Cell, Column or Row. (Optional) |
undefined remove ()
Deletes the Column.
Boolean removeEventListener (eventType:String, handler:Varies, [captures:Boolean=Boolean])
Removes the event listener.
|
Parameter |
Type |
Description |
|---|---|---|
|
eventType |
The registered event type. |
|
|
handler |
Varies |
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 |
SelectionOptions.ADD_TO SelectionOptions.REMOVE_FROM SelectionOptions.REPLACE_WITH SelectionOptions.SET_KEY |
The selection status of the Column in relation to previously selected objects. (Optional) (default: SelectionOptions.REPLACE_WITH) |
undefined split (using:HorizontalOrVertical)
Splits the cell along the specified axis.
|
Parameter |
Type |
Description |
|---|---|---|
|
using |
HorizontalOrVertical.HORIZONTAL HorizontalOrVertical.VERTICAL |
The direction in which to split the cell. |
String toSource ()
Generates a string which, if executed, will return the Column.
String toSpecifier ()
Retrieves the object specifier.
Cell unmerge ()
Unmerges all merged cells in the Column.
Cell.parentColumn
Column.parentColumn
Row.parentColumn
Cell.parent
Event.parent
EventListener.parent
MutationEvent.parent