Column

A table column.

Properties

Property	Type	Access	Description
autoGrow	bool	r/w	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	Swatch	r/w	The swatch (color, gradient, tint, or mixed ink) applied to the bottom edge border stroke.
bottomEdgeStrokeGapColor	Swatch	r/w	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	bool	r/w	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	r/w	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	bool	r/w	If true, the bottom edge border stroke will overprint.
bottomEdgeStrokeTint	number	r/w	The tint (as a percentage) of the bottom edge border stroke.
bottomEdgeStrokeType	StrokeStyle	r/w	The stroke type of the bottom edge. Can also accept: String.
bottomEdgeStrokeWeight	number	r/w	The stroke weight of the bottom edge border stroke.
bottomInset	number	r/w	The bottom inset of the cell.
cells	Cells	readonly	A collection of table cells.
clipContentToCell	bool	r/w	If true, clips the cell’s content to width and height of the cell.
columns	Columns	readonly	A collection of table columns.
columnSpan	number	readonly	The number of columns that the Column spans.
contents	any	r/w	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	bool	r/w	If true, draws the diagonal line in front of cell contents.
diagonalLineStrokeColor	Swatch	r/w	The diagonal line color, specified as a swatch.
diagonalLineStrokeGapColor	Swatch	r/w	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	bool	r/w	If true, the stroke gap of the diagonal line will overprint. Note: Not valid when diagonal line stroke type is solid.
diagonalLineStrokeGapTint	number	r/w	The tint (as a percentage) of the diagonal line stroke gap color. Note: Not valid when diagonal line stroke type is solid.
diagonalLineStrokeOverprint	bool	r/w	If true, the diagonal line stroke will overprint.
diagonalLineStrokeTint	number	r/w	The diagonal line tint (as a percentage). (Range: 0 to 100)
diagonalLineStrokeType	StrokeStyle	r/w	The stroke type of the diagonal line(s). Can also accept: String.
diagonalLineStrokeWeight	number	r/w	The diagonal line stroke weight.
fillColor	Swatch	r/w	The swatch (color, gradient, tint, or mixed ink) applied to the fill of the Column. Can also accept: String.
fillTint	number	r/w	The tint (as a percentage) of the fill of the Column.
firstBaselineOffset	FirstBaseline : ASCENT_OFFSET CAP_HEIGHT LEADING_OFFSET EMBOX_HEIGHT X_HEIGHT FIXED_HEIGHT	r/w	The distance between the baseline of the text and the top inset of the cell.
gradientFillAngle	number	r/w	The angle of a linear gradient applied to the Column’s fill. (Range: -180 to 180)
gradientFillLength	number	r/w	The length (of a linear gradient) or radius (of a radial gradient) applied to the fill of the Column.
gradientFillStart	Array of number	r/w	The starting point (in page coordinates) of a gradient applied to the fill of the Column, in the format [x, y].
height	number	r/w	The height of the Column. For a table or column, specifies the sum of the row heights.
index	number	readonly	The index of the Column within its containing object.
innerColumnStrokeColor	Swatch	r/w	The color, specified as a swatch, of the inner column border stroke.
innerColumnStrokeGapColor	Swatch	r/w	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	bool	r/w	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	r/w	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	bool	r/w	If true, the inner column border stroke will overprint.
innerColumnStrokeTint	number	r/w	The tint (as a percentage) of the inner column border stroke. (Range: 0 to 100)
innerColumnStrokeType	StrokeStyle	r/w	The stroke type of the inner column. Can also accept: String.
innerColumnStrokeWeight	number	r/w	The stroke weight of the inner column border stroke.
innerRowStrokeColor	Swatch	r/w	The color, specified as a swatch, of the inner row border stroke.
innerRowStrokeGapColor	Swatch	r/w	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	bool	r/w	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	r/w	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	bool	r/w	If true, the inner row border stroke will overprint.
innerRowStrokeTint	number	r/w	The tint (as a percentage) of the inner row border stroke. (Range: 0 to 100)
innerRowStrokeType	StrokeStyle	r/w	The stroke type of the inner row. Can also accept: String.
innerRowStrokeWeight	number	r/w	The stroke weight of the inner row border strokes.
keepWithNextRow	bool	r/w	If true, keeps the row with the next row when the table is split across text frames or pages.
leftEdgeStrokeColor	Swatch	r/w	The swatch (color, gradient, tint, or mixed ink) applied to the left edge border stroke.
leftEdgeStrokeGapColor	Swatch	r/w	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	bool	r/w	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	r/w	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	bool	r/w	If true, the left edge border stroke will overprint.
leftEdgeStrokeTint	number	r/w	The tint (as a percentage) of the left edge border stroke. (Range: 0 to 100)
leftEdgeStrokeType	StrokeStyle	r/w	The stroke type of the left edge. Can also accept: String.
leftEdgeStrokeWeight	number	r/w	The stroke weight of the left edge border stroke.
leftInset	number	r/w	The left inset of the cell.
maximumHeight	number	r/w	The maximum height to which the row or the column’s rows may grow. Note: The maximum height cannot be exceeded even when auto grow is set to true. Also, the maximum height can affect redistribution. For information, see redistribute.
minimumFirstBaselineOffset	number	r/w	The space between the baseline of the text and the top inset of the frame or cell.
minimumHeight	number	r/w	The minimum height that the cell or the Column’s cells are allowed to be. 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. For information, see redistribute.
name	string	readonly	The name of the Column.
overflows	bool	readonly	If true, the Column has overset text.
overprintFill	bool	r/w	If true, the fill of the Column will overprint.
paragraphSpacingLimit	number	r/w	The maximum space that can be added between paragraphs in a cell. Note: Valid only when vertical justification is justified.
parent	any	readonly	The parent of the Column (a Table, Cell, Column or Row).
parentColumn	Column	readonly	The Column’s parent column.
parentRow	Row	readonly	The Column’s parent row.
properties	Object	r/w	A property that allows setting of several properties at the same time.
rightEdgeStrokeColor	Swatch	r/w	The color, specified as a swatch, of the right edge border stroke.
rightEdgeStrokeGapColor	Swatch	r/w	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	bool	r/w	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	r/w	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	bool	r/w	If true, the right edge border stroke will overprint.
rightEdgeStrokeTint	number	r/w	The tint (as a percentage) of the right edge border stroke. (Range: 0 to 100)
rightEdgeStrokeType	StrokeStyle	r/w	The stroke type of the right edge. Can also accept: String.
rightEdgeStrokeWeight	number	r/w	The stroke weight of the right edge border stroke.
rightInset	number	r/w	The right inset of the cell.
rotationAngle	number	r/w	The rotation angle (in degrees) of the cell, specified as one of the following values: 0, 90, 180, or 270.
rows	Rows	readonly	A collection of table rows.
rowSpan	number	readonly	The number of rows that the Column spans.
rowType	RowTypes : BODY_ROW HEADER_ROW FOOTER_ROW MIXED_STATE	r/w	The row’s type.
startRow	StartParagraph : ANYWHERE NEXT_COLUMN NEXT_FRAME NEXT_PAGE NEXT_ODD_PAGE NEXT_EVEN_PAGE	r/w	Indicates where to start the row.
topEdgeStrokeColor	Swatch	r/w	The swatch (color, gradient, tint, or mixed ink) applied to the top edge border stroke.
topEdgeStrokeGapColor	Swatch	r/w	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	bool	r/w	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	r/w	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	bool	r/w	If true, the top edge border stroke will overprint.
topEdgeStrokeTint	number	r/w	The tint (as a percentage) of the top edge border stroke. (Range: 0 to 100)
topEdgeStrokeType	StrokeStyle	r/w	The stroke type of the top edge. Can also accept: String.
topEdgeStrokeWeight	number	r/w	The stroke weight of the top edge border stroke.
topInset	number	r/w	The top inset of the cell.
topLeftDiagonalLine	bool	r/w	If true, draws a diagonal line starting from the top left.
topRightDiagonalLine	bool	r/w	If true, draws a diagonal line starting from the top right.
verticalJustification	VerticalJustification : TOP_ALIGN CENTER_ALIGN BOTTOM_ALIGN JUSTIFY_ALIGN	r/w	The vertical alignment of cell.
width	number	r/w	The width of the Column. For a table or row, specifies the sum of the column widths.

Methods

Array of TextchangeGlyph ([reverseOrder:
bool])
Finds glyphs that match the find what value and replaces the glyphs with the change to value.

Parameter	Type	Description
reverseOrder	bool	If true, returns the results in reverse order. (Optional)

Array of TextchangeGrep ([reverseOrder:
bool])
Finds text that matches the find what value and replaces the text with the change to value.

Parameter	Type	Description
reverseOrder	bool	If true, returns the results in reverse order. (Optional)

Array of TextchangeText ([reverseOrder:
bool])
Finds text that matches the find what value and replaces the text with the change to value.

Parameter	Type	Description
reverseOrder	bool	If true, returns the results in reverse order. (Optional)

Array of PageItemcreateOutlines ([deleteOriginal:
bool=true ])
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	bool	If true, deletes the original text. If false, creates the outlines as separate object(s) on top of the text. (Optional) (default: true )

Array of TextfindGlyph ([reverseOrder:
bool])
Finds glyphs that match the find what value.

Parameter	Type	Description
reverseOrder	bool	If true, returns the results in reverse order. (Optional)

Array of TextfindGrep ([reverseOrder:
bool])
Finds text that matches the find what value.

Parameter	Type	Description
reverseOrder	bool	If true, returns the results in reverse order. (Optional)

Array of TextfindText ([reverseOrder:
bool])
Finds text that matches the find what value.

Parameter	Type	Description
reverseOrder	bool	If true, returns the results in reverse order. (Optional)

Array of ColumngetElements ()
Resolves the object specifier, creating an array of object references.

Cellmerge ([with:
any])
Merges the Columns.

Parameter	Type	Description
with	Cell Row Column	The Column(s) to merge with. Can accept: Cell, Row or Column. (Optional)

void recompose ()
Recomposes the text in the Column.

void redistribute (using:
HorizontalOrVertical[, thru:
any])
Redistributes the specified range of Columns so that the Columns have a uniform size. Note: The maximum or minimum height specified for some objects in the range may prevent the redistribution from being exactly even.

Parameter	Type	Description
using	HorizontalOrVertical : HORIZONTAL VERTICAL	The direction in which to redistribute.
thru	Cell Column Row	The last Column in the range. Can accept: Cell, Column or Row. (Optional)

void remove ()
Deletes the Column.

void select ([existingSelection:
SelectionOptions=REPLACE_WITH ])
Selects the Column.

Parameter	Type	Description
existingSelection	SelectionOptions : ADD_TO REMOVE_FROM REPLACE_WITH	The selection status of the Column in relation to previously selected objects. (Optional) (default: REPLACE_WITH )

void split (using:
HorizontalOrVertical)
Splits the Column in the specified direction.

Parameter	Type	Description
using	HorizontalOrVertical : HORIZONTAL VERTICAL	The direction in which to split the Column.

string toSource ()
Generates a string which, if executed, will return the Column.

string toSpecifier ()
Retrieves the object specifier.

Array of Cellunmerge ()
Unmerges all merged cells in the Column.

Element of:

Cell.parentColumn
Column.parentColumn
Row.parentColumn

Used in:

Columns.previousItem (

obj:
Column )

Columns.nextItem (

obj:
Column )

Returned by:

Array of Column Column .getElements (

)

Column Columns.anyItem (

)

Array of Column Columns.everyItem (

)

Column Columns.firstItem (

)

Column Columns.item (
index:
any
)

Column Columns.itemByName (
name:
string
)

Array of Column Columns.itemByRange (
from:
any, to:
any
)

Column Columns.lastItem (

)

Column Columns.middleItem (

)

Column Columns.nextItem (
obj:
Column
)

Column Columns.previousItem (
obj:
Column
)