Indesign Scripting Reference
home | search | Links
VBScript >> Cell

Cell

A cell in a table.

Cell Properties

Property Type Access Description
AllGraphics Array of Graphics read All graphics contained by the object.
AllPageItems Array of PageItems read All page items contained by the object.
AssociatedXMLElement XMLItem read The XML element associated with the object.
AutoGrow Boolean r/w If true, rows in the object will expand vertically to fit their content.
BottomEdgeStrokeColor Swatch r/w The color of the stroke applied to the bottom edge.
BottomEdgeStrokeGapColor Swatch r/w The gap color applied to the bottom edge.
BottomEdgeStrokeGapOverprint Boolean r/w If true, the gap color applied to the bottom edge will overprint.
BottomEdgeStrokeGapTint Double r/w The tint percentage applied to the gap color of the bottom edge.
BottomEdgeStrokeOverprint Boolean r/w If true, overprint the bottom edge.
BottomEdgeStrokeTint Double r/w The tint percentage applied to the color of the bottom edge.
BottomEdgeStrokeType StrokeStyle r/w The stroke style applied to the bottom edge.
BottomEdgeStrokeWeight Unit (Double or String) r/w The stroke weight applied to the bottom edge.
BottomInset Unit (Double or String) r/w The bottom inset.
Buttons Buttons read The buttons contained by the object.
Cells Cells read The cells in the object.
Characters Characters read The characters of the object.
ClipContentToCell Boolean r/w If true, clip cell content to fit the cell.
Columns Columns read All columns in the object.
ColumnSpan Long read The number of columns in the object.
Contents String, idSpecialCharacters enumeration (see table at end of chapter), Array of Strings or idSpecialCharacters enumerators, idNothingEnum enumeration, Array of Strings, idSpecialCharacters enumerators or idNothingEnum enumerators r/w The text contents.
DiagonalLineInFront Boolean r/w If true, the diagonal line(s) will appear in front of the content in the cells of the object.
DiagonalLineStrokeColor Swatch r/w The color of the stroke applied to the diagonal line(s).
DiagonalLineStrokeGapColor Swatch r/w The gap color of the stroke applied to the diagonal line(s).
DiagonalLineStrokeGapOverprint Boolean r/w If true, overprint the gap of the diagonal line(s).
DiagonalLineStrokeGapTint Double r/w The tint percentage applied to the gap color of the diagonal line(s).
DiagonalLineStrokeOverprint Boolean r/w If true, overprint the diagonal line(s).
DiagonalLineStrokeTint Double r/w The tint percentage applied to the diagonal line(s).
DiagonalLineStrokeType StrokeStyle r/w The stroke style applied to the diagonal line(s).
DiagonalLineStrokeWeight Unit (Double or String) r/w The stroke weight of the diagonal line(s).
FillColor Swatch, String r/w The fill of the object.
FillTint Double r/w The tint percentage applied to the fill of the object (-1 indicates 100%).
FirstBaselineOffset idFirstBaseline enumeration r/w The distance between the baseline of the first line of text in the object and the top inset of object.
FormFields FormFields read The form fields contained by the object.
GradientFillAngle Double r/w The angle of the gradient applied to the fill of the object.
GradientFillLength Double r/w Length (for a linear gradient) or radius (for a radial gradient) of the gradient applied to the fill of the object.
GradientFillStart Array of 2 Units (Doubles or Strings) r/w Starting point (for a linear gradient) or center point (for a radial gradient) of a gradient applied to the fill of the object.
GraphicLines GraphicLines read The graphic lines contained by the object.
Groups Groups read The groups contained by the object.
Height Unit (Double or String) r/w The height of the object.
Id Long read A unique number identifying the object.
Index Long read Index of the object within its parent object.
InnerColumnStrokeColor Swatch r/w The color of the stroke applied to the inner column.
InnerColumnStrokeGapColor Swatch r/w The gap color of the inner column.
InnerColumnStrokeGapOverprint Boolean r/w If true, overprint the stroke gap of the inner column.
InnerColumnStrokeGapTint Double r/w The tint percentage applied to the stroke gap color of the inner column.
InnerColumnStrokeOverprint Boolean r/w If true, overprint the stroke applied to the inner column.
InnerColumnStrokeTint Double r/w The tint percentage applied to the stroke of the inner column.
InnerColumnStrokeType StrokeStyle r/w The stroke style applied to the inner column.
InnerColumnStrokeWeight Unit (Double or String) r/w The stroke weight applied to the inner column.
InnerRowStrokeColor Swatch r/w The color of the stroke applied to the inner row.
InnerRowStrokeGapColor Swatch r/w The gap color of the stroke applied to the inner row.
InnerRowStrokeGapOverprint Boolean r/w If true, overprint the gap of the stroke applied to the inner row.
InnerRowStrokeGapTint Double r/w The tint percentage applied to the stroke gap color of the inner row.
InnerRowStrokeOverprint Boolean r/w If true, the stroke applied to the inner row will overprint.
InnerRowStrokeTint Double r/w The tint percentage applied to the stroke color of the inner row.
InnerRowStrokeType StrokeStyle r/w The stroke style applied to the inner row.
InnerRowStrokeWeight Unit (Double or String) r/w The stroke weight applied to stroke of the inner row.
InsertionPoints InsertionPoints read The insertion points in the object.
KeepWithNextRow Boolean r/w If true, keep this row with the next row.
Label String r/w A label that can be set to any string.
LeftEdgeStrokeColor Swatch r/w The color of the stroke applied to the left edge.
LeftEdgeStrokeGapColor Swatch r/w The gap color of the stroke applied to the left edge.
LeftEdgeStrokeGapOverprint Boolean r/w If true, overprint the gap of the stroke applied to the left edge.
LeftEdgeStrokeGapTint Double r/w The tint percentage applied to the stroke gap color of the left edge.
LeftEdgeStrokeOverprint Boolean r/w If true, overprint the stroke applied to the left edge.
LeftEdgeStrokeTint Double r/w The tint percentage applied to the stroke color of the left edge.
LeftEdgeStrokeType StrokeStyle r/w The stroke style applied to the left edge.
LeftEdgeStrokeWeight Unit (Double or String) r/w The stroke weight applied to the left edge of the cell.
LeftInset Unit (Double or String) r/w The left inset of the object.
Lines Lines read The lines of text in the object.
MaximumHeight Unit (Double or String) r/w The maximum height of the row.
MinimumFirstBaselineOffset Unit (Double or String) (0 - 8640 points) r/w The minimum distance between the baseline of the first line of text in the object and the top inset object.
MinimumHeight Unit (Double or String) r/w Constrains the row height to an amount no smaller than this value. The row may be larger than this amount, however, as the row height will continue to grow automatically as text is added.
Name String read The name of the object.
Ovals Ovals read All ovals contained by the object.
Overflows Boolean read If true, the object contains overset text.
OverprintFill Boolean r/w If true, the fill of the object will overprint.
PageItems PageItems read The page items contained by the object.
Paragraphs Paragraphs read The paragraphs contained by the object.
ParagraphSpacingLimit Unit (Double or String) r/w The maximum amount of space that will be added between paragraphs when vertical justification is set to justified.
Parent Object read The parent of the object.
ParentColumn Column read The parent column of the object.
ParentRow Row read The parent row of the object.
Polygons Polygons read The polygons contained by the object.
Rectangles Rectangles read The rectangles contained by the object.
RightEdgeStrokeColor Swatch r/w The color of the stroke applied to the right edge.
RightEdgeStrokeGapColor Swatch r/w The gap color of the right edge.
RightEdgeStrokeGapOverprint Boolean r/w If true, overprint the gap of the stroke applied to the right edge.
RightEdgeStrokeGapTint Double r/w The tint percentage applied to the stroke gap color of the right edge.
RightEdgeStrokeOverprint Boolean r/w If true, overprint the stroke applied to the right edge.
RightEdgeStrokeTint Double r/w The tint percentage applied to the stroke color of the right edge.
RightEdgeStrokeType StrokeStyle r/w The stroke style applied to the right edge.
RightEdgeStrokeWeight Unit (Double or String) r/w The stroke weight applied to the right edge of the cell.
RightInset Unit (Double or String) r/w The right inset of the object.
RotationAngle Double r/w The rotation angle applied to the object, including any rotation applied to its containing object.
Rows Rows read The rows contained by the object.
RowSpan Long read The number of rows the object spans.
RowType idRowTypes enumeration r/w The type of the row.
StartRow idStartParagraph enumeration r/w Where to start the row.
Tables Tables read The tables contained by the object.
TextColumns TextColumns read The text columns contained by the object.
TextFrames TextFrames read The text frames contained by the object.
Texts Texts read The texts contained by the object.
TextStyleRanges TextStyleRanges read The text style ranges contained by the object.
TopEdgeStrokeColor Swatch r/w The color of the stroke applied to the top edge.
TopEdgeStrokeGapColor Swatch r/w The gap color of the top edge.
TopEdgeStrokeGapOverprint Boolean r/w If true, overprint the gap of the stroke applied to the top edge.
TopEdgeStrokeGapTint Double r/w The tint percentage applied to the stroke gap color of the top edge.
TopEdgeStrokeOverprint Boolean r/w If true, overprint the stroke applied to the top edge.
TopEdgeStrokeTint Double r/w The tint percentage applied to the stroke color of the top edge.
TopEdgeStrokeType StrokeStyle r/w The stroke style applied to the top edge.
TopEdgeStrokeWeight Unit (Double or String) r/w The stroke weight applied to the top edge of the cell.
TopInset Unit (Double or String) r/w The top inset of the object.
TopLeftDiagonalLine Boolean r/w If true, draw a diagonal line starting from the top left.
TopRightDiagonalLine Boolean r/w If true, draw a diagonal line starting from the top right.
VerticalJustification idVerticalJustification enumeration r/w The vertical justification alignment.
Width Unit (Double or String) r/w The width of the object.
Words Words read The words contained by the object.

Cell Methods

Method Returns Description
ConvertBulletsAndNumberingToText Nothing Converts bullets and numbering to text.
CreateOutlines Array of PageItems Create outlines from the text.
Delete Nothing Deletes the object.
ExtractLabel String Gets the content of the label associated with the specified key (name).
InsertLabel Nothing Sets the content of the label associated with the specified key (name), creating the label if it does not already exist.
Merge Cell Merge cells together.
Recompose Nothing Recomposes the text in the object.
Search Array of Texts Searches for text and returns a list of text objects matching the search string and/or formatting specified by the find preferences. Search can also replace the text and/or formatting. This command corresponds to InDesign’s Find/Change feature.
Select Nothing Selects the object.
Split Nothing Split the cell either horizontally or vertically.
Unmerge Array of Cells Unmerge the cells.