A word.
Go to Property Listing | Method Listing
applyBullets, applyNumbers, applyStyle, changecase, convertToNote, convertToTable, createOutlines, exportFile, markup, move, place, remove, removeBulletsAndNumbers, search, select
Bnautocolor, Bnautofont, Bnautofontstyle, Bnautosize, Boolean, Bullet, Buttons, Capitalization, CharacterStyle, Characters, Font, FormFields, Graphic, GraphicLines, Groups, InsertionPoints, Justification, Language, Leading, Lines, Word, NestedStyles, Notes, Number, NumberingStyle, OTFFigureStyle, Object, Ovals, PageItem, PageItems, ParagraphStyle, Paragraphs, Polygons, Position, Rectangles, RuleWidth, SingleWordJustification, SpecialCharacters, StartParagraph, String, StrokeStyle, Swatch, TabStops, Tables, TextColumns, TextFrames, TextStyleRanges, Texts, Words, XMLElement
|
Property |
Type |
Access |
Description |
|---|---|---|---|
|
read/write |
If true, aligns the baseline of the text to the baseline grid. |
||
|
readonly |
Lists all graphics contained by the Word. |
||
|
readonly |
Lists all page items contained by the Word. |
||
|
read/write |
The character style applied to the text. Can also accept: String. |
||
|
read/write |
The font applied to the Word, specified as either a font object or the name of font family. Can return: Font or String. |
||
|
read/write |
The language of the text. Can also accept: String. |
||
|
read/write |
The paragraph style applied to the text. Can also accept: String. |
||
|
readonly |
The maximum ascent of any character in the text. |
||
|
Array of XMLElement |
readonly |
Returns the associated XML elements |
|
|
Number (range 0 - 500) |
read/write |
The percent of the type size to use for auto leading. (Range: 0 to 500). |
|
|
read/write |
If true, balance ragged lines. |
||
|
readonly |
The vertical offset of the text. |
||
|
read/write |
The vertical distance by which to offset the Word from the baseline. |
||
|
readonly |
Bullet character. |
||
|
SwatchCanalsoaccept:String |
read/write |
Determines color of bullet or number character. Can return: Bnautocolor enumerator or Swatch. Can also accept: String. |
|
|
read/write |
Bullets and numbering font. Can return: Font, String or Bnautofont enumerator. |
||
|
read/write |
Determines bullets and numbering font style. Can return: Bnautofontstyle enumerator or String. |
||
|
read/write |
List type for bullets and numbering. |
||
|
Real |
read/write |
Determines point size of bullet or number character. Can return: Bnautosize enumerator or Real. |
|
|
readonly |
A collection of buttons. |
||
|
read/write |
The capitalization scheme. |
||
|
readonly |
A collection of characters. |
||
|
read/write |
The text composer to use to compose the text. |
||
|
read/write |
The contents of the text. Can return: String or SpecialCharacters enumerator. |
||
|
readonly |
The maximum descent of any character in the text. |
||
|
Number (range 50 - 200) |
read/write |
The desired width (as a percentage) of individual characters. (Range: 50 to 200) |
|
|
read/write |
The desired letter spacing, specified as a percentge of the built-in space between letters in the font. (Range: -100 to 500) |
||
|
Number (range 0 - 1000) |
read/write |
The desired word spacing, specified as a percentage of the font word space value. (Range: 0 to 1000) |
|
|
read/write |
Number of characters for drop cap. |
||
|
read/write |
Number of lines for drop cap. |
||
|
read/write |
The character style to apply to the drop cap. Can also accept: String. |
||
|
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the fill of the Word. . Can also accept: String. |
||
|
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the fill color of the Word. (To specify a tint percentage, use a number in the range of 0 to 100; to use the inherited or overridden value, use -1.) |
|
|
read/write |
The amount to indent the first line. |
||
|
read/write |
The name of the font style. |
||
|
readonly |
A collection of form fields. |
||
|
read/write |
The angle of a linear gradient applied to the fill of the text. (Range: -180 to 180) |
||
|
read/write |
The length (for a linear gradient) or radius (for a radial gradient) applied to the fill of the text. |
||
|
read/write |
The starting point (in page coordinates) of a gradient applied to the fill of the text, in the format [x, y]. |
||
|
read/write |
The angle of a linear gradient applied to the stroke of the text. (Range: -180 to 180) |
||
|
read/write |
The length (for a linear gradient) or radius (for a radial gradient) applied to the stroke of the text. |
||
|
read/write |
The starting point (in page coordinates) of a gradient applied to the stroke of the text, in the format [x, y]. |
||
|
readonly |
A collection of graphic lines. |
||
|
read/write |
If true, aligns only the first line to the frame grid or baseline grid. If false, aligns all lines to the grid. |
||
|
readonly |
A collection of groups. |
||
|
readonly |
The horizontal offset of the text. |
||
|
read/write |
The horizontal scaling applied to the Word. |
||
|
read/write |
Hyphen weight. |
||
|
read/write |
Hyphenate after this many letters. |
||
|
read/write |
Hyphenate before this many letters. |
||
|
read/write |
If true, allows hyphenation of capitalized words. |
||
|
read/write |
Number of consecutive hyphens to allow. |
||
|
read/write |
Hyphenate words that have more than this number of letters. |
||
|
read/write |
If true, allows hyphenation. |
||
|
read/write |
The amount of white space allowed at the end of a line of non-justified text before hypenation begins. Note: Valid when composer is single-line composer. |
||
|
readonly |
The index of the text in the collection or parent object. |
||
|
readonly |
A collection of insertion points. |
||
|
read/write |
The paragraph alignment. |
||
|
read/write |
If true, keeps all lines of the paragraph together. If false, allows paragraphs to break across pages or columns. |
||
|
read/write |
Keep at least this many lines together at the end of a column. |
||
|
read/write |
Keep at least this many lines together at the start of a column. |
||
|
read/write |
If true, keeps a specified number of lines together when the paragraph breaks across columns or text frames. |
||
|
read/write |
Keep at least this many lines together with the following paragraph. |
||
|
read/write |
The type of pair kerning. |
||
|
read/write |
The amount of space to add or remove between characters, specified in thousands of an em. |
||
|
Real |
read/write |
The leading amount. Can return: Real or Leading enumerator. |
|
|
read/write |
The width of the left indent. |
||
|
readonly |
The number of objects in the collection. |
||
|
read/write |
If true, replaces specific character combinations (e.g., fl, fi) with ligature characters. |
||
|
readonly |
A collection of lines. |
||
|
Number (range 50 - 200) |
read/write |
The maximum width (as a percentage) of individual characters. (Range: 50 to 200) |
|
|
read/write |
The maximum letter spacing, specified as a percentge of the built-in space between letters in the font. (Range: -100 to 500) Note: Valid only when text is justified. |
||
|
Number (range 0 - 1000) |
read/write |
The maximum word spacing, specified as a percentage of the font word space value. Note: Valid only when text is justified. (Range: 0 to 1000) |
|
|
Number (range 50 - 200) |
read/write |
The minimum width (as a percentage) of individual characters. (Range: 50 to 200) |
|
|
read/write |
The minimum letter spacing, specified as a percentge of the built-in space between letters in the font. (Range: -100 to 500) Note: Valid only when text is justified. |
||
|
Number (range 0 - 1000) |
read/write |
The minimum word spacing, specified as a percentage of the font word space value. Note: Valid only when text is justified. (Range: 0 to 1000) |
|
|
readonly |
A collection of nested styles. |
||
|
read/write |
If true, keeps the text on the same line. |
||
|
readonly |
A collection of notes. |
||
|
read/write |
The numbering separator as a unicode ID. |
||
|
read/write |
Starting number in a numbered list. |
||
|
read/write |
Numbering style. Can return: NumberingStyle enumerator or String. |
||
|
read/write |
OpenType features. |
||
|
read/write |
If true, uses contextual alternate forms in OpenType fonts. |
||
|
read/write |
If true, uses discretionary ligatures in OpenType fonts. |
||
|
read/write |
The figure style in OpenType fonts. |
||
|
read/write |
If true, uses fractions in OpenType fonts. |
||
|
read/write |
If true, uses ordinals in OpenType fonts. |
||
|
read/write |
If true, uses swash forms in OpenType fonts. |
||
|
read/write |
If true, uses titling forms in OpenType fonts. |
||
|
readonly |
A collection of ellipses. |
||
|
read/write |
If true, the fill color of the characters will overprint. |
||
|
read/write |
If true, the stroke of the characters will overprint. |
||
|
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 |
A collection of paragraphs. |
||
|
readonly |
The parent of the Word (a TextPath, TextFrame, Text, Character, Word, Line, TextColumn, Paragraph, TextStyleRange, InsertionPoint, Story, Cell, XMLElement or Note). |
||
|
readonly |
The story that contains the text. |
||
|
readonly |
The text frame that contains the text. |
||
|
read/write |
The size of the Word in points |
||
|
readonly |
A collection of polygons. |
||
|
read/write |
The text position relative to the baseline. |
||
|
read/write |
A property that allows setting of several properties at the same time. |
||
|
readonly |
A collection of rectangles. |
||
|
read/write |
The width of the right indent. |
||
|
read/write |
If true, places a rule above the paragraph. |
||
|
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the paragraph rule above. Can return: Swatch or String. |
||
|
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the stroke gap of the paragraph rule above. Note: Valid only when the paragraph rule above type is not solid. Can return: Swatch or String. |
||
|
read/write |
If true, the stroke gap of the paragraph rule above will overprint. Note: Valid only the rule above type is not solid. |
||
|
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the stroke gap color of the paragraph rule. (Range: 0 to 100) Note: Valid only when the rule above type is not solid. |
|
|
read/write |
The distance to indent the left edge of the paragraph rule above (based on either the text width or the column width of the first line in the paragraph. |
||
|
read/write |
The stoke weight of the paragraph rule above. |
||
|
read/write |
The amount to offset the paragraph rule above from the baseline of the first line the paragraph. |
||
|
read/write |
If true, the paragraph rule above will overprint. |
||
|
read/write |
The distance to indent the right edge of the paragraph rule above (based on either the text width or the column width of the first line in the paragraph. |
||
|
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the paragraph rule above. (Range: 0 to 100) |
|
|
read/write |
The stroke type of the paragraph rule above. |
||
|
read/write |
The basis (text width or column width) used to calculate the width of the paragraph rule above. |
||
|
read/write |
If true, applies a paragraph rule below. |
||
|
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the paragraph rule below. Can return: Swatch or String. |
||
|
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the stroke gap of the paragraph rule below. Note: Valid only when the paragraph rule below type is not solid. Can return: Swatch or String. |
||
|
read/write |
If true, overprint the paragraph rule below stroke gap color. |
||
|
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the stroke gap color of the paragraph rule below. (Range: 0 to 100) Note: Valid only when the paragraph rule below type is not solid. |
|
|
read/write |
The distance to indent the left edge of the paragraph rule below (based on either the text width or the column width of the last line in the paragraph. |
||
|
read/write |
The stroke weight of the paragraph rule below. |
||
|
read/write |
The amount to offset the the paragraph rule below from the baseline of the last line of the paragraph. |
||
|
read/write |
If true, overprint the paragraph rule below. |
||
|
read/write |
The distance to indent the right edge of the paragraph rule below (based on either the text width or the column width of the last line in the paragraph. |
||
|
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the paragraph rule below. (Range: 0 to 100) |
|
|
read/write |
The stroke type of the paragraph rule below. |
||
|
read/write |
The basis (text width or column width) used to calculate the width of the paragraph rule below. |
||
|
read/write |
The alignment to use for lines that contain a single word. |
||
|
read/write |
The skew angle of the Word. |
||
|
read/write |
The height of the paragraph space below. |
||
|
read/write |
The height of the paragraph space above. |
||
|
read/write |
The location at which to start the paragraph. |
||
|
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the strikethrough stroke. Can return: Swatch or String. |
||
|
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the gap of the strikethrough stroke. Can return: Swatch or String. |
||
|
read/write |
If true, the gap color of the strikethrough stroke will overprint. Note: Valid when strike through type is not solid. |
||
|
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the strikethrough stroke gap color. (Range: 0 to 100) Note: Valid when strike through type is not solid. |
|
|
read/write |
The amount by which to offset the strikethrough stroke from the text baseline. |
||
|
read/write |
If true, the strikethrough stroke will overprint. |
||
|
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the strikethrough stroke. (Range: 0 to 100) |
|
|
read/write |
The stroke type of the strike through |
||
|
read/write |
The stroke weight of the strikethrough. |
||
|
read/write |
If true, draws a strikethrough line through the text. |
||
|
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the stroke of the Word. Can also accept: String. |
||
|
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the stroke color of the Word. (To specify a tint percentage, use a number in the range of 0 to 100; to use the inherited or overridden value, use -1.) |
|
|
read/write |
The stroke weight (in points) to apply to the stroke of the text |
||
|
Array of Arrays of Property Name/Value Pairs. |
read/write |
A list of the tab stops in the paragraph. Can return: Array of Arrays of Property Name/Value Pairs. |
|
|
readonly |
A collection of tab stops. |
||
|
readonly |
A collection of tables. |
||
|
readonly |
A collection of text columns. |
||
|
readonly |
A collection of text frames. |
||
|
readonly |
A collection of text style ranges. |
||
|
readonly |
A collection of text objects. |
||
|
read/write |
The amount by which to loosen or tighten a block of text, specified in thousands of an em. |
||
|
read/write |
If true, underlines the text. |
||
|
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the underline stroke. . Can return: Swatch or String. |
||
|
read/write |
The swatch (color, gradient, tint, or mixed ink) applied to the gap of the underline stroke. Note: Valid when underline type is not solid. Can return: Swatch or String. |
||
|
read/write |
If true, the gap color of the underline stroke will overprint. |
||
|
Number (range 0 - 100) |
read/write |
The tint (as a percentage) of the gap color of the underline stroke. (Range: 0 to 100) Note: Valid when underline type is not solid. |
|
|
read/write |
The amount by which to offset the underline from the text baseline. |
||
|
read/write |
If true, the underline stroke color will overprint. |
||
|
Number (range 0 - 100) |
read/write |
The underline stroke tint (as a percentage). (Range: 0 to 100) |
|
|
read/write |
The stroke type of the underline |
||
|
read/write |
The underline stroke weight. |
||
|
read/write |
The vertical scaling applied to the Word. |
||
|
readonly |
A collection of words. |
undefined applyBullets (bulletChar:Number, bulletType:Bulletcharactertype, bulletFont:Varies Font String, bulletFontStyle:String, bulletSize:Number, bulletColor:Swatch, [bulletAlignment:ListAlignment=ListAlignment], listLeftIndent:Number, listFirstLineIndent:Number, listFirstTabPosition:Number)
Apply bullets
|
Parameter |
Type |
Description |
|---|---|---|
|
bulletChar |
The bullet character as a unicode ID or a glyph ID (Optional) |
|
|
bulletType |
The type of bullet character (Optional) |
|
|
bulletFont |
The bullet font. Can accept: Font or String. (Optional) |
|
|
bulletFontStyle |
The bullet font style (Optional) |
|
|
bulletSize |
The size of the bullet character (Optional) |
|
|
bulletColor |
The color of the bullet character (Optional) |
|
|
bulletAlignment |
The alignment of the bulleted list (Optional) (default: ListAlignment.HANGING_LIST) |
|
|
listLeftIndent |
The left indent of the bulleted list (Optional) |
|
|
listFirstLineIndent |
The first line indent of the bulleted list (Optional) |
|
|
listFirstTabPosition |
The first tab position in the bulleted list (Optional) |
undefined applyNumbers (numberingStyle:NumberingStyle, numberingSeparator:Number, startingValue:Number, numberFont:Varies Font String, numberFontStyle:String, numberSize:Number, numberColor:Swatch, [numberAlignment:ListAlignment=ListAlignment], listLeftIndent:Number, listFirstLineIndent:Number, listFirstTabPosition:Number)
Apply numbers
|
Parameter |
Type |
Description |
|---|---|---|
|
numberingStyle |
The numbering style to be used (Optional) |
|
|
numberingSeparator |
The separator used for numbering (Optional) |
|
|
startingValue |
The value with which to start numbering (Optional) |
|
|
numberFont |
The number font. Can accept: Font or String. (Optional) |
|
|
numberFontStyle |
The number font style (Optional) |
|
|
numberSize |
The size of the number character(s) (Optional) |
|
|
numberColor |
The color of the number character(s) (Optional) |
|
|
numberAlignment |
The alignment of the numbered list (Optional) (default: ListAlignment.HANGING_LIST) |
|
|
listLeftIndent |
The left indent of the numbered list (Optional) |
|
|
listFirstLineIndent |
The first line indent of the numbered list (Optional) |
|
|
listFirstTabPosition |
The first tab position in the numbered list (Optional) |
undefined applyStyle (using:Varies ParagraphStyle CharacterStyle, [clearingOverrides:Boolean=Boolean])
Applies the specified character style or paragraph style.
|
Parameter |
Type |
Description |
|---|---|---|
|
using |
The style to apply. Can accept: ParagraphStyle or CharacterStyle. |
|
|
clearingOverrides |
If true, clears existing text attributes or character styles before applying the style. Note: Valid only when the using parameter specifies a paragraph style. (Optional) (default: true) |
undefined changecase (using:ChangecaseMode)
Sets the case of the text.
|
Parameter |
Type |
Description |
|---|---|---|
|
using |
The text case option. |
Note convertToNote ()
Converts the text to a note.
Table convertToTable (columnSeparator:String, rowSeparator:String, [numberOfColumns:Number=Number])
Converts the text to a table.
|
Parameter |
Type |
Description |
|---|---|---|
|
columnSeparator |
The character that starts a new column in the new table. (Optional) |
|
|
rowSeparator |
The character starts a new row in the new table. (Optional) |
|
|
numberOfColumns |
The number of columns in the table. Note: Valid only when the column and row separator characters are the same. (Optional) (default: 1) |
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) |
undefined exportFile (format:Varies ExportFormat String, to:File, [showingOptions:Boolean=Boolean], using:PDFExportPreset)
Exports the object(s) to a file.
|
Parameter |
Type |
Description |
|---|---|---|
|
format |
The export format. Can accept: ExportFormat enumerator or String. |
|
|
to |
The path of the export file. |
|
|
showingOptions |
If true, prompts the user to select export options. (Optional) (default: false) |
|
|
using |
The export style to use. (Optional) |
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 move (to:LocationOptions, reference:Text)
Moves the text to the specified location.
|
Parameter |
Type |
Description |
|---|---|---|
|
to |
The location relative to the reference object or within the containing object. |
|
|
reference |
The reference object. Note: Required when the to parameter specifies before or after. (Optional) |
Varies place (fileName:File, placePoint:Array of Number String, destinationLayer:Array of Varies Layer Layers. , [showingOptions:Boolean=Boolean], [autoflowing:Boolean=Boolean], [retainingFormatting:Boolean=Boolean], [convertingQuotes:Boolean=Boolean], withProperties:Object)
Places a file in the document.
|
Parameter |
Type |
Description |
|---|---|---|
|
fileName |
The file to place. |
|
|
placePoint |
The point where to place the object (only applicable if you are telling a page or spread to place) (Optional) |
|
|
destinationLayer |
Array of Layers. |
The layer(s) to place the file on (only valid if you are telling a page or spread to place). Can accept: Layer or Array of Layers. (Optional) |
|
showingOptions |
Whether to display the import options dialog (Optional) (default: false) |
|
|
autoflowing |
Whether to autoflow placed text (Optional) (default: false) |
|
|
retainingFormatting |
Whether to keep formatting of placed text files (Optional) (default: true) |
|
|
convertingQuotes |
Whether to convert to typographer's quotes (Optional) (default: true) |
|
|
withProperties |
Initial values for properties of the placed object(s) (Optional) |
undefined remove ()
Deletes the Word.
undefined removeBulletsAndNumbers ()
Remove bullets and numbers
Text search (for:String, wholeWord:Boolean, caseSensitive:Boolean, replacingWith:String, withFindAttributes:Object, withChangeAttributes:Object)
Look for occurrences of text that matches specific criteria
|
Parameter |
Type |
Description |
|---|---|---|
|
for |
What to look for (Optional) |
|
|
wholeWord |
If true, then disregard text embedded within a larger word (Optional) |
|
|
caseSensitive |
If true, then search only for text that matches case (Optional) |
|
|
replacingWith |
What to replace the found text with, either a string or a special character (Optional) |
|
|
withFindAttributes |
A record of find preference settings to use (Optional) |
|
|
withChangeAttributes |
A record of change preference settings to use (Optional) |
undefined select ([existingSelection:SelectionOptions=SelectionOptions])
Select this object.
|
Parameter |
Type |
Description |
|---|---|---|
|
existingSelection |
How to handle the existing selection (Optional) (default: SelectionOptions.REPLACE) |
Bullet.parent
Button.parent
Character.parent
FormField.parent
GraphicLine.parent
Group.parent
InsertionPoint.parent
Line.parent
NestedStyle.parent
Note.parent
Oval.parent
PageItem.parent
Paragraph.parent
Polygon.parent
Rectangle.parent
TabStop.parent
Table.parent
Text.parent
TextColumn.parent
TextFrame.parent
TextStyleRange.parent
Word.parent